COLORADJUSTMENT-Struktur (wingdi.h)

Artikel
08/27/2023

Die COLORADJUSTMENT-Struktur definiert die Farbanpassungswerte, die von den Funktionen StretchBlt und StretchDIBits verwendet werden, wenn der Stretchmodus HALFTONE ist. Sie können die Farbanpassungswerte festlegen, indem Sie die SetColorAdjustment-Funktion aufrufen.

Syntax

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;

Member

caSize

Die Größe der Struktur in Byte.

caFlags

Gibt an, wie das Ausgabebild vorbereitet werden soll. Dieser Member kann auf NULL oder eine beliebige Kombination der folgenden Werte festgelegt werden.

Wert	Bedeutung
CA_NEGATIVE	Gibt an, dass das Negative des ursprünglichen Bilds angezeigt werden soll.
CA_LOG_FILTER	Gibt an, dass eine logarithmische Funktion auf die endgültige Dichte der Ausgabefarben angewendet werden soll. Dadurch wird der Farbkontrast erhöht, wenn die Leuchtdichte niedrig ist.

caIlluminantIndex

Der Typ der Standardlichtquelle, unter der das Bild angezeigt wird. Dieser Member kann auf einen der folgenden Werte festgelegt werden.

Wert	Bedeutung
ILLUMINANT_DEVICE_DEFAULT	Die Standardeinstellung des Geräts. Standard, der von Ausgabegeräten verwendet wird.
ILLUMINANT_A	Wolframlampe.
ILLUMINANT_B	Mittag Sonnenlicht.
ILLUMINANT_C	NTSC-Tageslicht.
ILLUMINANT_D50	Normaler Druck.
ILLUMINANT_D55	Bondpapierdruck.
ILLUMINANT_D65	Standard-Tageslicht. Standard für CRTs und Bilder.
ILLUMINANT_D75	Nordlicht.
ILLUMINANT_F2	Kalte weiße Lampe.
ILLUMINANT_TUNGSTEN	Identisch mit ILLUMINANT_A.
ILLUMINANT_DAYLIGHT	Identisch mit ILLUMINANT_C.
ILLUMINANT_FLUORESCENT	Identisch mit ILLUMINANT_F2.
ILLUMINANT_NTSC	Identisch mit ILLUMINANT_C.

caRedGamma

Gibt den ^n-ten Leistungs-Gammakorrekturwert für die rote Primärfarbe der Quellfarben an. Der Wert muss im Bereich von 2500 bis 65.000 liegen. Ein Wert von 10.000 bedeutet keine Gammakorrektur.

caGreenGamma

Gibt den ^n-ten Leistungs-Gammakorrekturwert für die grüne Primärfarbe der Quellfarben an. Der Wert muss im Bereich von 2500 bis 65.000 liegen. Ein Wert von 10.000 bedeutet keine Gammakorrektur.

caBlueGamma

Gibt den ^n-ten Leistungs-Gammakorrekturwert für die blaue Primärfarbe der Quellfarben an. Der Wert muss im Bereich von 2500 bis 65.000 liegen. Ein Wert von 10.000 bedeutet keine Gammakorrektur.

caReferenceBlack

Der schwarze Verweis für die Quellfarben. Alle Farben, die dunkler sind, werden als Schwarz behandelt. Der Wert muss im Bereich von 0 bis 4000 liegen.

caReferenceWhite

Der weiße Verweis für die Quellfarben. Alle Farben, die heller als diese sind, werden als weiß behandelt. Der Wert muss im Bereich von 6000 bis 10.000 liegen.

caContrast

Der Kontrast, der auf das Quellobjekt angewendet werden soll. Der Wert muss im Bereich von -100 bis 100 liegen. Ein Wert von 0 bedeutet keine Kontrastanpassung.

caBrightness

Die Helligkeit, die auf das Quellobjekt angewendet werden soll. Der Wert muss im Bereich von -100 bis 100 liegen. Ein Wert von 0 bedeutet, dass keine Helligkeitsanpassung erfolgt.

caColorfulness

Der Farbumfang, der auf das Quellobjekt angewendet werden soll. Der Wert muss im Bereich von -100 bis 100 liegen. Ein Wert von 0 bedeutet keine Farbanpassung.

caRedGreenTint

Die Menge der Rot- oder Grüntonanpassung, die auf das Quellobjekt angewendet werden soll. Der Wert muss im Bereich von -100 bis 100 liegen. Positive Zahlen passen sich an rot an, und negative Zahlen werden in Grün angepasst. Null bedeutet, dass keine Farbtonanpassung erfolgt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	wingdi.h (windows.h einschließen)

Weitere Informationen

Bitmapstrukturen

Übersicht über Bitmaps