cmsCreateGamutCheck(3) CMS cmsCreateGamutCheck(3)NAMEcmsCreateGamutCheck - creates a gamut check from a set of profiles
SYNOPSIS
#include <cms.h>
int32 cmsCreateGamutCheck (ctxt, profileCount, profs, cmm, ptfm);
CMSContext ctxt;
int32 profileCount;
CMSProfile *profs;
icSignature cmm;
CMSTfm *ptfm;
DESCRIPTIONcmsCreateGamutCheck uses a color manipulation module (CMM) to create a
gamut check out of a list of profiles. The resulting gamut check
simulates a sequential execution of the algorithms implied by the
individual profiles, starting from the first profile and ending in the
last profile, and then indicates whether the pixels resulting from that
transform are reproduceable on the device indicated by the final profile.
See cmsCheckGamut for an explanation of the results of applying a gamut
check.
Different CMMs will produce different transforms from the same set of
profiles. The transforms will yield different results when applied a
given set of pixels. Application writers may wish to control which CMM
is used to create and apply a transform. Accordingly, they will wish to
use the same CMM when checking the reproducibility of colors. They may
do so by specifying the CMM's name with the cmm parameter. The list of
supported CMMs is returned from the command cmsGetCmmList. Application
writers who have no preference as to the CMM used may do one of two
things. They may specify that the system's default CMM be used by setting
cmm to CMS_USE_DEFAULT_CMM. Each profile in the list profs may specify a
preferred CMM in its header. If the application writer sets cmm to
CMS_USE_PROFILE_CMM, then the CMS goes through the list of profiles from
last to first and lets each specified CMM try to build the transform. If
the CMM can build the transform, the result is used, and that CMM will be
used to apply the transform. If the CMM cannot build the tranform, the
next one in order will be tried. If not of the CMMs can build the
tranform, cmsCreateTfm returns an error. The reason the list is
traversed backward is that output devices tend to be at the end of the
profile list, and it is the profiles of output devices that tend to have
the most dramatic effects on a tranform.
ERRORS
CMS_OUT_OF_MEMORY
There is not enough memory available to create a gamut check.
CMS_WRONG_DATA
The ctxt points to something that is not a context.
Page 1
cmsCreateGamutCheck(3) CMS cmsCreateGamutCheck(3)
CMS_BAD_ENCODE
CMS_BAD_CONTEXT
CMS_TOO_MANY_CHANNELS
The CMM cannot support a gamut check with the requested number
of channels.
CMS_CMM_NOT_AVAILABLE
The requested CMM is not available.
SEE ALSO
cmsCheckGamut, cmsCreateTfm
Page 2