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.