icm.h header
This header is used by multiple technologies. For more information, see:
icm.h contains the following programming interfaces:
AssociateColorProfileWithDeviceA Associates a specified color profile with a specified device. (ANSI) |
AssociateColorProfileWithDeviceW Associates a specified color profile with a specified device. (Unicode) |
CheckBitmapBits Checks whether the pixels in a specified bitmap lie within the output gamut of a specified transform. |
CheckColors Determines whether the colors in an array lie within the output gamut of a specified transform. |
CloseColorProfile Closes an open profile handle. |
CMCheckColors Determines whether given colors lie within the output gamut of a specified transform. |
CMCheckColorsInGamut Determines whether specified RGB triples lie in the output gamut of a specified transform. |
CMCheckRGBs Checks bitmap colors against an output gamut. |
CMConvertColorNameToIndex Converts color names in a named color space to index numbers in a color profile. |
CMConvertIndexToColorName Transforms indices in a color space to an array of names in a named color space. (CMConvertIndexToColorName) |
CMCreateDeviceLinkProfile Creates a device link profile in the format specified by the International Color Consortium in its ICC Profile Format Specification. |
CMCreateMultiProfileTransform Accepts an array of profiles or a single device link profile and creates a color transform. This transform is a mapping from the color space specified by the first profile to that of the second profile and so on to the last one. |
CMCreateProfile Creates a display color profile from a LOGCOLORSPACEA structure. |
CMCreateProfileW Creates a display color profile from a LOGCOLORSPACEW structure. |
CMCreateTransform Deprecated. There is no replacement API because this one was no longer being used. Developers of alternate CMM modules are not required to implement it. (CMCreateTransform) |
CMCreateTransformExt Creates a color transform that maps from an input LOGCOLORSPACEA to an optional target space and then to an output device, using a set of flags that define how the transform should be created. |
CMCreateTransformExtW Creates a color transform that maps from an input LOGCOLORSPACEW to an optional target space and then to an output device, using a set of flags that define how the transform should be created. |
CMCreateTransformW Deprecated. There is no replacement API because this one was no longer being used. Developers of alternate CMM modules are not required to implement it. (CMCreateTransformW) |
CMDeleteTransform Deletes a specified color transform, and frees any memory associated with it. |
CMGetInfo Retrieves various information about the color management module (CMM). |
CMGetNamedProfileInfo Retrieves information about the specified named color profile. |
CMGetPS2ColorRenderingDictionary CMGetPS2ColorRenderingDictionary and the additional parameters associated with it are to be determined. |
CMGetPS2ColorRenderingIntent Retrieves the PostScript Level 2 color rendering intent from a profile. |
CMGetPS2ColorSpaceArray CMGetPS2ColorSpaceArray and the parameters, returns, and remarks associated with it are to be determined. |
CMIsProfileValid Reports whether the given profile is a valid ICC profile that can be used for color management. |
CMTranslateColors Translates an array of colors from a source color space to a destination color space using a color transform. |
CMTranslateRGB Translates an application-supplied RGBQuad into the device color space. |
CMTranslateRGBs Translates a bitmap from one color space to another using a color transform. |
CMTranslateRGBsExt Translates a bitmap from one defined format into a different defined format and calls a callback function periodically, if one is specified, to report progress and permit the calling application to terminate the translation. |
ColorProfileAddDisplayAssociation ColorProfileAddDisplayAssociation associates an installed color profile with a specified display in the given scope. |
ColorProfileGetDisplayDefault ColorProfileGetDisplayDefault gets the default color profile for a given display in the specified scope. |
ColorProfileGetDisplayList ColorProfileGetDisplayList retrieves the list of profiles associated with a given display in the specified scope. |
ColorProfileGetDisplayUserScope ColorProfileGetDisplayUserScope gets the currently selected color profile scope of the provided display - either user or system. |
ColorProfileRemoveDisplayAssociation ColorProfileRemoveDisplayAssociation disassociates an installed color profile from a specified display in the given scope. |
ColorProfileSetDisplayDefaultAssociation ColorProfileSetDisplayDefaultAssociation sets an installed color profile as the default profile for a specified display in the given scope. |
ConvertColorNameToIndex Converts color names in a named color space to index numbers in an International Color Consortium (ICC) color profile. |
ConvertIndexToColorName Transforms indices in a color space to an array of names in a named color space. (ConvertIndexToColorName) |
CreateColorTransformA Creates a color transform that applications can use to perform color management. (ANSI) |
CreateColorTransformW Creates a color transform that applications can use to perform color management. (Unicode) |
CreateDeviceLinkProfile Creates an International Color Consortium (ICC) device link profile from a set of color profiles, using the specified intents. |
CreateMultiProfileTransform Accepts an array of profiles or a single device link profile and creates a color transform that applications can use to perform color mapping. |
CreateProfileFromLogColorSpaceA Converts a logical color space to a device profile. (ANSI) |
CreateProfileFromLogColorSpaceW Converts a logical color space to a device profile. (Unicode) |
DeleteColorTransform Deletes a given color transform. |
DisassociateColorProfileFromDeviceA Disassociates a specified color profile with a specified device on a specified computer. (ANSI) |
DisassociateColorProfileFromDeviceW Disassociates a specified color profile with a specified device on a specified computer. (Unicode) |
EnumColorProfilesA Enumerates all the profiles satisfying the given enumeration criteria. (ANSI) |
EnumColorProfilesW Enumerates all the profiles satisfying the given enumeration criteria. (Unicode) |
GetCMMInfo Retrieves various information about the color management module (CMM) that created the specified color transform. |
GetColorDirectoryA Retrieves the path of the Windows COLOR directory on a specified machine. (ANSI) |
GetColorDirectoryW Retrieves the path of the Windows COLOR directory on a specified machine. (Unicode) |
GetColorProfileElement Copies data from a specified tagged profile element of a specified color profile into a buffer. |
GetColorProfileElementTag Retrieves the tag name specified by dwIndex in the tag table of a given International Color Consortium (ICC) color profile, where dwIndex is a one-based index into that table. |
GetColorProfileFromHandle Given a handle to an open color profile, the GetColorProfileFromHandle function copies the contents of the profile into a buffer supplied by the application. If the handle is a Windows Color System (WCS) handle, then the DMP is returned and the CAMP and GMMP associated with the HPROFILE are ignored. |
GetColorProfileHeader Retrieves or derives ICC header structure from either ICC color profile or WCS XML profile. Drivers and applications should assume returning TRUE only indicates that a properly structured header is returned. Each tag will still need to be validated independently using either legacy ICM2 APIs or XML schema APIs. |
GetCountColorProfileElements Retrieves the number of tagged elements in a given color profile. |
GetNamedProfileInfo Retrieves information about the International Color Consortium (ICC) named color profile that is specified in the first parameter. |
GetPS2ColorRenderingDictionary Retrieves the PostScript Level 2 color rendering dictionary from the specified ICC color profile. |
GetPS2ColorRenderingIntent Retrieves the PostScript Level 2 color rendering intent from an ICC color profile. |
GetPS2ColorSpaceArray Retrieves the PostScript Level 2 color space array from an ICC color profile. |
GetStandardColorSpaceProfileA Retrieves the color profile registered for the specified standard color space. (ANSI) |
GetStandardColorSpaceProfileW Retrieves the color profile registered for the specified standard color space. (Unicode) |
InstallColorProfileA Installs a given profile for use on a specified machine. The profile is also copied to the COLOR directory. (ANSI) |
InstallColorProfileW Installs a given profile for use on a specified machine. The profile is also copied to the COLOR directory. (Unicode) |
IsColorProfileTagPresent Reports whether a specified International Color Consortium (ICC) tag is present in the specified color profile. |
IsColorProfileValid Allows you to determine whether the specified profile is a valid International Color Consortium (ICC) profile, or a valid Windows Color System (WCS) profile handle that can be used for color management. |
OpenColorProfileA Creates a handle to a specified color profile. The handle can then be used in other profile management functions. (ANSI) |
OpenColorProfileW Creates a handle to a specified color profile. The handle can then be used in other profile management functions. (Unicode) |
RegisterCMMA Associates a specified identification value with the specified color management module dynamic link library (CMM DLL). When this ID appears in a color profile, Windows can then locate the corresponding CMM so as to create a transform. (ANSI) |
RegisterCMMW Associates a specified identification value with the specified color management module dynamic link library (CMM DLL). When this ID appears in a color profile, Windows can then locate the corresponding CMM so as to create a transform. (Unicode) |
SelectCMM Allows you to select the preferred color management module (CMM) to use. |
SetColorProfileElement Sets the element data for a tagged profile element in an ICC color profile. |
SetColorProfileElementReference Creates in a specified ICC color profile a new tag that references the same data as an existing tag. |
SetColorProfileElementSize Sets the size of a tagged element in an ICC color profile. |
SetColorProfileHeader Sets the header data in a specified ICC color profile. |
SetStandardColorSpaceProfileA Registers a specified profile for a given standard color space. The profile can be queried using GetStandardColorSpaceProfileW. (ANSI) |
SetStandardColorSpaceProfileW Registers a specified profile for a given standard color space. The profile can be queried using GetStandardColorSpaceProfileW. (Unicode) |
SetupColorMatchingA Creates a Color Management dialog box that lets the user choose whether to enable color management and, if so, provides control over the color profiles used and over the rendering intent. (ANSI) |
SetupColorMatchingW Creates a Color Management dialog box that lets the user choose whether to enable color management and, if so, provides control over the color profiles used and over the rendering intent. (Unicode) |
TranslateBitmapBits Translates the colors of a bitmap having a defined format so as to produce another bitmap in a requested format. |
TranslateColors Translates an array of colors from the source color space to the destination color space as defined by a color transform. |
UninstallColorProfileA Removes a specified color profile from a specified computer. Associated files are optionally deleted from the system. (ANSI) |
UninstallColorProfileW Removes a specified color profile from a specified computer. Associated files are optionally deleted from the system. (Unicode) |
UnregisterCMMA Dissociates a specified ID value from a given color management module dynamic-link library (CMM DLL). (ANSI) |
UnregisterCMMW Dissociates a specified ID value from a given color management module dynamic-link library (CMM DLL). (Unicode) |
WcsAssociateColorProfileWithDevice WcsAssociateColorProfileWithDevice associates a specified WCS color profile with a specified device. |
WcsCheckColors Determines whether the colors in an array are within the output gamut of a specified WCS color transform. |
WcsCreateIccProfile Converts a WCS profile into an International Color Consortium (ICC) profile. |
WcsDisassociateColorProfileFromDevice Disassociates a specified WCS color profile from a specified device on a computer. |
WcsEnumColorProfiles Enumerates all color profiles that satisfy the enumeration criteria in the specified profile management scope. |
WcsEnumColorProfilesSize Returns the size, in bytes, of the buffer that is required by the WcsEnumColorProfiles function to enumerate color profiles. |
WcsGetCalibrationManagementState Determines whether system management of the display calibration state is enabled. |
WcsGetDefaultColorProfile Retrieves the default color profile for a device, or for a device-independent default if the device is not specified. |
WcsGetDefaultColorProfileSize Returns the size, in bytes, of the default color profile name (including the NULL terminator), for a device. |
WcsGetDefaultRenderingIntent Retrieves the default rendering intent in the specified profile management scope. |
WcsGetUsePerUserProfiles Determines whether the user chose to use a per-user profile association list for the specified device. |
WcsOpenColorProfileA Creates a handle to a specified color profile. (ANSI) |
WcsOpenColorProfileW Creates a handle to a specified color profile. (Unicode) |
WcsSetCalibrationManagementState Enables or disables system management of the display calibration state. |
WcsSetDefaultColorProfile Sets the default color profile name for the specified profile type in the specified profile management scope. |
WcsSetDefaultRenderingIntent Sets the default rendering intent in the specified profile management scope. |
WcsSetUsePerUserProfiles Enables a user to specify whether or not to use a per-user profile association list for the specified device. |
WcsTranslateColors Translates an array of colors from the source color space to the destination color space as defined by a color transform. |
PBMCALLBACKFN TBD (PBMCALLBACKFN) |
PCMSCALLBACKA *PCMSCALLBACKA* (or ApplyCallbackFunction) is a callback function that you implement that updates the WCS configuration data while the dialog box displayed by the SetupColorMatchingW function is executing. |
PCMSCALLBACKW *PCMSCALLBACKW* (or ApplyCallbackFunction) is a callback function that you implement that updates the WCS configuration data while the dialog box displayed by the SetupColorMatchingW function is executing. |
CMYKCOLOR Description of the CMYKCOLOR structure. |
COLOR Description of the COLOR union. |
COLORMATCHSETUPA The COLORMATCHSETUP structure contains information that the SetupColorMatchingW function uses to initialize the ColorManagement dialog box. (ANSI) |
COLORMATCHSETUPW The COLORMATCHSETUP structure contains information that the SetupColorMatchingW function uses to initialize the ColorManagement dialog box. (Unicode) |
ENUMTYPEA Contains information that defines the profile enumeration constraints. (ANSI) |
ENUMTYPEW Contains information that defines the profile enumeration constraints. (Unicode) |
GENERIC3CHANNEL TBD (GENERIC3CHANNEL) |
GRAYCOLOR Description of the GRAYCOLOR structure. |
HiFiCOLOR Description of the HiFiCOLOR structure. |
LabCOLOR TBD (LabCOLOR) |
NAMED_PROFILE_INFO The NAMED_PROFILE_INFO structure is used to store information about a named color profile. |
NAMEDCOLOR TBD (NAMEDCOLOR) |
PROFILE Contains information that defines a color profile. |
PROFILEHEADER Contains information that describes the contents of a device profile file. This header occurs at the beginning of a device profile file. |
RGBCOLOR TBD (RGBCOLOR) |
XYZCOLOR TBD (XYZCOLOR) |
YxyCOLOR TBD (YxyCOLOR) |
BMFORMAT The values of the BMFORMAT enumerated type are used by several WCS functions to indicate the format that particular bitmaps are in. |
COLORDATATYPE Used by WCS functions to indicate the data type of vector content. |
COLORPROFILESUBTYPE Specifies the subtype of the color profile. |
COLORPROFILETYPE Specifies the type of color profile. |
COLORTYPE The values of the COLORTYPE enumeration are used by several WCS functions. Variables of type COLOR are defined in the color spaces enumerated by the COLORTYPE enumeration. |
WCS_PROFILE_MANAGEMENT_SCOPE Specifies the scope of a profile management operation, such as associating a profile with a device. |