cmsTfmCheckGamut(3) CMS 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
Page 1
