D3DXColorAdjustContrast-Funktion (D3DX10Math.h)

Hinweis

Die D3DX10-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zu verwenden.

Passt den Kontrastwert einer Farbe an.

Syntax

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

Parameter

pOut [in]

Typ: D3DXCOLOR*

[ein, aus] 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 fünfzig Prozent Grau und der Farbe pC. Es gibt keine Grenzwerte für den Wert von c. Wenn dieser Parameter 0 ist, ist die zurückgegebene Farbe fünfzig Prozent grau. 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.

Bemerkungen

Der Eingangs-Alphakanal 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	D3DX10Math.h
Bibliothek	D3DX10.lib

Siehe auch

Mathematische Funktionen