Carbon


CMGetPreferredCMM

Header: CMApplication.h Carbon status: Supported

Identifies the preferred CMM specified by the ColorSync control panel.

CMError CMGetPreferredCMM (
    OSType *cmmType, 
    Boolean *preferredCMMnotfound
);
Parameter descriptions
cmmType

A pointer to an OSType. On return, the component subtype for the preferred CMM. For example, the subtype for ColorSync’s default CMM is 'appl' and the subtype for the Kodak CMM is 'KCMS'. A return value of NULL indicates the preferred CMM in the ColorSync control panel is set to Automatic.

preferredCMMnotfound

A pointer to a Boolean flag for whether the preferred CMM was not found. On return, has the value true if the CMM was not found, false if it was found.

DISCUSSION

The CMGetPreferredCMM function returns in the cmmType parameter a value that identifies the preferred CMM the user last specified in the ColorSync control panel. CMGetPreferredCMM returns false in the preferredCMMnotfound parameter if the preferred CMM is currently available and true if it is not. The preferred CMM may not be available, for example, because a user specifies a preferred CMM in the ColorSync control panel, then reboots with extensions off. ColorSync does not change the preferred CMM setting when the preferred CMM is not available.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when ColorSync 2.5 or later is present.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)