Windows 颜色系统
Windows 颜色系统技术概述。
若要开发 Windows 颜色系统，需要以下标头：
有关此技术的编程指南，请参阅：
枚举
| BMFORMAT 多个 WCS 函数使用 BMFORMAT 枚举类型的值来指示特定位图的格式。 |
| COLORDATATYPE 由 WCS 函数用来指示向量内容的数据类型。 |
| COLORPROFILESUBTYPE 指定颜色配置文件的子类型。 |
| COLORPROFILETYPE 指定颜色配置文件的类型。 |
| COLORTYPE COLORTYPE 枚举的值由多个 WCS 函数使用。 COLOR 类型的变量在 COLORTYPE 枚举枚举的颜色空间中定义。 |
| WCS_PROFILE_MANAGEMENT_SCOPE 指定配置文件管理操作的范围，例如将配置文件与设备关联。 |
函数
| AssociateColorProfileWithDeviceA 将指定的颜色配置文件与指定的设备相关联。 (ANSI) |
| AssociateColorProfileWithDeviceW 将指定的颜色配置文件与指定的设备相关联。 (Unicode) |
| CheckBitmapBits 检查指定位图中的像素是否位于指定转换的输出 范围 内。 |
| CheckColors 确定数组中的颜色是否位于指定转换的输出 色域 内。 |
| CheckColorsInGamut CheckColorsInGamut 函数确定指定的 RGB 三元组是否位于指定设备的输出色域中。 RGB 三重在输入逻辑颜色空间中解释。 |
| CloseColorProfile 关闭打开的配置文件句柄。 |
| CMCheckColors 确定给定颜色是否位于指定转换的输出 色域 内。 |
| CMCheckColorsInGamut 确定指定的 RGB 三元是否位于指定转换的输出 色域 中。 |
| CMCheckRGBs 根据输出色域检查位图颜色。 |
| CMConvertColorNameToIndex 将命名颜色空间中的颜色名称转换为颜色配置文件中的索引号。 |
| CMConvertIndexToColorName 将颜色空间中的索引转换为命名颜色空间中的名称数组。 (CMConvertIndexToColorName) |
| CMCreateDeviceLinkProfile 使用国际颜色联盟在其 ICC 配置文件格式规范中指定的格式创建 设备链接 配置文件。 |
| CMCreateMultiProfileTransform 接受配置文件数组或单个 设备链接配置文件 ，并创建颜色转换。 此转换是从第一个配置文件指定的颜色空间到第二个配置文件的颜色空间的映射，依此类图到最后一个配置文件。 |
| CMCreateProfile 从 LOGCOLORSPACEA 结构创建显示颜色配置文件。 |
| CMCreateProfileW 从 LOGCOLORSPACEW 结构创建显示颜色配置文件。 |
| CMCreateTransform 已弃用。 没有替换 API，因为不再使用此 API。 替代 CMM 模块的开发人员无需实现它。 (CMCreateTransform) |
| CMCreateTransformExt 使用定义转换方式的一组标志创建颜色转换，该转换从输入 LOGCOLORSPACEA 映射到可选目标空间，然后映射到输出设备。 |
| CMCreateTransformExtW 使用一组定义如何创建转换的标志创建颜色转换，该转换从输入 LOGCOLORSPACEW 映射到可选目标空间，然后映射到输出设备。 |
| CMCreateTransformW 已弃用。 没有替换 API，因为不再使用此 API。 替代 CMM 模块的开发人员无需实现它。 (CMCreateTransformW) |
| CMDeleteTransform 删除指定的颜色转换，并释放与之关联的任何内存。 |
| CMGetInfo 检索有关颜色管理模块 (CMM) 的各种信息。 |
| CMGetNamedProfileInfo 检索有关指定命名颜色配置文件的信息。 |
| CMGetPS2ColorRenderingDictionary 要确定 CMGetPS2ColorRenderingDictionary 及其关联的其他参数。 |
| CMGetPS2ColorRenderingIntent 从配置文件中检索 PostScript 级别 2 颜色 呈现意向 。 |
| CMGetPS2ColorSpaceArray 要确定 CMGetPS2ColorSpaceArray 及其关联的参数、返回和备注。 |
| CMIsProfileValid 报告给定配置文件是否是可用于颜色管理的有效 ICC 配置文件。 |
| CMTranslateColors 使用颜色转换将颜色数组从源 颜色空间 转换为目标颜色空间。 |
| CMTranslateRGB 将应用程序提供的 RGBQuad 转换为设备 颜色空间。 |
| CMTranslateRGBs 使用颜色转换将位图从一个 颜色空间 转换为另一个颜色空间。 |
| CMTranslateRGBsExt 将位图从一种定义的格式转换为不同的已定义格式，并定期调用回调函数（如果指定了回调函数），以报告进度并允许调用应用程序终止转换。 |
| Cmyk CMYK 宏通过组合指定的青色、洋红色、黄色和黑色值来创建 CMYK 颜色值。 |
| ColorCorrectPalette ColorCorrectPalette 函数在指定的设备上下文中使用 WCS 1.0 参数更正调色板的条目。 |
| ColorimetricToDeviceColors 返回相应的 XYZ 颜色，以响应指定数量的颜色、通道、设备颜色和专有插件算法。 (IDeviceModelPlugIn.ColorimetricToDeviceColors) |
| ColorimetricToDeviceColorsWithBlack 返回相应的设备颜色，以响应传入的颜色、通道、黑色信息、国际委员会 l'Eclairge XYZ (CIEXYZ) 颜色和专有插件算法。 |
| ColorMatchToTarget 通过 ColorMatchToTarget 函数，可以预览颜色在目标设备上显示的颜色。 |
| ColorProfileAddDisplayAssociation ColorProfileAddDisplayAssociation 将已安装的颜色配置文件与给定范围内的指定显示相关联。 |
| ColorProfileGetDisplayDefault ColorProfileGetDisplayDefault 获取指定范围内给定显示器的默认颜色配置文件。 |
| ColorProfileGetDisplayList ColorProfileGetDisplayList 检索与指定范围内给定显示关联的配置文件列表。 |
| ColorProfileGetDisplayUserScope ColorProfileGetDisplayUserScope 获取所提供显示器的当前所选颜色配置文件范围 - 用户或系统。 |
| ColorProfileRemoveDisplayAssociation ColorProfileRemoveDisplayAssociation 从给定范围中的指定显示器取消关联已安装的颜色配置文件。 |
| ColorProfileSetDisplayDefaultAssociation ColorProfileSetDisplayDefaultAssociation 将已安装的颜色配置文件设置为给定范围内指定显示的默认配置文件。 |
| ConvertColorNameToIndex 将命名颜色空间中的颜色名称转换为国际颜色联盟 (ICC) 颜色配置文件中的索引号。 |
| ConvertIndexToColorName 将颜色空间中的索引转换为命名颜色空间中的名称数组。 (ConvertIndexToColorName) |
| CreateColorSpaceA CreateColorSpace 函数创建逻辑颜色空间。 (ANSI) |
| CreateColorSpaceW CreateColorSpace 函数创建逻辑颜色空间。 (Unicode) |
| CreateColorTransformA 创建应用程序可用于执行颜色管理的颜色转换。 (ANSI) |
| CreateColorTransformW 创建应用程序可用于执行颜色管理的颜色转换。 (Unicode) |
| CreateDeviceLinkProfile 使用指定的意向从一组颜色配置文件创建国际颜色联盟 (ICC) 设备链接配置文件 。 |
| CreateMultiProfileTransform 接受配置文件数组或单个 设备链接配置文件 ，并创建应用程序可用于执行颜色映射的颜色转换。 |
| CreateProfileFromLogColorSpaceA 将逻辑 颜色空间 转换为 设备配置文件。 (ANSI) |
| CreateProfileFromLogColorSpaceW 将逻辑 颜色空间 转换为 设备配置文件。 (Unicode) |
| DeleteColorSpace DeleteColorSpace 函数删除并销毁指定的颜色空间。 |
| DeleteColorTransform 删除给定的颜色转换。 |
| DeviceToColorimetricColors 返回相应的 XYZ 颜色，以响应指定数量的颜色、通道、设备颜色和专有插件算法。 (IDeviceModelPlugIn.DeviceToColorimetricColors) |
| DisassociateColorProfileFromDeviceA 取消将指定颜色配置文件与指定计算机上的指定设备关联。 (ANSI) |
| DisassociateColorProfileFromDeviceW 取消将指定颜色配置文件与指定计算机上的指定设备关联。 (Unicode) |
| EnumColorProfilesA 枚举满足给定枚举条件的所有配置文件。 (ANSI) |
| EnumColorProfilesW 枚举满足给定枚举条件的所有配置文件。 (Unicode) |
| EnumICMProfilesA EnumICMProfiles 函数枚举系统为给定设备上下文支持的不同输出颜色配置文件。 (ANSI) |
| EnumICMProfilesW EnumICMProfiles 函数枚举系统为给定设备上下文支持的不同输出颜色配置文件。 (Unicode) |
| GetCMMInfo 检索有关创建指定颜色转换 (CMM) 的颜色管理模块的各种信息。 |
| GetColorDirectoryA 检索指定计算机上的 Windows COLOR 目录的路径。 (ANSI) |
| GetColorDirectoryW 检索指定计算机上的 Windows COLOR 目录的路径。 (Unicode) |
| GetColorProfileElement 将数据从指定颜色配置文件的指定标记配置文件元素复制到缓冲区中。 |
| GetColorProfileElementTag 检索给定国际颜色联盟的标记表中 dwIndex 指定的标记名称， (ICC) 颜色配置文件，其中 dwIndex 是该表中的一个从 1 开始的索引。 |
| GetColorProfileFromHandle 给定打开颜色配置文件的句柄， GetColorProfileFromHandle 函数会将配置文件的内容复制到应用程序提供的缓冲区中。 如果句柄是 Windows 颜色系统 (WCS) 句柄，则返回 DMP，并忽略与 HPROFILE 关联的 CAMP 和 GMMP。 |
| GetColorProfileHeader 从 ICC 颜色配置文件或 WCS XML 配置文件检索或派生 ICC 标头结构。 驱动程序和应用程序应假定返回 TRUE 仅指示返回结构正确的标头。 仍需使用旧版 ICM2 API 或 XML 架构 API 独立验证每个标记。 |
| GetColorSpace GetColorSpace 函数从指定的设备上下文检索输入颜色空间的句柄。 |
| GetCountColorProfileElements 检索给定颜色配置文件中标记的元素数。 |
| GetCValue GetCValue 宏从 CMYK 颜色值检索青色值。 |
| GetDeviceGammaRamp GetDeviceGammaRamp 函数在具有支持硬件中可下载伽玛渐变的驱动程序的直接彩色显示板上获取伽玛渐变。 |
| GetGamutBoundaryMesh 从插件返回三角形网格。 此函数用于计算 GamutBoundaryDescription。 |
| GetGamutBoundaryMeshSize 返回 GetGamutBoundaryMesh 函数所需的数据结构大小。 |
| GetICMProfileA GetICMProfile 函数检索指定设备上下文的当前输出颜色配置文件的文件名。 (ANSI) |
| GetICMProfileW GetICMProfile 函数检索指定设备上下文的当前输出颜色配置文件的文件名。 (Unicode) |
| GetKValue GetKValue 宏从 CMYK 颜色值检索黑色值。 |
| GetLogColorSpaceA GetLogColorSpace 函数检索由指定句柄标识的颜色空间定义。 (ANSI) |
| GetLogColorSpaceW GetLogColorSpace 函数检索由指定句柄标识的颜色空间定义。 (Unicode) |
| GetMValue GetMValue 宏从 CMYK 颜色值检索洋红色值。 |
| GetNamedProfileInfo 检索有关国际颜色联盟 (ICC) 在第一个参数中指定的命名颜色配置文件的信息。 |
| GetNeutralAxis IDeviceModelPlugIn：：GetNeutralAxis 沿设备的中性轴返回样本点的 XYZ 色度法。 |
| GetNeutralAxisSize IDeviceModelPlugIn：：GetNeutralAxisSize 函数返回 GetNeutralAxis 函数沿中性轴返回的数据点数。 |
| GetNumChannels 返回参数 pNumChannels 中的设备通道数。 |
| GetPrimarySamples 返回主要样本的度量颜色。 |
| GetPS2ColorRenderingDictionary 从指定的 ICC 颜色配置文件中检索 PostScript 级别 2 颜色呈现字典。 |
| GetPS2ColorRenderingIntent 从 ICC 颜色配置文件中检索 PostScript 级别 2 颜色 呈现意向 。 |
| GetPS2ColorSpaceArray 从 ICC 颜色配置文件中检索 PostScript 级别 2 颜色 空间 数组。 |
| GetStandardColorSpaceProfileA 检索为指定标准 颜色空间注册的颜色配置文件。 (ANSI) |
| GetStandardColorSpaceProfileW 检索为指定标准 颜色空间注册的颜色配置文件。 (Unicode) |
| GetYValue GetYValue 宏从 CMYK 颜色值检索黄色值。 |
| ICMENUMPROCA EnumICMProfilesProcCallback 回调是应用程序定义的回调函数，用于处理 EnumICMProfiles 中的颜色配置文件数据。 (ANSI) |
| ICMENUMPROCW EnumICMProfilesProcCallback 回调是应用程序定义的回调函数，用于处理 EnumICMProfiles 中的颜色配置文件数据。 (Unicode) |
| 初始化 将指向包含整个设备模型插件的 Stream 的指针作为输入，并初始化插件所需的任何内部参数。 |
| 初始化 通过使用指定的源和目标范围边界说明以及可选的源和目标设备模型插件， (GMMP) 初始化范围映射模型配置文件。 |
| InstallColorProfileA 安装给定的配置文件，以便在指定的计算机上使用。 配置文件也会复制到 COLOR 目录。 (ANSI) |
| InstallColorProfileW 安装给定的配置文件，以便在指定的计算机上使用。 配置文件也会复制到 COLOR 目录。 (Unicode) |
| IsColorProfileTagPresent 报告指定的颜色配置文件中是否存在指定的国际颜色联盟 (ICC) 标记。 |
| IsColorProfileValid 允许确定指定的配置文件是有效的国际颜色联盟 (ICC) 配置文件，还是可用于颜色管理的 Windows 颜色系统 (WCS) 配置文件句柄。 |
| OpenColorProfileA 创建指定颜色配置文件的句柄。 然后，可以在其他配置文件管理功能中使用句柄。 (ANSI) |
| OpenColorProfileW 创建指定颜色配置文件的句柄。 然后，可以在其他配置文件管理功能中使用句柄。 (Unicode) |
| PBMCALLBACKFN TBD (PBMCALLBACKFN) |
| PCMSCALLBACKA *PCMSCALLBACKA* (或 ApplyCallbackFunction) 是一个回调函数，在 SetupColorMatchingW 函数显示的对话框正在执行时，该回调函数将更新 WCS 配置数据。 |
| PCMSCALLBACKW *PCMSCALLBACKW* (或 ApplyCallbackFunction) 是你实现的回调函数，可在 SetupColorMatchingW 函数显示的对话框执行时更新 WCS 配置数据。 |
| RegisterCMMA 将指定的标识值与指定的颜色管理模块动态链接库相关联， (CMM DLL) 。 当此 ID 出现在颜色配置文件中时，Windows 随后可以找到相应的 CMM 以创建转换。 (ANSI) |
| RegisterCMMW 将指定的标识值与指定的颜色管理模块动态链接库相关联， (CMM DLL) 。 当此 ID 出现在颜色配置文件中时，Windows 随后可以找到相应的 CMM 以创建转换。 (Unicode) |
| SelectCMM 允许选择要使用的颜色管理模块 (CMM) 。 |
| SetColorProfileElement 设置 ICC 颜色配置文件中标记的配置文件元素的元素数据。 |
| SetColorProfileElementReference 在指定的 ICC 颜色配置文件中创建一个新标记，该标记引用与现有标记相同的数据。 |
| SetColorProfileElementSize 设置 ICC 颜色配置文件中标记元素的大小。 |
| SetColorProfileHeader 在指定的 ICC 颜色配置文件中设置标头数据。 |
| SetColorSpace SetColorSpace 函数定义给定设备上下文的输入颜色空间。 |
| SetDeviceGammaRamp SetDeviceGammaRamp 函数在具有支持硬件中可下载伽玛渐变的驱动程序的直接彩色显示板上设置伽玛渐变。 |
| SetICMMode SetICMMode 函数会导致在给定设备上下文 (DC) 上启用、禁用或查询图像颜色管理。 |
| SetICMProfileA SetICMProfile 函数将指定的颜色配置文件设置为指定设备上下文 (DC) 的输出配置文件。 (ANSI) |
| SetICMProfileW SetICMProfile 函数将指定的颜色配置文件设置为指定设备上下文 (DC) 的输出配置文件。 (Unicode) |
| SetStandardColorSpaceProfileA 为给定的标准 颜色空间注册指定的配置文件。 可以使用 GetStandardColorSpaceProfileW 查询配置文件。 (ANSI) |
| SetStandardColorSpaceProfileW 为给定的标准 颜色空间注册指定的配置文件。 可以使用 GetStandardColorSpaceProfileW 查询配置文件。 (Unicode) |
| SetTransformDeviceModelInfo 为插件提供参数，以确定特定插件在转换序列中的哪个位置出现。 |
| SetupColorMatchingA 创建一个“颜色管理”对话框，该对话框允许用户选择是否启用颜色管理，如果启用，则提供对所用颜色配置文件和 呈现意向的控制。 (ANSI) |
| SetupColorMatchingW 创建一个“颜色管理”对话框，该对话框允许用户选择是否启用颜色管理，如果启用，则提供对所用颜色配置文件和 呈现意向的控制。 (Unicode) |
| SourceToDestinationAppearanceColors 返回相应的色域映射外观颜色，以响应指定数量的颜色和 CIEJCh 颜色。 |
| TranslateBitmapBits 转换具有已定义格式的位图的颜色，以便以请求的格式生成另一个位图。 |
| TranslateColors 根据颜色转换的定义，将颜色数组从源 颜色空间 转换为目标颜色空间。 |
| UninstallColorProfileA 从指定的计算机中删除指定的颜色配置文件。 有选择地从系统中删除关联的文件。 (ANSI) |
| UninstallColorProfileW 从指定的计算机中删除指定的颜色配置文件。 有选择地从系统中删除关联的文件。 (Unicode) |
| UnregisterCMMA 将指定的 ID 值与给定的颜色管理模块动态链接库取消关联， (CMM DLL) 。 (ANSI) |
| UnregisterCMMW 将指定的 ID 值与给定的颜色管理模块动态链接库取消关联， (CMM DLL) 。 (Unicode) |
| UpdateICMRegKeyA UpdateICMRegKey 函数管理系统中的颜色配置文件和颜色管理模块。 (ANSI) |
| UpdateICMRegKeyW UpdateICMRegKey 函数管理系统中的颜色配置文件和颜色管理模块。 (Unicode) |
| WcsAssociateColorProfileWithDevice WcsAssociateColorProfileWithDevice 将指定的 WCS 颜色配置文件与指定的设备相关联。 |
| WcsCheckColors 确定数组中的颜色是否在指定 WCS 颜色转换的输出范围内。 |
| WcsCreateIccProfile 将 WCS 配置文件转换为国际颜色联盟 (ICC) 配置文件。 |
| WcsDisassociateColorProfileFromDevice 从计算机上的指定设备取消关联指定的 WCS 颜色配置文件。 |
| WcsEnumColorProfiles 枚举满足指定配置文件管理范围中枚举条件的所有颜色配置文件。 |
| WcsEnumColorProfilesSize 返回 WcsEnumColorProfiles 函数枚举颜色配置文件所需的缓冲区的大小（以字节为单位）。 |
| WcsGetCalibrationManagementState 确定是否启用显示器校准状态的系统管理。 |
| WcsGetDefaultColorProfile 检索设备的默认颜色配置文件，如果未指定设备，则检索与设备无关的默认颜色配置文件。 |
| WcsGetDefaultColorProfileSize 返回设备的默认颜色配置文件名称的大小（以字节为单位）， (包括 NULL 终止符) 。 |
| WcsGetDefaultRenderingIntent 检索指定配置文件管理范围中的默认呈现意向。 |
| WcsGetUsePerUserProfiles 确定用户是否选择对指定设备使用每用户配置文件关联列表。 |
| WcsOpenColorProfileA 创建指定颜色配置文件的句柄。 (ANSI) |
| WcsOpenColorProfileW 创建指定颜色配置文件的句柄。 (Unicode) |
| WcsSetCalibrationManagementState 启用或禁用显示校准状态的系统管理。 |
| WcsSetDefaultColorProfile 为指定的配置文件管理范围中的指定配置文件类型设置默认颜色配置文件名称。 |
| WcsSetDefaultRenderingIntent 在指定的配置文件管理范围内设置默认呈现意向。 |
| WcsSetUsePerUserProfiles 使用户能够指定是否对指定设备使用每用户配置文件关联列表。 |
| WcsTranslateColors 根据颜色转换的定义，将颜色数组从源颜色空间转换为目标颜色空间。 |
接口
| IDeviceModelPlugIn 介绍为 IDeviceModelPlugIn 组件对象模型 (COM) 接口定义的方法。 |
| IGamutMapModelPlugIn 介绍为 IGamutMapModelPlugIn 组件对象模型 (COM) 接口定义的方法。 |
结构
| BlackInformation 包含具有黑色通道的设备型号的信息。 |
| CIEXYZ CIEXYZ 结构包含指定颜色空间中特定颜色的 x、y 和 z 坐标。 |
| CIEXYZTRIPLE CIEXYZTRIPLE 结构包含与指定逻辑颜色空间的红色、绿色和蓝色端点对应的三种颜色的 x、y 和 z 坐标。 |
| CMYKCOLOR CMYKCOLOR 结构的说明。 |
| 颜色 COLOR 联合的说明。 |
| COLORMATCHSETUPA COLORMATCHSETUP 结构包含 SetupColorMatchingW 函数用于初始化 ColorManagement 对话框的信息。 (ANSI) |
| COLORMATCHSETUPW COLORMATCHSETUP 结构包含 SetupColorMatchingW 函数用于初始化 ColorManagement 对话框的信息。 (Unicode) |
| ENUMTYPEA 包含定义配置文件枚举约束的信息。 (ANSI) |
| ENUMTYPEW 包含定义配置文件枚举约束的信息。 (Unicode) |
| GamutBoundaryDescription 定义一个范围边界。 |
| GamutShell 包含定义由索引三角形列表表示的色域外壳的信息。 顶点缓冲区包含顶点数据。 |
| GamutShellTriangle 包含用于访问顶点缓冲区的三个顶点索引。 |
| GENERIC3CHANNEL TBD (GENERIC3CHANNEL) |
| GRAYCOLOR GRAYCOLOR 结构的说明。 |
| HiFiCOLOR HiFiCOLOR 结构的说明。 |
| JabColorF JabColorF (wcsplugin.h) 是一个结构。 |
| JChColorF JChColorF (wcsplugin.h) 是一种结构。 |
| LabCOLOR TBD (LabCOLOR) |
| LOGCOLORSPACEA LOGCOLORSPACE 结构包含定义逻辑颜色空间的信息。 (ANSI) |
| LOGCOLORSPACEW LOGCOLORSPACE 结构包含定义逻辑颜色空间的信息。 (Unicode) |
| NAMED_PROFILE_INFO NAMED_PROFILE_INFO结构用于存储有关命名颜色配置文件的信息。 |
| NAMEDCOLOR TBD (NAMEDCOLOR) |
| PrimaryJabColors 此结构包含 Jab 坐标中的八种原色。 |
| PrimaryXYZColors 此结构在 XYZ 坐标中包含八种原色。 |
| 配置 文件 包含定义颜色配置文件的信息。 |
| PROFILEHEADER 包含描述设备配置文件的内容的信息。 此标头出现在设备配置文件的开头。 |
| RGBCOLOR TBD (RGBCOLOR) |
| XYZCOLOR TBD (XYZCOLOR) |
| XYZColorF XYZColorF (wcsplugin.h) 是一个结构。 |
| YxyCOLOR TBD (YxyCOLOR) |