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，則會忽略 lcsEndpoints 成員。

lcsIntent

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

lcsEndpoints

紅色、綠色、藍色端點。

lcsGammaRed

紅色座標的縮放比例。

lcsGammaGreen

綠色座標的縮放比例。

lcsGammaBlue

藍色座標的縮放比例。

lcsFilename[MAX_PATH]

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

言論

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

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

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

00000000nnnnnnnnffffffffff00000000

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

三刺激值 X、Y、Z 和色度值 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色彩空間的情況下初始化。

要求

另請參閱

BITMAPV4HEADER

BITMAPV5HEADER

CMYK

RGB