LOGCOLORSPACEA 結構 (wingdi.h)

LOGCOLORSPACE 結構包含定義邏輯色彩空間的資訊。

語法

typedef struct tagLOGCOLORSPACEA {
  DWORD         lcsSignature;
  DWORD         lcsVersion;
  DWORD         lcsSize;
  LCSCSTYPE     lcsCSType;
  LCSGAMUTMATCH lcsIntent;
  CIEXYZTRIPLE  lcsEndpoints;
  DWORD         lcsGammaRed;
  DWORD         lcsGammaGreen;
  DWORD         lcsGammaBlue;
  CHAR          lcsFilename[MAX_PATH];
} LOGCOLORSPACEA, *LPLOGCOLORSPACEA;

成員

lcsSignature

色彩空間簽章。 目前，此成員應該一律設定為 LCS_SIGNATURE。

lcsVersion

版本號碼;必須0x400。

lcsSize

這個結構的大小，以位元組為單位。

lcsCSType

色彩空間類型。 成員可以是下列其中一個值。

值	意義
LCS_CALIBRATED_RGB	色彩值是校正的 RGB 值。 這些值會使用 lcsEndpoints 成員指定的端點進行轉譯，再傳遞至裝置。
LCS_sRGB	色彩值是值是 sRGB 值。
LCS_WINDOWS_COLOR_SPACE	色彩值是 Windows 預設色彩空間色彩值。

 

如果未指定LCS_CALIBRATED_RGB， 則會忽略 lcsEndpoints 成員。

lcsIntent

gamut 對應方法。 這個成員可以是下列其中一個值。

值	Intent	ICC 名稱	意義
LCS_GM_ABS_   色度	相符項目	絕對色階	維持白色點。 比對色彩與目的地遊戲最接近的色彩。
LCS_GM_   業務	Graphic	飽和度	維持飽和度。 用於商務圖表和其他需要未指定色彩的情況。
LCS_GM_   圖形	證明	相對色階	維護色階比對。 用於圖形設計和具名色彩。
LCS_GM_   映像	Picture	感性	維持對比。 用於相片和自然影像。

lcsEndpoints

紅色、綠色、藍色端點。

lcsGammaRed

紅色座標的尺規。

lcsGammaGreen

綠色座標的縮放比例。

lcsGammaBlue

藍色座標的尺規。

lcsFilename[MAX_PATH]

名稱為色彩配置檔檔案的 Null 終止字串。 此成員通常設定為零，但可用來設定色彩配置檔所指定的色彩空間。 這適用於輸入特定印表機色彩值的裝置，或使用可安裝的影像色彩比對器時。 如果指定色彩配置檔，則此結構的所有其他成員都應該設定為合理的值，即使這些值不完全精確也一樣。

備註

如同調色盤，但不同於畫筆和筆刷，建立LogColorSpace時必須傳遞指標。

如果 lcsCSType 成員設定為LCS_sRGB或LCS_WINDOWS_COLOR_SPACE，則會忽略這個結構的其他成員，而 WCS 會使用 sRGB 色彩空間。 lcsEndpoints、lcsGammaRed、lcsGammaGreen 和 lcsGammaBlue 成員可用來描述邏輯色彩空間。 lcsEndpoints 成員是 CIEXYZTRIPLE，其中包含色彩空間 RGB 端點的 x、y 和 z 值。

lcsGammaRed、lcsGammaGreen 和 lcsGammaBlue 的必要 DWORD 位格式是 8.8 個固定點整數，以 8 位為左移。 這表示 8 個整數位後面接著 8 個分數位。 將位移入考慮，32 位 DWORD 的必要格式為：

00000000nnnnnnnnffff00000000

每當 lcsFilename 成員包含檔名， 且 lcsCSType 成員設定為 LCS_CALIBRATED_RGB時，WCS 會忽略這個結構的其他成員。 它會使用檔案中的色彩空間作為這個 LOGCOLORSPACE 結構所參考的色彩空間。

三角值 X、Y、Z 和 chromaticity 值 x、y、z 之間的關聯如下：

x = X/ (X+Y+Z)

y = Y/ (X+Y+Z)

z = Z/ (X+Y+Z)

如果 lcsCSType 成員設定為LCS_sRGB或LCS_WINDOWS_COLOR_SPACE，則會忽略這個結構的其他成員，而 ICM 會使用 sRGB 色彩空間。 應用程式仍應初始化結構的其餘部分，因為 CreateProfileFromLogColorSpace 會忽略 lcsCSType 成員，並使用 lcsEndpoints、lcsGammaRed、lcsGammaGreen、lcsGammaBlue 成員來建立配置檔，在LCS_sRGB或LCS_WINDOWS_COLOR_SPACE色彩空間的情況下可能無法初始化。

注意

wingdi.h 標頭會根據 UNICODE 預處理器常數的定義，將 LOGCOLORSPACE 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	wingdi.h

另請參閱

BITMAPV4HEADER

BITMAPV5HEADER

Cmyk

RGB