COLORINFO-Struktur (winddi.h)

Artikel
08/27/2023

Die COLORINFO-Struktur definiert die Farben eines Geräts im CIE-Koordinatenbereich .

Syntax

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;

Member

Red

Green

Blue

Cyan

Magenta

Yellow

AlignmentWhite

Geben Sie CIECHROMA-Strukturen an, die jeweils die x-Koordinate, die y-Koordinate und die Y-Koordinate (Leuchtdichte) der benannten Farbe definieren.

Der Cyan-Member kann für Monochromdrucker eine besondere Bedeutung haben. Cyan.Y muss auf 65534 (0xFFFE) festgelegt werden, um alle Graustufen-Halbtonmustergrößen zu aktivieren. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

RedGamma

GreenGamma

BlueGamma

Sind die Gammakorrekturen von Anzeigegeräten, die es dem Anzeigegerät ermöglichen, Farben zwischen den Primärfarben mit Genauigkeit anzuzeigen. Die Werte dieser Member sollten im Bereich von 0 bis 6,5535 liegen. Dies bedeutet, dass die tatsächlich in diesen Membern gespeicherten Zahlen im Bereich von 0 bis 65535 liegen müssen. Weitere Informationen zu diesen Membern und diesem Datentyp finden Sie im folgenden Abschnitt hinweise.

MagentaInCyanDye

YellowInCyanDye

CyanInMagentaDye

YellowInMagentaDye

CyanInYellowDye

MagentaInYellowDye

Wird für Druckgeräte verwendet, um die Farbreinheit und -konzentration zu beschreiben. Werte sollten zwischen 0 und 1 liegen, was bedeutet, dass die tatsächlich in diesen Membern gespeicherten Zahlen im Bereich von 0 bis 10000 liegen müssen. Weitere Informationen zu diesem Datentyp finden Sie im folgenden Abschnitt hinweise.

Hinweise

Der LDECI4-Typ wird verwendet, um reelle Zahlen auf vier Dezimalstellen darzustellen. Beispielsweise steht (LDECI4) 10000 für die reelle Zahl 1,0000 und (LDECI4) -12345 für -1,2345.

Wenn Sie bei einem monochromen Drucker die Leuchtdichte für den Cyan-Member (d . h. Cyan.Y) auf 65534 (0xFFFE) festlegen, können Sie eine der verfügbaren Halbtonmustergrößen auswählen. Um eine Halbtonmustergröße für einen monochromen Drucker auszuwählen, legen Sie den ulHTPatternSize-Member der GDIINFO-Struktur auf die gewünschte Halbtonmustergröße fest. Wenn Cyan.Y nicht auf 65534 (0xFFFE) festgelegt ist, werden andere Halbtonmustergrößen als HT_PATSIZE_8x8_M oder HT_PATSIZE_8x8 in HT_PATSIZE_DEFAULT konvertiert.

Das Festlegen der RedGamma-, BlueGamma- und GreenGamma-Member dieser Struktur auf 0xFFFF kann sich auf die Farbverwaltung in Druckern auswirken, wenn die Bildfarbverwaltung (Image Color Management , ICM) deaktiviert ist. In dieser Situation wechselt das GDI-Halbtonmodul von der Durchführung einer eigenen Farbverwaltung zu keinem, was möglicherweise zu einer erheblichen Änderung der resultierenden Druckerausgabe führen kann. Wenn ICM aktiviert ist (und RedGamma, BlueGamma und GreenGamma auf 0XFFFF festgelegt sind), gibt es keinen Unterschied bei der Farbausgabe. Weitere Informationen finden Sie unter Farbverwaltung für Drucker.

Alle Werte in der COLORINFO-Struktur, die außerhalb des angegebenen Bereichs liegen, sind standardmäßig die NTSC-Werte.