![]() |
CWMatchBitmap |
||||
Header: | CMApplication.h | Carbon status: | Supported | |
Matches the colors of a bitmap to the gamut of a destination device using the profiles specified by a color world.
CMError CWMatchBitmap ( CMWorldRef cw, CMBitmap *bitmap, CMBitmapCallBackUPP progressProc, void *refCon, CMBitmap *matchedBitmap );
A reference to a color world of type CMWorldRef in which matching is to occur.
The functions NCWNewColorWorld and CWConcatColorWorld both allocate color world references of type CMWorldRef.
A pointer to a bitmap of type CMBitmap whose colors are to be matched.
A calling programsupplied universal procedure pointer to a callback function that allows your application to monitor progress or abort the operation as the bitmap colors are matched. The default CMM calls your function approximately every half-second unless color matching occurs in less time; this happens when there is a small amount of data to be matched. If the function returns a result of true, the operation is aborted. To match colors without monitoring the process, specify NULL for this parameter. For a description of the function your application supplies, see the function CMBitmapCallBackProcPtr.
A pointer to a reference constant for application data passed through as a parameter to calls to the progressProc function.
A pointer to a bitmap. On return, contains the color-matched image. You must allocate the pixel buffer pointed to by the image field of the structure CMBitmap. If you specify NULL for matchedBitMap, then the source bitmap is matched in place.
The CWMatchBitmap function matches a bitmap using the profiles specified by the given color world.
You should ensure that the buffer pointed to by the image field of the bitmap passed in the bitMap parameter is zeroed out before you call this function.
The ColorSync Manager does not explicitly support a CMY color space. However, for printers that have a CMY color space, you can use either of the following circumventions to make the adjustment:
For this function to execute successfully, the source profiles dataColorSpace field value and the space field value of the source bitmap pointed to by the bitMap parameter must specify the same data color space. Additionally, the destination profiles dataColorSpace field value and the space field value of the resulting bitmap pointed to by the matchedBitMap parameter must specify the same data color space, unless the destination profile is a named color space profile.
If you set matchedBitMap to NULL to specify in-place matching, you must be sure the space required by the destination bitmap is less than or equal to the size of the source bitmap.
The color spaces currently supported for the CWMatchBitmap function are defined in
Supported in Carbon. Available in Carbon 1.0.2 and later when ColorSync 2.0 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)