icm.h header
This header is used by multiple technologies. For more information, see:
icm.h contains the following programming interfaces:
Functions
| 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. |
Callback functions
| 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. |
Structures
| 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) |
Enumerations
| 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. |