Returns the region of interest for the filter chain that generates the image.
- iOS 6.0+
- macOS 10.11+
- Mac Catalyst 13.0+
- tvOS 9.0+
- Core Image
Another image that is part of the filter chain that generates the image.
A rectangle in the image’s coordinate space.
A rectangle in the coordinate space of the input image (the
The region of interest is the rectangle containing pixel data in a source image (the
im parameter) necessary to produce a corresponding rectangle in the output image. If the image is not the output of a filter (or of a chain or graph of several
CIFilter objects), or the image in the
im parameter is not an input to that filter, the rectangle returned is the same as that in the
If the image is the output of a filter that doubles the size of its input image, the rectangle returned will be half the size of that in the
rparameter. (Upscaling causes every pixel in the input image to correspond to multiple pixels in the output image.)
If the image is the output of a blur filter, the rectangle returned will be slightly larger than that in the
rparameter. (In a blur filter, each pixel in the output image is produced using information from the corresponding pixel and those immediately surrounding it in the input image.)