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.
Declaration
CMError CMGetPS2ColorRenderingIntent (
CMProfileRef srcProf,
UInt32 flags,
CMFlattenUPP proc,
void *refCon,
Boolean *preferredCMMnotfound
);Parameters
- srcProf:
A profile reference to the source profile that defines the data color space and identifies the preferred CMM.
- flags:
If the value of
flagsis equal tocmPS8bit, the generated PostScript will utilize 8-bit encoding whenever possible to achieve higher data compaction. If the value offlagsis not equal tocmPS8bit, 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 function Cmflattenprocptr.
- refCon:
An untyped pointer to arbitrary data supplied by your application.
CMGetPS2ColorSpacepasses this data in calls to your Cmflattenprocptr function. - preferredCMMnotfound:
A pointer to a flag for whether the preferred CMM was found. On return, has the value
trueif the CMM corresponding to profile was not available or if it was unable to perform the function and the default CMM was used. Otherwise, has the valuefalse.
Return Value
A CMError value. See Result Codes.
Overview
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 CMM.