Function

vImageCreateMonochromeColorSpaceWithWhitePointAndTransferFunction(_:_:_:_:_:)

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

Declaration

func vImageCreateMonochromeColorSpaceWithWhitePointAndTransferFunction(_ whitePoint: UnsafePointer<vImageWhitePoint>, _ tf: UnsafePointer<vImageTransferFunction>, _ intent: CGColorRenderingIntent, _ flags: vImage_Flags, _ error: UnsafeMutablePointer<vImage_Error>!) -> Unmanaged<CGColorSpace>!

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 CGColorSpace with a reference count of one.

Discussion

You use this function to create a CGColorSpace instance to correspond with a given set of color primaries and a transfer function. The CGColorSpace 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

struct vImage_CGImageFormat

The description of a Core Graphics image.

struct vImageRGBPrimaries

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

struct vImageWhitePoint

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

struct vImageTransferFunction

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