Instance Method

applyWithExtent:arguments:

Creates a new image using the kernel and specified arguments.

Declaration

- (CIImage *)applyWithExtent:(CGRect)extent arguments:(NSArray<id> *)args;

Parameters

extent

The extent of the output image.

args

An array of arguments to pass to the kernel routine. The type of each object in the array must be compatible with the corresponding parameter declared in the kernel routine source code. For details, see Core Image Kernel Language Reference.

Return Value

A new image object describing the result of applying the kernel.

Discussion

This method is analogous to the CIFilter method apply:arguments:options:, but it does not require construction of a CIFilter object, and it allows you to specify a callback for determining the kernel’s region of interest as a block or closure. As with the similar CIFilter method, calling this method does not execute the kernel code—filters and their kernel code are evaluated only when rendering a final output image.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software