COLORINFO 結構 (winddi.h)

COLORINFO 結構會在 CIE 座標空間中定義裝置的色彩。

語法

typedef struct _COLORINFO {
  CIECHROMA Red;
  CIECHROMA Green;
  CIECHROMA Blue;
  CIECHROMA Cyan;
  CIECHROMA Magenta;
  CIECHROMA Yellow;
  CIECHROMA AlignmentWhite;
  LDECI4    RedGamma;
  LDECI4    GreenGamma;
  LDECI4    BlueGamma;
  LDECI4    MagentaInCyanDye;
  LDECI4    YellowInCyanDye;
  LDECI4    CyanInMagentaDye;
  LDECI4    YellowInMagentaDye;
  LDECI4    CyanInYellowDye;
  LDECI4    MagentaInYellowDye;
} COLORINFO, *PCOLORINFO;

成員

Red

Green

Blue

Cyan

Magenta

Yellow

AlignmentWhite

指定 CIECHROMA 結構，每個結構都會定義具名色彩的 x 座標、y 座標和 Y 座標 (亮度) 。

青色成員對於單色印表機可以有特殊意義。 Cyan.Y 必須設定為 65534 (0xFFFE) ，才能啟用所有灰階半色調圖樣大小。 如需詳細資訊，請參閱接下來的＜備註＞一節。

RedGamma

GreenGamma

BlueGamma

顯示裝置的 Gamma 修正是否允許顯示裝置以正確性顯示主要色彩之間的色彩。 這些成員的值應該介於 0 到 6.5535 的範圍內，這表示實際儲存在這些成員中的數位必須介於 0 到 65535 的範圍內。 如需這些成員和此資料類型的詳細資訊，請參閱下列一節。

MagentaInCyanDye

YellowInCyanDye

CyanInMagentaDye

YellowInMagentaDye

CyanInYellowDye

MagentaInYellowDye

用於列印裝置來描述色彩濃度和濃度。 值應該介於零到一之間，這表示實際儲存在這些成員中的數位必須介於 0 到 10000 的範圍內。 如需此資料類型的詳細資訊，請參閱下列一節。

備註

LDECI4 類型用來表示實數到四個小數位數。 例如， (LDECI4) 10000 代表實數 1.0000，而 (LDECI4) -12345 代表 -1.2345。

如果是單色印表機，如果您將 青色 成員 (的亮度設定為 Cyan.Y) 為 65534 (0xFFFE) ，您可以選取任何可用的半色調圖樣大小。 若要選取單色印表機的半色調圖樣大小，請將GDIINFO結構的ulHTPatternSize成員設定為您想要的半色調圖樣大小。 如果 Cyan.Y 未設定為 65534 (0xFFFE) ，HT_PATSIZE_8x8_M或HT_PATSIZE_8x8以外的半色調圖樣大小會轉換成HT_PATSIZE_DEFAULT。

將此結構的 RedGamma、BlueGamma和GreenGamma成員設定為0xFFFF在停用影像色彩管理 (ICM) 時，可能會影響印表機中的色彩管理。 在此情況下，GDI 半色調模組會從執行自己的色彩管理切換為執行無色彩，這可能會在產生的印表機輸出中造成重大變更。 當 ICM 啟用 (和RedGamma、BlueGamma 和 GreenGamma設定為 0XFFFF) 時，色彩輸出沒有任何差異。 如需詳細資訊，請參閱 印表機的色彩管理。

COLORINFO 結構中超出指定範圍的任何值預設為 NTSC 值。

規格需求

另請參閱

CIECHROMA

DrvEnablePDEV

GDIINFO