D3DXColorModulate-Funktion

Kombiniert zwei Farben.

Syntax

D3DXCOLOR* D3DXColorModulate(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC1,
  _In_    const D3DXCOLOR *pC2
);

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.

Rückgabewert

Typ: D3DXCOLOR*

Diese Funktion gibt einen Zeiger auf eine D3DXCOLOR-Struktur zurück, die das Ergebnis des Überblendungsvorgangs ist.

Bemerkungen

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

Diese Funktion kombiniert zwei Farben, indem übereinstimmende Farbkomponenten multipliziert werden, wie im folgenden Beispiel gezeigt.

pOut->r = pC1->r * pC2->r;

Requirements (Anforderungen)

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Weitere Informationen

Mathematische Funktionen

D3DXColorLerp

D3DXColorNegative

D3DXColorScale