Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

GetPS2ColorRenderingDictionary function

The GetPS2ColorRenderingDictionary function retrieves the PostScript Level 2 color rendering dictionary from the specified ICC color profile.

Syntax


BOOL WINAPI GetPS2ColorRenderingDictionary(
  HPROFILE hProfile,
  DWORD dwIntent,
  PBYTE pBuffer,
  PDWORD pcbSize,
  PBOOL pbBinary
);

Parameters

hProfile

Specifies a handle to the ICC color profile in question.

dwIntent

Specifies the desired rendering intent for the color rendering dictionary. Valid values are:

INTENT_PERCEPTUALINTENT_SATURATIONINTENT_RELATIVE_COLORIMETRICINTENT_ABSOLUTE_COLORIMETRIC

For more information, see Rendering Intents.

pBuffer

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

pcbSize

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

pbBinary

Pointer to a Boolean variable. If TRUE, the color rendering dictionary could be copied in binary form. If FALSE, the dictionary will be encoded in ASCII85 form. On return, this Boolean variable indicates whether the dictionary was actually binary (TRUE) or ASCII85 (FALSE).

Return value

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.

Remarks

If the dictionary is not available in the profile, the GetPS2ColorRenderingDictionary function builds one using the profile contents. This dictionary can then be used as the operand for the PostScript Level 2 setcolorrendering operator.

This method does not support WCS profiles.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Icm.h

Library

Mscms.lib

DLL

Mscms.dll

See also

Basic Color Management Concepts
Functions

 

 

Community Additions

Show:
© 2014 Microsoft