COLORADJUSTMENT 結構 (wingdi.h)

發行項
03/04/2024

當延展模式為 HALFTONE 時， COLORADJUSTMENT 結構會定義 StretchBlt 和 StretchDIBits 函式所使用的色彩調整值。您可以呼叫 SetColorAdjustment 函式來設定色彩調整值。

語法

typedef struct tagCOLORADJUSTMENT {
  WORD  caSize;
  WORD  caFlags;
  WORD  caIlluminantIndex;
  WORD  caRedGamma;
  WORD  caGreenGamma;
  WORD  caBlueGamma;
  WORD  caReferenceBlack;
  WORD  caReferenceWhite;
  SHORT caContrast;
  SHORT caBrightness;
  SHORT caColorfulness;
  SHORT caRedGreenTint;
} COLORADJUSTMENT, *PCOLORADJUSTMENT, *LPCOLORADJUSTMENT;

成員

caSize

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

caFlags

指定應該如何準備輸出映像。這個成員可以設定為 NULL 或任何下列值的組合。

值	意義
CA_NEGATIVE	指定應該顯示原始影像的負數。
CA_LOG_FILTER	指定對數函數應該套用至輸出色彩的最終密度。當亮度偏低時，這會增加色彩對比。

caIlluminantIndex

檢視影像的標準光源類型。這個成員可以設定為下列其中一個值。

值	意義
ILLUMINANT_DEVICE_DEFAULT	裝置的預設值。輸出裝置所使用的標準。
ILLUMINANT_A	青燈。
ILLUMINANT_B	Noon s一。
ILLUMINANT_C	NTSC 日光節約。
ILLUMINANT_D50	一般列印。
ILLUMINANT_D55	結合紙列印。
ILLUMINANT_D65	標準日光節約。 CCT 和圖片的標準。
ILLUMINANT_D75	北日光節約。
ILLUMINANT_F2	非經常性白燈。
ILLUMINANT_TUNGSTEN	與ILLUMINANT_A相同。
ILLUMINANT_DAYLIGHT	與ILLUMINANT_C相同。
ILLUMINANT_FLUORESCENT	與ILLUMINANT_F2相同。
ILLUMINANT_NTSC	與ILLUMINANT_C相同。

caRedGamma

為來源色彩的紅色主要複本指定 第 n^個電源 gamma 校正值。此值必須介於 2500 到 65,000 之間。值為 10,000 表示沒有 Gamma 修正。

caGreenGamma

為來源色彩的綠色主要複本指定 第 n^個電源 gamma 修正值。此值必須介於 2500 到 65,000 之間。值為 10,000 表示沒有 Gamma 修正。

caBlueGamma

為來源色彩的藍色主要複本指定 第 n^個電源 gamma 校正值。此值必須介於 2500 到 65,000 之間。值為 10,000 表示沒有 Gamma 修正。

caReferenceBlack

來源色彩的黑色參考。比這個更深的任何色彩都會被視為黑色。此值必須介於 0 到 4000 的範圍內。

caReferenceWhite

來源色彩的白色參考。比這個更淺的任何色彩都會被視為白色。值的範圍必須介於 6000 到 10,000 之間。

caContrast

要套用至來源對象的對比量。此值必須介於 -100 到 100 的範圍內。值為 0 表示沒有對比調整。

caBrightness

要套用至來源物件的亮度量。此值必須介於 -100 到 100 的範圍內。值為 0 表示沒有亮度調整。

caColorfulness

要套用至來源物件的色彩量。此值必須介於 -100 到 100 的範圍內。值為 0 表示沒有彩色調整。

caRedGreenTint

要套用至來源對象的紅色或綠色色調調整數量。此值必須介於 -100 到 100 的範圍內。正數會向紅色調整，負數會調整為綠色。零表示沒有色調調整。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
標頭	wingdi.h (包含 Windows.h)