GetPS2ColorRenderingIntent

  • Article

The GetPS2ColorRenderingIntent function retrieves the PostScript Level 2 color rendering intent from an ICC color profile.

BOOL WINAPI GetPS2ColorRenderingIntent(
  HPROFILE hProfile,  DWORD dwIntent,  PBYTE pBuffer,  PDWORD pcbSize);

Parameters

  • hProfile
    Specifies a handle to the ICC color profile in question.

  • dwIntent
    Specifies the desired rendering intent to retrieve. Valid values are:

    INTENT_PERCEPTUAL
    INTENT_SATURATION
    INTENT_RELATIVE_COLORIMETRIC
    INTENT_ABSOLUTE_COLORIMETRIC

    For more information, see Rendering Intents.

  • pBuffer
    Points to a buffer in which the color rendering intent is to be placed. If the pBuffer pointer is set to NULL, the buffer size required is returned in *pcbSize.

  • pcbSize
    Points to a variable containing the buffer size in bytes. On return, this variable contains the number of bytes actually copied.

Return Values

If this function succeeds, the return value is TRUE. If this function succeeds, the return value is TRUE. It also returns TRUE if the pBuffer parameter is NULL and the size required for the buffer is copied into pcbSize.

If this function fails, the return value is FALSE. For extended error information, call GetLastError.

Remarks

The rendering intent returned by GetPS2ColorRenderingIntent can be used as the operand for the PostScript Level 2 findcolorrendering operator.

This method does not support WCS profiles.

Requirements

**  Windows NT/2000/XP/Vista:** Included in Windows 2000 and later.
**  Windows 95/98/Me:** Included in Windows 98 and later.
**  Header:** Declared in Icm.h.
**  Library:** Use Mscms.lib.

See Also

Basic Color Management Concepts, Functions