Freigeben über


COLORADJUSTMENT-Struktur (wingdi.h)

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

GetColorAdjustment

SetColorAdjustment

SetStretchBltMode

StretchBlt

StretchDIBits