Type Method

imageWithImageProvider:size::format:colorSpace:options:

Creates and returns an image object initialized with data provided by an image provider.

Declaration

+ (CIImage *)imageWithImageProvider:(id)p size:(size_t)width :(size_t)height format:(CIFormat)f colorSpace:(CGColorSpaceRef)cs options:(NSDictionary<CIImageOption, id> *)options;

Parameters

p: A data provider that implements the CIImageProvider informal protocol. Core Image maintains a strong reference to this object until the image is deallocated.
width: The width of the image.
height: The height of the image.
f: A pixel format constant. See Pixel Formats.
cs: The color space that the image is defined in. If the this value is nil, the image is not color matched. Pass nil for images that don’t contain color data (such as elevation maps, normal vector maps, and sampled function tables).
dict: A dictionary that specifies image-creation options, either kCIImageProviderTileSize or kCIImageProviderUserInfo. See CIImageProvider for more information on these options.

Return Value

An image object initialized with the data from the data provider. Core Image does not populate the image object until the object needs the data.

See Also

Creating an Image

Creates and returns an empty image object.

+ imageWithColor:

Creates and returns an image of infinite extent whose entire content is the specified color.

+ imageWithBitmapData:bytesPerRow:size:format:colorSpace:

Creates and returns an image object from bitmap data.

+ imageWithCGImage:

Creates and returns an image object from a Quartz 2D image.

+ imageWithCGImage:options:

Creates and returns an image object from a Quartz 2D image using the specified options.

+ imageWithCGLayer:

Creates and returns an image object from the contents supplied by a CGLayer object.

Deprecated

+ imageWithCGLayer:options:

Creates and returns an image object from the contents supplied by a CGLayer object, using the specified options.

Deprecated

+ imageWithContentsOfURL:

Creates and returns an image object from the contents of a file.

+ imageWithContentsOfURL:options:

Creates and returns an image object from the contents of a file, using the specified options.

+ imageWithCVImageBuffer:

Creates and returns an image object from the contents of CVImageBuffer object.

+ imageWithCVImageBuffer:options:

Creates and returns an image object from the contents of CVImageBuffer object, using the specified options.

+ imageWithCVPixelBuffer:

Creates and returns an image object from the contents of CVPixelBuffer object.

+ imageWithCVPixelBuffer:options:

Creates and returns an image object from the contents of CVPixelBuffer object, using the specified options.

+ imageWithData:

Creates and returns an image object initialized with the supplied image data.

+ imageWithData:options:

Creates and returns an image object initialized with the supplied image data, using the specified options.

+ imageWithTexture:size:flipped:colorSpace:

Creates and returns an image object initialized with data supplied by an OpenGL texture.

Deprecated

+ imageWithTexture:size:flipped:options:

Creates and returns an image object initialized with data supplied by an OpenGL texture.

Deprecated

+ imageWithMTLTexture:options:

Creates and returns an image object with data supplied by a Metal texture.

+ imageWithIOSurface:

Creates and returns an image from the contents of an IOSurface.

+ imageWithIOSurface:options:

Creates, using the specified options, and returns an image from the contents of an IOSurface.