CurveAdjustments-Enumeration (gdipluseffects.h)

Die ColorCurve-Klasse umfasst die acht Bitmapanpassungen, die in der CurveAdjustments-Enumeration aufgeführt sind.

Führen Sie die folgenden Schritte aus, um eine der acht Anpassungen auf eine Bitmap anzuwenden.

1. Erstellen Sie eine ColorCurveParams-Struktur , und legen Sie deren Anpassungselement auf eines der Elemente der CurveAdjustments-Enumeration fest.
2. Legen Sie die beiden anderen Elemente (adjustValue und channel) der ColorCurveParams-Struktur fest.
3. Übergeben Sie die Adresse der ColorCurveParams-Struktur an die ColorCurve::SetParameters-Methode eines ColorCurve-Objekts .
4. Übergeben Sie die Adresse des ColorCurve-Objekts an die Graphics::D rawImage-Methode oder an die Bitmap::ApplyEffect-Methode .

Syntax

typedef enum CurveAdjustments {
  AdjustExposure,
  AdjustDensity,
  AdjustContrast,
  AdjustHighlight,
  AdjustShadow,
  AdjustMidtone,
  AdjustWhiteSaturation,
  AdjustBlackSaturation
} ;

Konstanten

AdjustExposure Simuliert das Erhöhen oder Verringern der Belichtung eines Fotos. Wenn Sie den Anpassungsmember eines ColorCurveParams-Objekts auf AdjustExposure festlegen, sollten Sie den adjustValue-Member auf eine ganze Zahl im Bereich -255 bis 255 festlegen. Der Wert 0 gibt keine Änderung der Belichtung an. Positive Werte geben eine erhöhte Exposition an, und negative Werte geben eine verringerte Exposition an.
AdjustDensity Simuliert das Erhöhen oder Verringern der Filmdichte eines Fotos. Wenn Sie den Anpassungsmember eines ColorCurveParams-Objekts auf AdjustDensity festlegen, sollten Sie das adjustValue-Element auf eine ganze Zahl im Bereich -255 bis 255 festlegen. Der Wert 0 gibt keine Änderung der Dichte an. Positive Werte geben eine erhöhte Dichte an (helleres Bild) und negative Werte geben eine verringerte Dichte an (dunklere Abbildung).
AdjustContrast Erhöht oder verringert den Kontrast einer Bitmap. Wenn Sie den Anpassungsmember eines ColorCurveParams-Objekts auf AdjustContrast festlegen, sollten Sie den adjustValue-Member auf eine ganze Zahl im Bereich -100 bis 100 festlegen. Der Wert 0 gibt keine Kontraständerung an. Positive Werte geben einen erhöhten Kontrast an, und negative Werte geben einen verringerten Kontrast an.
AdjustHighlight Erhöht oder verringert den Wert eines Farbkanals, wenn dieser Kanal bereits über einen Wert verfügt, der über der halben Intensität liegt. Sie können diese Anpassung verwenden, um mehr Definition in den hellen Bereichen eines Bilds zu erhalten, ohne die dunklen Bereiche zu beeinträchtigen. Wenn Sie den Anpassungsmember eines ColorCurveParams-Objekts auf AdjustHighlight festlegen, sollten Sie das adjustValue-Element auf eine ganze Zahl im Bereich -100 bis 100 festlegen. Der Wert 0 gibt keine Änderung an. Positive Werte geben an, dass die hellen Bereiche heller sind, und negative Werte geben an, dass die hellen Bereiche dunkler werden.
AdjustShadow Erhöht oder verringert den Wert eines Farbkanals, wenn dieser Kanal bereits über einen Wert unter der halben Intensität verfügt. Sie können diese Anpassung verwenden, um mehr Definition in den dunklen Bereichen eines Bilds zu erhalten, ohne die hellen Bereiche zu beeinträchtigen. Wenn Sie das Anpassungselement eines ColorCurveParams-Objekts auf AdjustShadow festlegen, sollten Sie den adjustValue-Member auf eine ganze Zahl im Bereich -100 bis 100 festlegen. Der Wert 0 gibt keine Änderung an. Positive Werte geben an, dass die dunklen Bereiche heller sind, und negative Werte geben an, dass die dunklen Bereiche dunkler werden.
AdjustMidtone Hellt ein Bild auf oder verdunkelt sie. Farbkanalwerte in der Mitte des Intensitätsbereichs werden mehr als Farbkanalwerte in der Nähe der minimalen oder maximalen Intensität geändert. Sie können diese Anpassung verwenden, um ein Bild aufhellen (oder abzudunken), ohne den Kontrast zwischen den dunkelsten und hellsten Teilen des Bilds zu verlieren. Wenn Sie das Anpassungselement eines ColorCurveParams-Objekts auf AdjustMidtone festlegen, sollten Sie das adjustValue-Element auf eine ganze Zahl im Bereich von -100 bis 100 festlegen. Der Wert 0 gibt keine Änderung an. Positive Werte geben an, dass die Mitteltöne heller sind, und negative Werte geben an, dass die Mitteltöne dunkler werden.
AdjustWhiteSaturation Wenn Sie den Anpassungsmember eines ColorCurveParams-Objekts auf AdjustWhiteSaturation festlegen, sollten Sie den adjustValue-Member auf eine ganze Zahl im Bereich 0 bis 255 festlegen. Der Wert t gibt an, dass das Intervall [0, t] linear dem Intervall [0, 255] zugeordnet wird. Wenn adjustValue beispielsweise gleich 240 ist, werden die Farbkanalwerte im Intervall [0, 240] so angepasst, dass sie sich auf das Intervall [0, 255] verteilen. Farbkanalwerte größer als 240 werden auf 255 festgelegt.
AdjustBlackSaturation Wenn Sie den Anpassungsmember eines ColorCurveParams-Objekts auf AdjustBlackSaturation festlegen, sollten Sie den adjustValue-Member auf eine ganze Zahl im Bereich 0 bis 255 festlegen. Ein Wert von t gibt an, dass das Intervall [t, 255] linear dem Intervall [0, 255] zugeordnet wird. Wenn adjustValue beispielsweise gleich 15 ist, werden die Farbkanalwerte im Intervall [15, 255] so angepasst, dass sie über das Intervall [0, 255] verteilt sind. Farbkanalwerte kleiner als 15 werden auf 0 festgelegt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	gdipluseffects.h (include Gdiplus.h)