D3DXColorLerp-Funktion

Hinweis

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

Verwendet die lineare Interpolation, um einen Farbwert zu erstellen.

Syntax

D3DXCOLOR* D3DXColorLerp(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC1,
  _In_    const D3DXCOLOR *pC2,
  _In_          FLOAT     s
);

Parameter

pOut [in, out]

Typ: D3DXCOLOR*

Zeiger auf eine D3DXCOLOR-Struktur , die das Ergebnis des Vorgangs ist.

pC1 [in]

Typ: const D3DXCOLOR*

Zeiger auf eine D3DXCOLOR-Quellstruktur .

pC2 [in]

Typ: const D3DXCOLOR*

Zeiger auf eine D3DXCOLOR-Quellstruktur .

s [in]

Typ: FLOAT

Parameter, der linear zwischen den Farben pC1 und pC2 interpoliert und beide als 4D-Vektoren behandelt. Es gibt keine Grenzwerte für den Wert von s.

Rückgabewert

Typ: D3DXCOLOR*

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

Bemerkungen

Der Rückgabewert für diese Funktion ist derselbe Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann die Funktion D3DXColorLerp als Parameter für eine andere Funktion verwendet werden.

Diese Funktion interpoliert die Rot-, Grün-, Blau- und Alphakomponenten einer D3DXCOLOR-Struktur zwischen zwei Farben, wie im folgenden Beispiel gezeigt.

pOut->r = pC1->r + s * (pC2->r - pC1->r);

Wenn Sie linear zwischen den Farben A und B interpolieren und s 0 ist, ist die resultierende Farbe A. Wenn s 1 ist, ist die resultierende Farbe Farbe B.

Anforderungen

Anforderung	Wert
Header	D3dx9math.h
Bibliothek	D3dx9.lib

Siehe auch

Mathematische Funktionen

D3DXColorModulate

D3DXColorNegative

D3DXColorScale