Important: The information in this document is obsolete and should not be used for new development.
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 valuefalse
.- 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.