D3DXColorScale-Funktion
Hinweis
Die D3DX-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zu verwenden.
Skaliert einen Farbwert.
Syntax
D3DXCOLOR* D3DXColorScale(
_Inout_ D3DXCOLOR *pOut,
_In_ const D3DXCOLOR *pC,
_In_ FLOAT s
);
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 .
-
s [in]
-
Typ: FLOAT
Skalierungsfaktor. Es skaliert die Farbe und behandelt sie wie einen 4D-Vektor. Es gibt keine Grenzwerte für den Wert von s. Wenn s 1 ist, ist die resultierende Farbe die originale Farbe.
Rückgabewert
Typ: D3DXCOLOR*
Diese Funktion gibt einen Zeiger auf eine D3DXCOLOR-Struktur zurück, die dem skalierten Farbwert entspricht.
Bemerkungen
Der Rückgabewert für diese Funktion ist derselbe Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann die Funktion D3DXColorScale als Parameter für eine andere Funktion verwendet werden.
Diese Funktion berechnet den skalierten Farbwert, indem die Farbkomponenten der D3DXCOLOR-Struktur mit dem angegebenen Skalierungsfaktor multipliziert werden, wie im folgenden Beispiel gezeigt.
pOut->r = pC->r * s;
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch