Export (0) Print
Expand All
Expand Minimize

CMGetPS2ColorRenderingIntent Function

The CMGetPS2ColorRenderingIntent function retrieves the PostScript Level 2 color rendering intent from a profile.

Syntax

BOOL WINAPI CMGetPS2ColorRenderingIntent(
    HPROFILE hProfile,
    DWORD dwIntent,
    LPBYTE lpBuffer,
    LPDWORD lpcbSize
);

Parameters

hProfile

Specifies the profile to use.

dwIntent

Specifies the desired rendering intent to retrieve. Can be one of the following values:

INTENT_PERCEPTUALINTENT_SATURATIONINTENT_RELATIVE_COLORIMETRICINTENT_ABSOLUTE_COLORIMETRIC

For more information, see Rendering Intents.

lpBuffer

Points to a buffer in which the color rendering intent is to be placed. If the pointer is NULL, the function returns the size required for this buffer in *lpcbSize.

lpcbSize

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

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 get the color rendering intent.

If the tag is not present in the profile indicated by hProfile, the CMM creates it. The resulting rendering intent can be used as the operand for the PostScript Level 2 findcolorrendering operator.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Wingdi.h

Library

Gdi32.lib

DLL

Gdi32.dll

See Also

Basic Color Management Concepts
Functions

 

 

Send comments about this topic to Microsoft

Build date: 11/16/2010

Community Additions

ADD
Show:
© 2014 Microsoft