ColorSync Manager

Overview

The ColorSync Manager is the API for ColorSync, a platform-independent color management system from Apple. ColorSync provides essential services for fast, consistent, and accurate color calibration, proofing, and reproduction using input, output, and display devices. ColorSync also provides an interface to system-wide color management settings that allows users to save color settings for specific jobs and switch between settings.

You need this reference if your software product performs color drawing, printing, or calculation, or if your peripheral device supports color. You also need this reference if you are creating a color management module (CMM)—a component that implements color-matching, color-conversion, and gamut-checking services.

The Color Picker Manager, documented separately, provides a standard user interface for soliciting color choices.

Carbon supports the majority of the ColorSync Manager programming interface. However, ColorSync 1.0 compatibility calls such as CWNewColorWorld, GetProfile, and SetProfile are not supported.

Nor does Carbon support ColorSync functions used for color management modules (CMMs). These functions aren't supported because macOS uses Bundle Services to implement CMMs.

Some applications use the Component Manager to determine what CMMs are available. You cannot use the Component Manager for this purpose in macOS. Apple has, however, provided the function CMIterateCMMInfo to query for available CMMs.

Topics

Accessing Profiles

CMOpenProfile

Opens the specified profile and returns a reference to the profile.

CMValidateProfile

Indicates whether the specified profile contains the minimum set of elements required by the current color management module (CMM) for color matching or color checking.

CMCloseProfile

Decrements the reference count for the specified profile reference and, if the reference count reaches 0, frees all private memory and other resources associated with the profile.

CMUpdateProfile

Saves modifications to the specified profile.

CMCopyProfile

Duplicates the specified existing profile.

CMProfileModified

Indicates whether the specified profile has been modified since it was created or last updated.

CMGetProfileMD5

Gets the MD5 checksum from the profile header (message digest)

CMGetProfileHeader

Obtains the profile header for the specified profile.

CMSetProfileHeader

Sets the header for the specified profile.

CMGetProfileLocation

Obtains the location of a profile based on the specified profile reference.

NCMGetProfileLocation

Obtains either a profile location structure for a specified profile or the size of the location structure for the profile.

CMCloneProfileRef

Increments the reference count for the specified profile reference.

CMGetProfileRefCount

Obtains the current reference count for the specified profile.

CMFlattenProfile

Transfers a profile stored in an independent disk file to an external profile format that can be embedded in a graphics document.

NCMUnflattenProfile

Unflattens a previously flattened profile.

Iterating Installed Profiles

CMIterateColorSyncFolder

Iterates over the available profiles.

CMGetColorSyncFolderSpec

Obtains the volume reference number and the directory ID for a ColorSync Profiles folder.

Creating Profiles

CMNewProfile

Creates a new profile and associated backing copy.

CWNewLinkProfile

Creates a device link profile based on the specified set of profiles.

NCWNewLinkProfile

Obtains a profile reference for the specified by the profile location.

CMMakeProfile

Makes a display or abstract profile by modifying an existing one.

Accessing Special Profiles

CMGetSystemProfile

Obtains a reference to the current system profile.

CMSetSystemProfile

Sets the current system profile.

NCMSetSystemProfile

Sets the location of a color profile.

CMGetDefaultProfileBySpace

Gets the default profile for the specified color space.

CMSetDefaultProfileBySpace

Sets the default profile for the specified color space.

CMGetDefaultProfileByUse

Obtains the users’ preferred device profile setting.

CMSetDefaultProfileByUse

Sets values for device profile settings.

CMGetProfileByAVID

Gets the current profile for a monitor.

CMSetProfileByAVID

Sets the profile for the specified monitor, optionally setting video card gamma.

Accessing Profile Elements

CMCountProfileElements

Counts the number of elements in the specified profile.

CMProfileElementExists

Tests whether the specified profile contains a specific element based on the element’s tag signature.

CMGetProfileElement

Obtains element data from the specified profile based on the specified element tag signature.

CMSetProfileElement

Sets or replaces the element data for a specific tag in the specified profile.

CMSetProfileElementSize

Reserves the element data size for a specific tag in the specified profile before setting the element data.

CMGetPartialProfileElement

Obtains a portion of the element data from the specified profile based on the specified element tag signature.

CMSetPartialProfileElement

Sets part of the element data for a specific tag in the specified profile.

CMGetIndProfileElementInfo

Obtains the element tag and data size of an element by index from the specified profile.

CMGetIndProfileElement

Obtains the element data corresponding to a particular index from the specified profile.

CMSetProfileElementReference

Adds a tag to the specified profile to refer to data corresponding to a previously set element.

CMRemoveProfileElement

Removes an element corresponding to a specific tag from the specified profile.

Accessing Profile Descriptions

CMCopyProfileDescriptionString

Returns the name of a profile as a CFString.

CMCopyProfileLocalizedString

Gets one specific string out of a profile

CMCopyProfileLocalizedStringDictionary

Obtains a CFDictionary which contains the language locale and string for multiple localizations from a given tag.

CMSetProfileLocalizedStringDictionary

Writes a dictionary of localized strings to a given tag in a profile.

CMGetScriptProfileDescription

Obtains the internal name (or description) of a profile and the script code identifying the language in which the profile name is specified from the specified profile.

CMGetProfileDescriptions

Obtains the description tag data for a specified profile.

CMSetProfileDescriptions

Sets the description tag data for a specified profile.

Accessing Name-Class Profiles

CMGetNamedColorInfo

Obtains information about a named color space from its profile reference.

CMGetNamedColorValue

Obtains device and PCS color values for a specific color name from a named color space profile.

CMGetIndNamedColorValue

Obtains device and PCS color values for a specific named color index from a named color space profile.

CMGetNamedColorIndex

Obtains a named color index for a specific color name from a named color space profile.

CMGetNamedColorName

Obtains a named color name for a specific named color index from a named color space profile.

Working With ColorWorlds

NCWNewColorWorld

Creates a color world for color matching based on the specified source and destination profiles.

CWConcatColorWorld

Sets up a color world that includes a set of profiles for various color transformations among devices in a sequence.

NCWConcatColorWorld

Defines a color world for color transformations among a series of concatenated profiles.

CMGetCWInfo

Obtains information about the color management modules (CMMs) used for a specific color world.

CWDisposeColorWorld

Releases the private storage associated with a color world when your application has finished using the color world.

CWMatchColors

Matches colors in a color list, using the specified color world.

CWCheckColors

Tests a list of colors using a specified color world to see if they fall within the gamut of a destination device.

CWMatchBitmap

Matches the colors of a bitmap to the gamut of a destination device using the profiles specified by a color world.

CWCheckBitmap

Tests the colors of the pixel data of a bitmap to determine whether the colors map to the gamut of the destination device.

CWFillLookupTexture

Fills a 3-D lookup texture from a color world.

Converting Colors

CMConvertXYZToLab

Converts colors specified in the XYZ color space to the L*a*b* color space.

CMConvertLabToXYZ

Converts colors specified in the L*a*b* color space to the XYZ color space.

CMConvertXYZToLuv

Converts colors specified in the XYZ color space to the L*u*v* color space.

CMConvertLuvToXYZ

Converts colors specified in the L*u*v* color space to the XYZ color space.

CMConvertXYZToYxy

Converts colors specified in the XYZ color space to the Yxy color space.

CMConvertYxyToXYZ

Converts colors specified in the Yxy color space to the XYZ color space.

CMConvertRGBToHLS

Converts colors specified in the RGB color space to equivalent colors defined in the HLS color space.

CMConvertHLSToRGB

Converts colors specified in the HLS color space to equivalent colors defined in the RGB color space.

CMConvertRGBToHSV

Converts colors specified in the RGB color space to equivalent colors defined in the HSV color space when the device types are the same.

CMConvertHSVToRGB

Converts colors specified in the HSV color space to equivalent colors defined in the RGB color space.

CMConvertRGBToGray

Converts colors specified in the RGB color space to equivalent colors defined in the Gray color space.

CMConvertXYZToFixedXYZ

Converts colors specified in the XYZ color space whose components are expressed as XYZ 16-bit unsigned values of type CMXYZColor to equivalent colors expressed as 32-bit signed values of type CMFixedXYZColor.

CMConvertFixedXYZToXYZ

Converts colors specified in XYZ color space whose components are expressed as Fixed XYZ 32-bit signed values of type CMFixedXYZColor to equivalent colors expressed as XYZ 16-bit unsigned values of type CMXYZColor.

CMConvertXYZToXYZ

Converts a source color to a destination color using the specified chromatic adaptation method.

Working With CMMs

CMGetPreferredCMM

Identifies the preferred CMM specified by the ColorSync control panel.

CMIterateCMMInfo

Iterates through the color management modules installed on the system.

Working With PostScript

CMGetPS2ColorSpace

Obtains color space element data in text format usable as the parameter to the PostScript setColorSpace operator, which characterizes the color space of subsequent graphics data.

CMGetPS2ColorRenderingIntent

Obtains the rendering intent element data in text format usable as the parameter to the PostScript findRenderingIntent operator, which specifies the color-matching option for subsequent graphics data.

CMGetPS2ColorRendering

Obtains the color rendering dictionary (CRD) element data usable as the parameter to the PostScript setColorRendering operator, which specifies the PostScript color rendering dictionary to use for the following graphics data.

CMGetPS2ColorRenderingVMSize

Determines the virtual memory size of the color rendering dictionary (CRD) for a printer profile before your application or driver obtains the CRD and sends it to the printer.

Working With QuickDraw

CWMatchPixMap

Matches a pixel map in place based on a specified color world.

CWCheckPixMap

Checks the colors of a pixel map using the profiles of a specified color world to determine whether the colors are in the gamut of the destination device.

NCMBeginMatching

Sets up a QuickDraw-specific ColorSync matching session, using the specified source and destination profiles.

CMEndMatching

Concludes a QuickDraw-specific ColorSync matching session initiated by a previous call to the NCMBeginMatching function.

NCMDrawMatchedPicture

Matches a picture’s colors to a destination device’s color gamut, as the picture is drawn, using the specified destination profile.

CMEnableMatchingComment

Inserts a comment into the currently open picture to turn matching on or off.

NCMUseProfileComment

Automatically embeds a profile or a profile identifier into an open picture.

Registering Devices

CMRegisterColorDevice

Registers a device with ColorSync.

CMUnregisterColorDevice

Unregisters a device.

Accessing Default Devices

CMGetDefaultDevice

Gets the default device.

CMSetDefaultDevice

Sets the default device.

Accessing Devices Profiles

CMGetDeviceFactoryProfiles

Retrieves the original profiles for a given device.

CMSetDeviceFactoryProfiles

Establishes the profiles used by a given device.

CMGetDeviceProfiles

Gets the profiles used by a given device.

CMSetDeviceProfiles

Changes the profiles used by a given device.

CMGetDeviceDefaultProfileID

Gets the default profile ID for a given device.

CMSetDeviceDefaultProfileID

Sets the default profile ID for a given device.

CMSetDeviceProfile

Change the profile used by a given device.

CMGetDeviceProfile

Gets a profile used by a given device.

Accessing Device State and Information

CMGetDeviceState

Gets the state of a device.

CMSetDeviceState

Sets the state of a device.

CMGetDeviceInfo

Gets information about a specified device.

Iterating Over Devices and Device Profiles

CMIterateColorDevices

Iterates through the color devices available on the system, returning device information to a callback you supply.

CMIterateDeviceProfiles

Iterates through the device profiles available on the system and returns information about profiles of the devices to a callback you supply.

Working With Image Files

CMValidImage

Validates the specified image file.

CMGetImageSpace

Returns the signature of the data color space in which the color values of colors in an image are expressed.

CMEmbedImage

Embeds an image with an ICC profile.

CMUnembedImage

Removes any ICC profiles embedded in an image.

CMMatchImage

Color matches an image file.

CMProofImage

Proofs an image.

CMLinkImage

Matches an image file with a device link profile.

CMCountImageProfiles

Obtains a count of the number of embedded profiles for a given image.

CMGetIndImageProfile

Obtains a specific embedded profile for a given image.

CMSetIndImageProfile

Sets a specific embedded profile for a given image.

Working With Video Card Lookup Tables

CMGetGammaByAVID

Obtains the gamma value for the specified display device.

CMSetGammaByAVID

Sets the gamma for the specified display device.

Miscellaneous

CMGetColorSyncVersion

Gets ColorSync version information.

CMLaunchControlPanel

Launches the ColorSync preferences pane.

Working With Universal Procedure Pointers

NewCMBitmapCallBackUPP

Creates a new universal procedure pointer (UPP) to a bitmap callback.

DisposeCMBitmapCallBackUPP

Disposes of a universal procedure pointer (UPP) to a bitmap callback.

InvokeCMBitmapCallBackUPP

Invokes a universal procedure pointer (UPP) to a bitmap callback.

NewCMConcatCallBackUPP

Creates a new universal procedure pointer (UPP) to a progress-monitoring callback.

DisposeCMConcatCallBackUPP

Disposes of a universal procedure pointer (UPP) to a progress-monitoring callback.

InvokeCMConcatCallBackUPP

Invokes a universal procedure pointer (UPP) to a progress-monitoring callback.

NewCMFlattenUPP

Creates a new universal procedure pointer (UPP) to a data-flattening callback.

DisposeCMFlattenUPP

Disposes of a universal procedure pointer (UPP) to a data-flattening callback.

InvokeCMFlattenUPP

Invokes a universal procedure pointer (UPP) to a data-flattening callback.

NewCMMIterateUPP

Creates a new universal procedure pointer (UPP) to a progress-monitoring callback for the CMIterateCMMInfo function.

DisposeCMMIterateUPP

Disposes of a universal procedure pointer (UPP) to a progress-monitoring callback for the CMIterateCMMInfo function.

InvokeCMMIterateUPP

Invokes a universal procedure pointer (UPP) to a progress-monitoring callback for the CMIterateCMMInfo function.

NewCMProfileAccessUPP

Creates a new universal procedure pointer (UPP) to a profile-access callback.

DisposeCMProfileAccessUPP

Disposes of a universal procedure pointer (UPP) to a profile-access callback.

InvokeCMProfileAccessUPP

Invokes a universal procedure pointer (UPP) to a profile-access callback.

NewCMProfileFilterUPP

Creates a new universal procedure pointer (UPP) to a profile-filter callback.

DisposeCMProfileFilterUPP

Disposes of a universal procedure pointer (UPP) to a profile-filter callback.

InvokeCMProfileFilterUPP

Invokes a universal procedure pointer (UPP) to a profile-filter callback.

NewCMProfileIterateUPP

Creates a new universal procedure pointer (UPP) to a profile-iteration callback.

DisposeCMProfileIterateUPP

Disposes of a universal procedure pointer (UPP) to a profile-iteration callback.

InvokeCMProfileIterateUPP

Invokes a universal procedure pointer (UPP) to a profile-iteration callback.

Not Recommended

CMNewProfileSearch

Searches the ColorSync Profiles folder and returns a list of 2.x profiles that match the search specification.

CMUpdateProfileSearch

Searches the ColorSync Profiles folder and updates an existing search result obtained originally from the CMNewProfileSearch function.

CMDisposeProfileSearch

Frees the private memory allocated for a profile search after your application has completed the search.

CMSearchGetIndProfile

Opens the profile corresponding to a specific index into a specific search result list and obtains a reference to that profile.

CMSearchGetIndProfileFileSpec

Obtains the file specification for the profile at a specific index into a search result.

CMCreateProfileIdentifier

Creates a profile identifier for a specified profile.

CMProfileIdentifierFolderSearch

Searches the ColorSync Profiles folder and returns a list of profile references, one for each profile that matches the specified profile identifier.

CMProfileIdentifierListSearch

Searches a list of profile references and returns a list of all references that match a specified profile identifier.

Callbacks

CMBitmapCallBackProcPtr

Defines a pointer to a bitmap callback function that function reports on the progress of a color-matching or color-checking session being performed for a bitmap or a pixel map.

Deprecated
CMConcatCallBackProcPtr

Defines a pointer to a progress-monitoring function that the ColorSync Manager calls during lengthy color world processing.

Deprecated
CMCountImageProfilesProcPtr

Defines a pointer to a function that obtains a count of the number of embedded profiles for a given image..

CMEmbedImageProcPtr

Defines a pointer to a function that embeds an image with an ICC profile..

CMFlattenProcPtr

Defines a pointer to a data transfer callback function that transfers profile data from the format for embedded profiles to disk file format or vice versa.

CMGetImageSpaceProcPtr

Defines a pointer to a function that obtains the signature of the data color space in which the color values of colors in an image are expressed.

CMGetIndImageProfileProcPtr

Defines a pointer to a function that obtains a specific embedded profile for a given image.

CMIterateDeviceInfoProcPtr

Defines a pointer to a function that iterates through device information available on the system.

Deprecated
CMIterateDeviceProfileProcPtr

Defines a pointer to a function that iterates through the device profiles available on the system.

Deprecated
CMLinkImageProcPtr

Defines a pointer to a function that matches an image file with a device link profile.

CMMatchImageProcPtr

Defines a pointer to a function that color matches an image file.

CMMIterateProcPtr

Defines a pointer to a function that iterates through color management modules installed on the system.

Deprecated
CMProofImageProcPtr

Defines a pointer to a function that proofs an image.

CMProfileIterateProcPtr

Defines a pointer to a profile iteration callback function that the ColorSync Manager calls for each found profile file as it iterates over the available profiles.

Deprecated
CMSetIndImageProfileProcPtr

Defines a pointer to a function that sets a specific embedded profile for a given image.

CMUnembedImageProcPtr

Defines a pointer to a function that umembeds an ICC profile from an image.

CMValidImageProcPtr

Defines a pointer to a function that validates a specified image file.

CountImageProfilesProcPtr

Defines a pointer to a function that counts the number of embedded profiles for a given image.

EmbedImageProcPtr

Defines a pointer to an embed-image function.

GetImageSpaceProcPtr

Defines a pointer to a get-image-space function.

GetIndImageProfileProcPtr

Defines a pointer to a function that obtains a color profile for an individual image..

MatchImageProcPtr

Defines a pointer to a match-image function.

SetIndImageProfileProcPtr

Defines a pointer to a function that sets a color profile for an individual image.

UnembedImageProcPtr

Defines a pointer to an umembed-image function.

ValidateImageProcPtr

Defines a pointer to a validate-image function.

ValidateSpaceProcPtr

Defines a pointer to a validate-space function.

Data Types

CM2Header

Contains information that supports the header format specified by the ICC format specification for version 2.x profiles.

Deprecated
CM4Header

Deprecated
CMAppleProfileHeader

Defines a data structure to provide access to both version 2.x and version 1.0 profiles, as specified by the International Color Consortium.

Deprecated
CMBitmap

Contains information that describes color bitmap images.

Deprecated
CMBitmapCallBackUPP

Defines a universal procedure pointer to a bitmap callback.

Deprecated
CMCMYColor

Contains color values expressed in the CMY color space.

Deprecated
CMCMYKColor

Contains color values expressed in the CMYK color space.

Deprecated
CMColor

Defines a union that can be used to specify a color value defined by one of the 15 data types supported by the union.

Deprecated
CMConcatCallBackUPP

Defines a universal procedure pointer to a progress-monitoring function that the ColorSync Manager calls during lengthy color world processing.

Deprecated
CMConcatProfileSet

Contains profile and other information needed to set up a color world.

Deprecated
CMCurveType

Deprecated
CMDataType

Deprecated
CMDateTime

Contains data that specifies a date and time in year, month, day of the month, hours, minutes, and seconds

Deprecated
CMDateTimeType

Deprecated
CMDeviceID

Defines a data type for a CM device ID.

Deprecated
CMDeviceState

Deprecated
CMDisplayIDType

Defines a data type for a display ID type.

Deprecated
CMError

Defines a data type for a ColorSync Manager result code.

CMFixedXYColor

Deprecated
CMFixedXYZColor

Contains data that specifies the profile illuminant in the profile header’s white field and other profile element values.

Deprecated
CMFlattenUPP

Defines a universal procedure pointer to a data-flattening callback.

CMGrayColor

Contains a color value expressed in the gray color space.

Deprecated
CMHandleLocation

Contains a handle specification for a profile stored in relocatable memory.

Deprecated
CMHLSColor

Contains a color value expressed in the HLS color space.

Deprecated
CMHSVColor

Contains a color value expressed in the HSV color space.

Deprecated
CMIntentCRDVMSize

Defines the rendering intent and its maximum VM size.

Deprecated
CMLabColor

Contains a color value expressed in the L*a*b* color space.

Deprecated
CMLut16Type

Deprecated
CMLut8Type

Deprecated
CMLuvColor

Contains a color value expressed in the L*u*v* color space.

Deprecated
CMMakeAndModel

Contains make and model information fro a device.

Deprecated
CMMakeAndModelType

Contains make and model information along with a type descriptor.

Deprecated
CMMeasurementType

Contains measurement type information.

Deprecated
CMMInfo

Contains information pertaining to a color management module.

Deprecated
CMMIterateUPP

Defines a universal procedure pointer to a CMM iteration callback.

Deprecated
CMMultichannel5Color

Contains a color value expressed in the multichannel color space with 5 channels.

Deprecated
CMMultichannel6Color

Contains a color expressed in the multichannel color space with 6 channels.

Deprecated
CMMultichannel7Color

Contains a color value expressed in the multichannel color space with 7 channels.

Deprecated
CMMultichannel8Color

Contains a color value expressed in the multichannel color space with 8 channels

Deprecated
CMNamedColor

Contains a color value expressed in a named color space.

Deprecated
CMNativeDisplayInfo

Contains color information for a native display.

Deprecated
CMNativeDisplayInfoType

Contains color information and a type descriptor for a native display.

Deprecated
CMPathLocation

Contains path information.

Deprecated
CMProfileIterateData

Contains a callback routine with a description of a profile that is during an iteration through the available profiles.

Deprecated
CMProfileIterateUPP

Defines a universal procedure pointer to a profile iteration callback.

Deprecated
CMProfileLocation

Contains profile location information.

Deprecated
CMProfileMD5

Defines a data type for an MD5 digest.

Deprecated
CMProfileName

Contains profile name and length.

CMProfileNamePtr

Defines a pointer to a profile name data structure.

CMProfileRef

Defines a reference to an opaque data type that specifies profile information.

Deprecated
CMProfLoc

Defines a union that identifies the location of a profile.

Deprecated
CMPS2CRDVMSizeType

Defines the Apple-defined 'psvm' optional tag.

Deprecated
CMRGBColor

Contains a color value expressed in the RGB color space.

Deprecated
CMScreeningType

Deprecated
CMSignatureType

Deprecated
CMTagElemTable

Deprecated
CMTagRecord

Deprecated
CMTextType

Deprecated
CMUcrBgType

Deprecated
CMVideoCardGamma

Contains video gamma data to store with a video gamma profile tag.

Deprecated
CMVideoCardGammaType

Specifies a video card gamma profile tag.

Deprecated
CMWorldRef

Defines an opaque data type used for color-matching and color-checking sessions.

Deprecated
CMXYZColor

Contains values for a color specified in XYZ color space.

CMXYZType

Deprecated
CMYxyColor

Contains values for a color expressed in the Yxy color space.

Deprecated

Constants

Abstract Color Space Constants

Specify values that represent general color spaces.

Channel Encoding Format

Specify an encoding format for sRGB64.

CMChromaticAdaptation

Specify a transformation to use for chromaric adaptation.

Deprecated
CMM Function Selectors

Define selectors used for component-based CMM functions.

Color Management Module Component Interface

Specify a CMM interface version.

Color Packing for Color Spaces

Specify how color values are stored.

CMBitmapColorSpace

Specifies bitmap spaces with a wide range of data formats appropriate for multiple platforms.

Deprecated
Color Space Signatures

Define four-character-sequences associated with color spaces.

Color Space Masks

Specify masks used for color spaces.

Current Device Versions

Specify the current versions of the data structure containing information on registered devices.

Current Info Versions

Specify current device and profile versions.

Current Major Version Mask

Specifies the current major version number.

Data Transfer Commands

Specify commands for caller-supplied ColorSync data transfer functions.

Data Type Element Values

Specify a data type.

Default CMM Signature

Specifies a signature for the default color management module supplied by Color Sync.

Default IDs

Specify default values for device and profile IDs.

Device Attribute Values for Version 2.x Profiles

Define masks your application can use to set or test bits in the deviceAttributes field of the CM2Header structure.

CMDeviceClass

Define constants to represent a variety of input and output devices.

Device and Media Attributes

Used to set or obtain device or media attributes.

Device States

Specify device states.

Element Tags and Signatures for Version 1.0 Profiles

Define tags and signatures used for version 1.0 profiles.

Embedded Profile Flags

Specify copyright-protection flag options,

Flag Mask Definitions for Version 2.x Profiles

Define masks your application can use to set or test various bits in the flags field of the CM2Header structure.

ICC Profile Versions

Specify IDD profile version numbers.

Illuminant Measurement Endocings

Specify standard illuminate measurement encodings.

Macintosh 68K Trap Word

Specifies a 68K trap word for the Macintosh.

Magic Cookie Number

Specifies a magic cookie number for anonymous file ID.

Maximum Path Size

Specifies the maximum length for a path name.

Measurement Flares

Specify measurement flare encodings.

Measurement Geometries

Specify measurement geometry encodings.

Parametric Types

Specify a parametric curve type enumeration,

Platform Enumeration Values

Specify computer platforms.

Profile Iteration Values

Specify profiles to iterate.

Profile Location Sizes

Specify a location size.

PostScript Data Formats

Specify constants that indicate the format of PostScript data.

Profile Access Procedures

Specify operations used to access profiles.

Profile Classes

Specify profile class enumerations.

Profile Concatenation Values

Specify values to use when concatenating profiles.

Profile Iteration Constants

Define an iteration version.

Profile Location Type

Defines profile location kinds.

Public Tags

Specify tag values available for public use.

Public Type Signatures

Specify signatures for public types.

Quality Flag Values for Version 2.x Profiles

Define the possible values for the quality bits in the flags field of the CM2Header structure.

Rendering Intent Values for Version 2.x Profiles

Define the four possible values for the rendering intent bits of the renderingIntent field of the CM2Header structure.

Screen Encoding Tags

Specify tags to use for screen encodings.

Spot Function Values

Specify values for spot functions.

Standard Observer

Standard observer measurement type encodings.

Tag Type Information

Defines a constant for 2.0 tag type information.

Technology Tag Descriptions

Define descriptor tags for technologies.

Use Types

Specify use types.

Video Card Gamma Storage Types

Specify data storage type constants.

Video Card Gamma Tags

Specify video card gamma information.

Video Card Gamma Signatures

Specify signatures used for video card gamma information.

Result Codes

The most common result codes returned by ColorSync Manager are listed below.

cmProfileError

There is something wrong with the content of the profile

cmMethodError

An error occurred during the CMM arbitration process that determines the CMM to use

cmMethodNotFound

CMM not present

cmProfileNotFound

Responder error

cmProfilesIdentical

Profiles are the same

cmCantConcatenateError

Profiles cannot be concatenated

cmCantXYZ

CMM does not handle XYZ color space

cmCantDeleteProfile

Responder error

cmUnsupportedDataType

Responder error

cmNoCurrentProfile

Responder error

cmElementTagNotFound

The tag you specified is not in the specified profile

cmIndexRangeErr

Tag index out of range

cmCantDeleteElement

Cannot delete the specified profile element

cmFatalProfileErr

Returned from File Manager while updating a profile file in response to CMUpdateProfile; profile content may be corrupted

cmInvalidProfile

Profile reference is invalid or refers to an inappropriate profile

cmInvalidProfileLocation

Operation not supported for this profile location

cmInvalidSearch

Bad search handle

cmSearchError

Internal error occurred during profile search

cmErrIncompatibleProfile

Unspecified profile error

cmInvalidColorSpace

Profile color space does not match bitmap type

cmInvalidSrcMap

Source pixel map or bitmap was invalid

cmInvalidDstMap

Destination pix/bit map was invalid

cmNoGDevicesError

Begin matching or end matching—no graphics devices available

cmInvalidProfileComment

Bad profile comment during drawpicture

cmRangeOverFlow

One or more output color value overflows in color conversion; all input color values will be converted and the overflow will be clipped

cmCantCopyModifiedV1Profile

It is illegal to copy version 1.0 profiles that have been modified

cmNamedColorNotFound

The specified named color was not found in the specified profile

cmCantGamutCheckError

Gamut checking not supported by this color world—that is, the color world does not contain a gamut table because it was built with gamut checking turned off

cmDeviceDBNotFoundErr

Preferences not found or loaded; returned by a CM device integration routine.

cmDeviceAlreadyRegistered

Device already registered; returned by a CM device integration routine.

cmDeviceNotRegistered

Device not found; returned by a CM device integration routine.

cmDeviceProfilesNotFound

Profiles not found; returned by a CM device integration routine.

cmInternalCFErr

CoreFoundation failure; returned by a CM device integration routine.