cmsTfmCheckGamut(3)

NAME
     cmsTfmCheckGamut - test pixels in a buffer to see whether they are in
     gamut for a given transform

SYNOPSIS
     #include <cms.h>

     int32 cmsTfmCheckGamut (ctxt, tfm, *psrc, pgamutmap);
     CMSContext ctxt;
     CMSTfm tfm;
     CMSPixelBuffer *psrc;
     CMSGamutMap pgamutmap;

DESCRIPTION
     cmsTfmCheckGamut uses the transform tfm to test input pixel buffer psrc
     and generate the output flags buffer pgamutmap for out-of-gamut
     indication.  The order of bits in pgamutmap follows the order of input
     pixels.

     Gamut checking may take a while to perform.  If you are concerned about
     maintaining interactivity, you  may wish to check portions of images in
     smaller sized chunks.  The hint CMS_SPEED_ACHIEVED indicates the rate at
     which the system can update pixels using the current transform.  It is
     safe to assume that gamut checking will run at a comparable rate.

ERRORS
     CMS_OUT_OF_MEMORY
               There is not sufficient memory available for gamut testing.

     CMS_BAD_PIXEL_BUF
               psrc is not a valid pixel buffer.

     CMS_BAD_GAMUT_MAP
               pgamutmap is not a valid gamut map buffer.

     CMS_BAD_TFM
               tfm is not a valid transform, or it has not been built.

     CMS_CONVERT_ERROR
               The transform specified by tfm is not valid.

SEE ALSO
     cmsTfmBuild