Instance Property

layerUsesCoreImageFilters

A Boolean value indicating whether the view’s layer uses Core Image filters and needs in-process rendering.

Declaration

@property BOOL layerUsesCoreImageFilters;

Discussion

If your view uses a custom layer and you assigned Core Image to that layer directly, you must set this property to YES to let AppKit know of that fact. In macOS 10.9 and later, AppKit prefers to render layer trees out-of-process but cannot do so if any layers have Core Image filters attached to them. Specifying YES for property lets AppKit know that it must move rendering of the layer hierarchy back into your app’s process. If the value of this property is NO, adding a filter to the view’s layer triggers an exception.

You do not need to modify this property if you assigned the filters using the backgroundFilters, compositingFilter, or contentFilters properties of the view. Those methods automatically let AppKit know that it needs to render the layer hierarchy in-process. Set it only if you set the filters on the layer directly.

See Also

Managing the View’s Layer

wantsLayer

A Boolean value indicating whether the view uses a layer as its backing store.

wantsUpdateLayer

A Boolean value indicating which drawing path the view takes when updating its contents.

layer

The Core Animation layer that the view uses as its backing store.

- makeBackingLayer

Creates the view’s backing layer.

layerContentsPlacement

The current layer contents placement policy.

layerContentsRedrawPolicy

The contents redraw policy for the view’s layer.

canDrawSubviewsIntoLayer

A Boolean value indicating whether the view incorporates content from its subviews into its own layer.

NSViewLayerContentScaleDelegate

An optional layer delegate method for handling resolution changes.