CMGetPS2ColorSpaceArray Function

The CMGetPS2ColorSpaceArray function retrieves the PostScript Level 2 color space array from a profile.

Syntax

BOOL WINAPI CMGetPS2ColorSpaceArray(
    HPROFILE hProfile,
    DWORD dwIntent,
    DWORD dwCSAType,
    LPBYTE lpBuffer,
    LPDWORD lpcbSize,
    LPBOOL lpbBinary
);

Parameters

hProfile

Specifies the profile to use.

dwIntent

Specifies the desired rendering intent for the color space array. Can be one of the following values:

INTENT_PERCEPTUALINTENT_SATURATIONINTENT_RELATIVE_COLORIMETRICINTENT_ABSOLUTE_COLORIMETRIC

For more information, see Rendering Intents.

dwCSAType

Specifies the type of color space array. See Color Space Type Identifiers.

lpBuffer

Pointer to a buffer in which the color space array is to be placed. If the pointer is NULL, the function returns the size required for this buffer in the memory location pointed to by lpcbSize.

lpcbSize

Pointer to a variable specifying the size of the buffer. On return, the variable contains has the number of bytes actually copied to the buffer.

lpbBinary

Pointer to a Boolean variable. If its value is TRUE, data returned could be binary, or if FALSE, the data should be ASCII85 encoded. On return, the value of in the memory location pointed to by lpbBinary indicates whether the data returned actually is binary or ASCII85.

Return Value

If this function succeeds, the return value is TRUE. It also returns TRUE if it is called with lpBuffer set to NULL and the size of the required buffer is copied into lpcbSize.

If this function fails, the return value is FALSE. When this occurs, the CMM should call SetLastError to set the last error to a valid error value defined in Winerror.h.

Remarks

This function is optional for all CMMs.

If a CMM does not support this function, Windows uses the default CMM to create the color space array.

If the color space array tag is not present in the profile, the CMM should create the color space array from the profile contents. The resulting color space array can be used as the operand for the PostScript Level 2 setcolorspace operator.

Requirements

See Also

Basic Color Management Concepts

Functions

Send comments about this topic to Microsoft

Build date: 11/16/2010