Legacy Document

Inside Macintosh: Advanced Color Imaging Reference /

Chapter 3 - ColorSync Manager Reference for Applications and Device Drivers / ColorSync Manager Functions

PostScript Color-Matching Support Functions /

CMGetPS2ColorRenderingIntent

Obtains the rendering intent element data in text format usable as the parameter to the PostScript findRenderingIntent operator, which specifies the color-matching option for subsequent graphics data.

pascal CMError CMGetPS2ColorRenderingIntent (
CMProfileRef srcProf, 
unsigned long flags, 
CMFlattenUPP proc,
void *refCon,
Boolean *preferredCMMnotfound);

srcProf

A profile reference to the source profile. You cannot specify NULL to indicate the system profile. If you use the system profile, you must specify an explicit reference.

flags

If the value of flags is equal to cmPS8bit, the generated PostScript will utilize 8-bit encoding whenever possible to achieve higher data compaction. If the value of flags is not equal to cmPS8bit, the generated data will be 7-bit safe, in either ASCII or ASCII base-85 encoding.

proc

A low-level data transfer function supplied by the calling application to receive the PostScript data from the CMM. For more information, see the MyColorSyncDataTransfer function (page 3-167).

refCon

A reference constant for application data passed as a parameter to calls to the MyColorSyncDataTransfer function.

preferredCMMnotfound

A pointer to a Boolean value indicating whether the preferred CMM was found. On output, has the value true if the CMM corresponding to profile was not available or if it was unable to perform the function and the default Apple CMM was used. Otherwise, has the value false.

function result

A result code of type CMError. See "Result Codes" (page 3-174) for a list of ColorSync-specific result codes.

DISCUSSION

The CMGetPS2ColorRenderingIntent function obtains PostScript rendering intent information from the header of the source profile. It returns data by calling your low-level data transfer procedure and passing the PostScript data to it. Typically, your low-level data transfer function returns this data to the calling application or device driver to pass to a PostScript printer.

The CMGetPS2ColorRenderingIntent function is dispatched to the CMM component specified by the source profile. If the designated CMM is not available or the CMM does not implement this function, then ColorSync dispatches the function to the default Apple CMM.