cmsCheckGamut(3)

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

SYNOPSIS
     #include <cms.h>

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

DESCRIPTION
     cmsCheckGamut 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.

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
     cmsCreateGamutCheck