Fungsi D3DXColorScale

Catatan

Pustaka utilitas D3DX tidak digunakan lagi. Kami menyarankan agar Anda menggunakan DirectXMath sebagai gantinya.

Menskalakan nilai warna.

Sintaks

D3DXCOLOR* D3DXColorScale(
  _Inout_       D3DXCOLOR *pOut,
  _In_    const D3DXCOLOR *pC,
  _In_          FLOAT     s
);

Parameter

pOut [masuk, keluar]

Jenis: D3DXCOLOR*

Penunjuk ke struktur D3DXCOLOR yang merupakan hasil operasi.

pC [in]

Jenis: const D3DXCOLOR*

Penunjuk ke struktur D3DXCOLOR sumber.

s [in]

Jenis: FLOAT

Faktor skala. Ini menskalakan warna, memperlakukannya seperti vektor 4D. Tidak ada batasan pada nilai s. Jika s adalah 1, warna yang dihasilkan adalah warna asli.

Menampilkan nilai

Jenis: D3DXCOLOR*

Fungsi ini mengembalikan penunjuk ke struktur D3DXCOLOR yang merupakan nilai warna yang diskalakan.

Keterangan

Nilai yang dikembalikan untuk fungsi ini adalah nilai yang sama yang dikembalikan dalam parameter pOut. Dengan cara ini, fungsi D3DXColorScale dapat digunakan sebagai parameter untuk fungsi lain.

Fungsi ini menghitung nilai warna yang diskalakan dengan mengalikan komponen warna struktur D3DXCOLOR dengan faktor skala yang ditentukan, seperti yang ditunjukkan dalam contoh berikut.

pOut->r = pC->r * s;

Persyaratan

Persyaratan	Nilai
Header	D3dx9math.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi matematika

D3DXColorLerp

D3DXColorModulate

D3DXColorNegative