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	D3dx9math.h
Bibliothek	D3dx9.lib

Siehe auch

Mathematische Funktionen

D3DXColorAdjustSaturation