Windows 色彩系統

Windows 色彩系統技術概觀。

若要開發 Windows 色彩系統，您需要下列標頭：

• wcsplugin.h

如需這項技術的程式設計指導方針，請參閱：

• Windows 色彩系統

列舉

BMFORMAT 數個 WCS 函式會使用 BMFORMAT 列舉型別的值，以指出特定點陣圖位於的格式。
COLORDATATYPE WCS 函式用來指出向量內容的資料類型。
COLORPROFILESUBTYPE 指定色彩設定檔的子類型。
COLORPROFILETYPE 指定色彩設定檔的類型。
COLORTYPE 數個 WCS 函式會使用 COLORTYPE 列舉的值。 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 傳回適當的裝置色彩，以回應傳入的色彩、通道、黑色資訊、Commission Internationale 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 是該資料表中的單一索引。
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 函式會取得直接色彩顯示器面板上的 gamma 坡形，其驅動程式支援硬體中可下載的 Gamma 坡形。
GetGamutBoundaryMesh 從外掛程式傳回三角形網格。 此函式是用來計算 GamutBoundaryDescription。
GetGamutBoundaryMeshSize 傳回 GetGamutBoundaryMesh 函式的必要資料結構大小。
GetICMProfileA GetICMProfile 函式會擷取指定裝置內容之目前輸出色彩設定檔的檔案名。 (ANSI)
GetICMProfileW GetICMProfile 函式會擷取指定裝置內容之目前輸出色彩設定檔的檔案名。 (Unicode)
GetKValue GetKValue 宏會從 CMYK 色彩值擷取黑色色彩值。
GetLogColorSpaceA GetLogColorSpace 函式會擷取指定控制碼所識別的色彩空間定義。 (ANSI)
GetLogColorSpaceW GetLogColorSpace 函式會擷取指定控制碼所識別的色彩空間定義。 (Unicode)
GetMValue GetMValue 宏會從 CMYK 色彩值擷取 magenta 色彩值。
GetNamedProfileInfo 擷取國際色彩聯盟 () 第一個參數中指定的具名色彩設定檔的相關資訊。
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 的指標，其中包含整個裝置型號外掛程式做為輸入，並初始化外掛程式所需的任何內部參數。
初始 化 使用指定的來源和目的地遊戲界限描述和選擇性來源和目的地裝置模型外掛程式，初始化 gamut 地圖模型設定檔 (GMMP) 。
InstallColorProfileA 安裝指定的設定檔以在指定的電腦上使用。 設定檔也會複製到 COLOR 目錄。 (ANSI)
InstallColorProfileW 安裝指定的設定檔以在指定的電腦上使用。 設定檔也會複製到 COLOR 目錄。 (Unicode)
IsColorProfileTagPresent 報告指定的國際色彩聯盟 () 標記是否存在於指定的色彩設定檔中。
IsColorProfileValid 可讓您判斷指定的設定檔是有效的國際色彩聯盟 () 設定檔，還是有效的 Windows 色彩系統 (WCS) 設定檔控制碼，可用於色彩管理。
OpenColorProfileA 建立指定之色彩設定檔的控制碼。 接著，控制碼可以用於其他設定檔管理功能。 (ANSI)
OpenColorProfileW 建立指定之色彩設定檔的控制碼。 接著，控制碼可以用於其他設定檔管理功能。 (Unicode)
PBMCALLBACKFN TBD (PBMCALLBACKFN)
PCMSCALLBACKA *PCMSCALLBACKA* (或 ApplyCallbackFunction) 是一種回呼函式，您可以在 SetupColorMatchingW 函式所顯示的對話方塊執行時，實作更新 WCS 設定資料。
PCMSCALLBACKW *PCMSCALLBACKW* (或 ApplyCallbackFunction) 是您實作的回呼函式，可在 SetupColorMatchingW 函式顯示的對話方塊執行時更新 WCS 設定資料。
RegisterCMMA 將指定的識別值與指定的色彩管理模組動態連結程式庫產生關聯， (CMM DLL) 。 當此識別碼出現在色彩設定檔中時，Windows 就可以找到對應的 CMM，以便建立轉換。 (ANSI)
RegisterCMMW 將指定的識別值與指定的色彩管理模組動態連結程式庫產生關聯， (CMM DLL) 。 當此識別碼出現在色彩設定檔中時，Windows 就可以找到對應的 CMM，以便建立轉換。 (Unicode)
SelectCMM 可讓您選取要使用的慣用色彩管理模組 (CMM) 。
SetColorProfileElement 在 ICC 色彩設定檔中設定標記設定檔元素的專案資料。
SetColorProfileElementReference 在指定的 ICC 色彩設定檔中建立參考與現有標籤相同資料的新標記。
SetColorProfileElementSize 在 ICC 色彩設定檔中設定標記專案的大小。
SetColorProfileHeader 在指定的 ICC 色彩設定檔中設定標頭資料。
SetColorSpace SetColorSpace 函式會定義指定裝置內容的輸入色彩空間。
SetDeviceGammaRamp SetDeviceGammaRamp 函式會在直接色彩顯示面板上設定 gamma 坡形，其驅動程式支援硬體中可下載的 Gamma 坡形。
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)
取消註冊CMMA 將指定的識別碼值與指定的色彩管理模組動態連結程式庫中斷關聯， (CMM DLL) 。 (ANSI)
UnregisterCMMW 將指定的識別碼值與指定的色彩管理模組動態連結程式庫中斷關聯， (CMM DLL) 。 (Unicode)
UpdateICMRegKeyA UpdateICMRegKey 函式會管理系統中的色彩設定檔和色彩管理模組。 (ANSI)
UpdateICMRegKeyW UpdateICMRegKey 函式會管理系統中的色彩設定檔和色彩管理模組。 (Unicode)
WcsAssociateColorProfileWithDevice WcsAssociateColorProfileWithDevice 會將指定的 WCS 色彩設定檔與指定的裝置產生關聯。
WcsCheckColors 判斷陣列中的色彩是否位於指定之 WCS 色彩轉換的輸出範圍內。
WcsCreateIccProfile 將 WCS 設定檔轉換成國際色彩聯盟 () 設定檔。
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 包含定義 gamut 殼層的資訊，此殼層是由索引三角形清單表示。 頂點緩衝區包含頂點資料。
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)