Function

vImageCreateMonochromeColorSpaceWithWhitePointAndTransferFunction

Creates a monochrome color space based on primitives typically found in Y'CbCr specifications.

Declaration

CGColorSpaceRef vImageCreateMonochromeColorSpaceWithWhitePointAndTransferFunction(const vImageWhitePoint *whitePoint, const vImageTransferFunction *tf, CGColorRenderingIntent intent, vImage_Flags flags, vImage_Error *error);

Parameters

whitePoint

Values that define the white point.

tf

The transfer function.

intent

A rendering intent constant that specifies how to handle colors not located within the gamut of the destination color space.

flags

The options to use when performing the operation. This function only supports kvImagePrintDiagnosticsToConsole, which prints diagnostic information to the console in the event of a failure.

error

A pointer to a vImage_Error; the pointer is overwritten to indicate the success or failure of the operation.

Return Value

A CGColorSpaceRef with a reference count of one.

Discussion

You use this function to create a CGColorSpaceRef instance to correspond with a given set of color primaries and a transfer function. The CGColorSpaceRef instance defines an RGB color space. (A Y'CbCr color space is defined as an RGB color space and a conversion matrix from RGB to Y'CbCr.) The color primaries give the extent of a color space in x, y, z space, and the transfer function gives the transformation from linear color to nonlinear color that the pixels reside in.

See Also

Creating Core Graphics Image Formats

vImage_CGImageFormat

The description of a Core Graphics image.

vImageCreateRGBColorSpaceWithPrimariesAndTransferFunction

Creates an RGB color space based on primitives typically found in Y'CbCr specifications.

vImageRGBPrimaries

A structure that represents the chromaticity of primaries defining a color space.

vImageWhitePoint

A structure that represents a white point according to the CIE 1931 color space.

vImageTransferFunction

A structure that represents a transfer function to convert from linear to nonlinear RGB.

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