D3DXColorAdjustContrast-Funktion (D3dx9math.h)
Hinweis
Die D3DX-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zu verwenden.
Passt den Kontrastwert einer Farbe an.
Syntax
D3DXCOLOR* D3DXColorAdjustContrast(
_Inout_ D3DXCOLOR *pOut,
_In_ const D3DXCOLOR *pC,
_In_ FLOAT c
);
Parameter
-
pOut [in, out]
-
Typ: D3DXCOLOR*
Zeiger auf eine D3DXCOLOR-Struktur , die das Ergebnis des Vorgangs ist.
-
pC [in]
-
Typ: const D3DXCOLOR*
Zeiger auf eine D3DXCOLOR-Quellstruktur .
-
c [in]
-
Typ: FLOAT
Kontrastwert. Dieser Parameter interpoliert linear zwischen fünfzig Prozent Grau und der Farbe pC. Es gibt keine Grenzwerte für den Wert von c. Wenn dieser Parameter null ist, ist die zurückgegebene Farbe fünfzig Prozent grau. Wenn dieser Parameter 1 ist, ist die zurückgegebene Farbe die Originalfarbe.
Rückgabewert
Typ: D3DXCOLOR*
Diese Funktion gibt einen Zeiger auf eine D3DXCOLOR-Struktur zurück, die das Ergebnis der Kontrastanpassung ist.
Bemerkungen
Der Alphakanal der Eingabe wird unverändert in den Alphakanal der Ausgabe kopiert.
Der Rückgabewert für diese Funktion ist derselbe Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann diese Funktion als Parameter für eine andere Funktion verwendet werden.
Diese Funktion interpoliert die roten, grünen und blauen Farbkomponenten einer D3DXCOLOR-Struktur zwischen fünfzig Prozent Grau und einem angegebenen Kontrastwert, wie im folgenden Beispiel gezeigt.
pOut->r = 0.5f + c * (pC->r - 0.5f);
Wenn c größer als 0 und kleiner als 1 ist, wird der Kontrast verringert. Wenn c größer als 1 ist, wird der Kontrast erhöht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch