Fungsi D3DXColorAdjustContrast (D3dx9math.h)

Catatan

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

Menyesuaikan nilai kontras warna.

Sintaks

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

Parameter

pOut [masuk, keluar]

Jenis: D3DXCOLOR*

Penunjuk ke struktur D3DXCOLOR yang merupakan hasil operasi.

pC [in]

Jenis: const D3DXCOLOR*

Penunjuk ke struktur D3DXCOLOR sumber.

c [in]

Jenis: FLOAT

Nilai kontras. Parameter ini secara linier menginterpolasi antara lima puluh persen abu-abu dan warna, pC. Tidak ada batasan pada nilai c. Jika parameter ini nol, maka warna yang dikembalikan adalah lima puluh persen abu-abu. Jika parameter ini adalah 1, maka warna yang dikembalikan adalah warna asli.

Menampilkan nilai

Jenis: D3DXCOLOR*

Fungsi ini mengembalikan pointer ke struktur D3DXCOLOR yang merupakan hasil dari penyesuaian kontras.

Keterangan

Saluran alfa input disalin, tidak dimodifikasi, ke saluran alfa output.

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

Fungsi ini menginterpolasi komponen warna merah, hijau, dan biru dari struktur D3DXCOLOR antara lima puluh persen abu-abu dan nilai kontras tertentu, seperti yang ditunjukkan dalam contoh berikut.

pOut->r = 0.5f + c * (pC->r - 0.5f);

Jika c lebih besar dari 0 dan kurang dari 1, kontrasnya berkurang. Jika c lebih besar dari 1, kontrasnya akan ditingkatkan.

Persyaratan

Persyaratan	Nilai
Header	D3dx9math.h
Pustaka	D3dx9.lib

Lihat juga

Fungsi matematika

D3DXColorAdjustSaturation