cmsApplyTfm(3) CMS cmsApplyTfm(3)NAME
cmsApplyTfm - apply a color management tranform to a pixel buffer
SYNOPSIS
#include <cms.h>
int32 cmsApplyTfm (ctxt, tfm, *psrc, *pdest);
CMSContext ctxt;
CMSTfm tfm;
CMSPixelBuffer *psrc;
CMSPixelBuffer *pdest;
DESCRIPTION
cmsTfmApply uses the transform tfm to apply a conversion to the input
pixel buffer psrc, generating the output pixel buffer pdest.
In-place conversions may not be possible; for example, if the output
format requires more space than the input format (RGB to CMYK), or if the
CMM can not support in-place conversions. In such cases, an error will
be generated.
Transformations may take a while to perform. If you are concerned about
maintaining interactivity, you may wish to transform images in smaller
sized chunks. Use the hint CMS_SPEED_ACHIEVED to determine the rate at
which the system can update pixels using the current transform. Using
this number as a guide, you can perform a lengthy conversion in chunks
small enough to maintain interactive responsiveness.
ERRORS
CMS_WRONG_DATA
Either one of the pixel buffer pointers does not point to a
pixel buffer, or it points to a buffer of the wrong format for
the transform.
CMS_BAD_TFM
tfm is either not a transform, or it is not a transform built
using the context ctxt.
CMS_BAD_PIXEL_BUF
Either one of the pixel buffer pointers does not point to a
pixel buffer, or it points to a buffer of the wrong format for
the transform.
CMS_CONVERT_ERROR
This transform could not be applied to the data. This error
will be generated if a transform could not be performed in-
place.
Page 1
