kCMMGetPS2ColorRenderingIntentrequest by obtaining the rendering intent from the source profile.
A CMM may respond to the
kCMMGetPS2ColorRenderingIntentrequest code, but it is not required to do so. The ColorSync Manager sends this request code to your CMM on behalf of an application that called the
CMGetPS2ColorRenderingIntentfunction. The ColorSync Manager dispatches this request to the Component Manager, which calls your CMM to service the request. A CMM typically responds to the
kCMMGetPS2ColorRenderingIntentrequest code by calling a CMM-defined function (for example,
MyCMMGetPS2ColorRenderingIntent) to handle the request.
The MyCMMGetPS2ColorRenderingIntent function is a color management module-defined subroutine.
pascal CMError MyCMMGetPS2ColorRenderingIntent( ComponentInstance CMSession, CMProfileRef srcProf, unsigned long flags, CMFlattenUPP proc, void *refCon);
- A handle to your CMM's storage for the instance of your component associated with the calling application or device driver.
- A profile reference to the source profile whose header contains the rendering intent.
- Reserved for future use.
- A pointer to a function supplied by the calling application or device driver. Your
MyCMMGetPS2ColorRenderingIntentfunction calls this function repeatedly as necessary until you have passed all the source profile's rendering intent data to this function.
- A reference constant, containing data specified by the calling application or device driver, that your
MyCMMGetPS2ColorRenderingIntentfunction must pass to the
- function result
- A result code of type CMError. See "Result Codes" (page 3-172) for a list of ColorSync-specific result codes.
DISCUSSIONOnly for special cases should a custom CMM need to support this request code. If your CMM supports this function, your
MyCMMGetPS2ColorRenderingIntentfunction must obtain the rendering intent from the source profile whose reference is passed to your function in the
srcProfparameter. The byte stream containing the rendering intent data that your function passes to the
MyColorSyncDataTransferfunction is used as the operand to the PostScript
Your function must allocate a
databuffer in which to pass the rendering intent data to the
MyColorSyncDataTransferfunction supplied by the calling application or driver. Your
MyCMMGetPS2ColorRenderingIntentfunction must call the
MyColorSyncDataTransferfunction repeatedly until you have passed all the data to it.
Here is the prototype for the
MyColorSyncDataTransferfunction pointed to by the
pascal OSErr MyColorSyncDataTransfer( long command, long *size, void *data, void *refCon);Your
MyCMMGetPS2ColorRenderingIntentfunction communicates with the
MyColorSyncDataTransferfunction using a command parameter to identify the operation to perform. Your function should call the
MyColorSyncDataTransferfunction first with the
openWriteSpoolcommand to direct the
MyColorSyncDataTransferfunction to begin the process of writing the profile color-rendering intent element data you pass it in the
databuffer. Next, you should call the
MyColorSyncDataTransferfunction with the
writeSpoolcommand. After the
MyColorSyncDataTransferfunction returns in the
sizeparameter the amount of data it actually read, you should call the
MyColorSyncDataTransferfunction again with the
writeSpoolcommand, repeating this process as often as necessary until all the color-rendering intent data is transferred. After the data is transferred, you should call the
MyColorSyncDataTransferfunction with the
When your function calls the
MyColorSyncDataTransferfunction, it passes in the
databuffer the profile data to transfer to the
MyColorSyncDataTransferfunction and the size in bytes of the buffered data in the
MyColorSyncDataTransferfunction may not always write all the data you pass it in the
databuffer. Therefore, on return the
MyColorSyncDataTransferfunction command passes back in the
sizeparameter the number of bytes it actually wrote. Your
MyCMMGetPS2ColorRenderingIntentfunction keeps track of the number of bytes of remaining color-rendering intent element data.
Each time your
MyCMMGetPS2ColorRenderingIntentfunction calls the
MyColorSyncDataTransferfunction, you pass it the reference constant passed to your function in the reference constant parameter.
SEE ALSOFor information about PostScript operations, see the PostScript Language Manual, second edition.