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 /

CMGetPS2ColorRenderingVMSize

Determines the virtual memory size of the color rendering dictionary (CRD) for a printer profile before your application or driver obtains the CRD and sends it to the printer.

pascal CMError CMGetPS2ColorRenderingVMSize (
CMProfileRef srcProf,
CMProfileRef dstProf,
unsigned long *vmSize, 
Boolean *preferredCMMnotfound);

srcProf

A profile reference to a profile that supplies the rendering intent for the CRD.

dstProf

A profile reference to the destination printer profile.

vmSize

A pointer to a memory size. On return, the virtual memory size of the CRD.

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

Your application or device driver can call this function to determine if the virtual memory size of the color rendering dictionary exceeds the printer's capacity before sending the CRD to the printer. If the printer's profile contains the Apple-defined optional tag 'psvm' described in "Concatenated Profile Set Structure" (page 3-49), then the Apple CMM will return the data supplied by this tag specifying the CRD virtual memory size for the rendering intent's CRD. If the printer's profile does not contain this tag, then the CMM uses an algorithm to assess the VM size of the CRD, in which case the assessment can be larger than the actual maximum VM size.

The CMM uses the profile specified by the srcProf parameter to determine the rendering intent to use.