LevelsParams-Struktur (gdipluseffects.h)

Die LevelsParams-Struktur enthält Elemente, die Anpassungen an den hellen, mitteltonigen oder dunklen Bereichen einer Bitmap angeben.

Sie können die hellen, mittleren oder dunklen Bereiche einer Bitmap anpassen, indem Sie die folgenden Schritte ausführen.

1. Erstellen und initialisieren Sie eine LevelsParams-Struktur .
2. Übergeben Sie die Adresse der LevelsParams-Struktur an die Levels::SetParameters-Methode eines Levels-Objekts .
3. Übergeben Sie die Adresse des Levels-Objekts an die Graphics::D rawImage-Methode oder an die Bitmap::ApplyEffect-Methode .

Syntax

struct LevelsParams {
  INT highlight;
  INT midtone;
  INT shadow;
};

Members

highlight

Typ: INT

Ganze Zahl im Bereich von 0 bis 100, die angibt, welche Pixel aufgehellt werden sollen. Sie können diese Anpassung verwenden, um Pixel aufhellen, die bereits heller als ein bestimmter Schwellenwert sind. Wenn Sie die Hervorhebung auf 100 festlegen, wird keine Änderung angegeben. Das Festlegen der Hervorhebung auf t gibt an, dass ein Farbkanalwert erhöht wird, wenn er bereits größer als t Prozent der vollen Intensität ist. Das Festlegen der Hervorhebung auf 90 gibt beispielsweise an, dass alle Farbkanalwerte, die größer als 90 Prozent der vollen Intensität sind, erhöht werden.

midtone

Typ: INT

Ganze Zahl im Bereich -100 bis 100, der angibt, wie viel ein Bild aufhellen oder verdunkeln soll. Farbkanalwerte in der Mitte des Intensitätsbereichs werden stärker 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 abzudunklen), ohne den Kontrast zwischen den dunkelsten und hellsten Teilen des Bilds zu verlieren. 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.

shadow

Typ: INT

Ganze Zahl im Bereich von 0 bis 100, der angibt, welche Pixel abgedunkelt werden sollen. Sie können diese Anpassung verwenden, um Pixel abzudunken, die bereits dunkler als ein bestimmter Schwellenwert sind. Wenn Schatten auf 0 festgelegt wird, wird keine Änderung angegeben. Das Festlegen des Schattens auf t gibt an, dass ein Farbkanalwert verringert wird, wenn er bereits kleiner als t Prozent der vollen Intensität ist. Das Festlegen des Schattens auf 10 gibt beispielsweise an, dass alle Farbkanalwerte, die kleiner als 10 Prozent der vollen Intensität sind, verringert werden.

Anforderungen

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)