D3DXColorAdjustContrast-Funktion (D3DX10Math.h)

Passt den Kontrastwert einer Farbe an.

Syntax

D3DXCOLOR* D3DXColorAdjustContrast(
  _In_       D3DXCOLOR *pOut,
  _In_ const D3DXCOLOR *pC,
  _In_       FLOAT     c
);

Parameter

pOut [ In]

Typ: D3DXCOLOR*

[in, out ] Zeiger auf eine D3DXCOLOR, 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 15 Prozent Grau und der Farbe pC. Es gibt keine Grenzwerte für den Wert von c. Wenn dieser Parameter 0 (null) ist, ist die zurückgegebene Farbe prozentgrau. Wenn dieser Parameter 1 ist, ist die zurückgegebene Farbe die ursprüngliche Farbe.

Rückgabewert

Typ: D3DXCOLOR*

Diese Funktion gibt einen Zeiger auf eine D3DXCOLOR-Struktur zurück, die das Ergebnis der Kontrastanpassung ist.

Hinweise

Der Eingabe-Alphakanal wird unverändert in den Alphakanal der Ausgabe kopiert.

Der Rückgabewert für diese Funktion ist der gleiche 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 Rot-, Grün- und Blau-Farbkomponenten einer D3DXCOLOR-Struktur zwischen 10 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
D3DX10Math.h
Bibliothek
D3DX10.lib

Siehe auch

Mathematische Funktionen