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) |