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.
Declaration
CMError CMGetPS2ColorRenderingVMSize (
CMProfileRef srcProf,
CMProfileRef dstProf,
UInt32 *vmSize,
Boolean *preferredCMMnotfound
);Parameters
- 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 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
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 CMConcatProfileSet, then the default 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.