Metode IDirect3DDevice9::ColorFill (d3d9.h)

  • Artikel

Memungkinkan aplikasi mengisi area persegi panjang dari permukaan D3DPOOL_DEFAULT dengan warna tertentu.

Sintaks

HRESULT ColorFill(
  [in] IDirect3DSurface9 *pSurface,
  [in] const RECT        *pRect,
  [in] D3DCOLOR          color
);

Parameter

[in] pSurface

Jenis: IDirect3DSurface9*

Arahkan ke permukaan yang akan diisi.

[in] pRect

Jenis: const RECT*

Penunjuk ke persegi panjang sumber. Menggunakan NULL berarti bahwa seluruh permukaan akan diisi.

[in] color

Jenis: D3DCOLOR

Warna yang digunakan untuk pengisian.

Menampilkan nilai

Jenis: HRESULT

Jika metode berhasil, nilai yang dikembalikan adalah D3D_OK. Jika metode gagal, nilai yang dikembalikan dapat D3DERR_INVALIDCALL.

Keterangan

Metode ini hanya dapat diterapkan ke target render, permukaan tekstur target render, atau permukaan polos di luar layar dengan jenis kumpulan D3DPOOL_DEFAULT.

IDirect3DDevice9::ColorFill akan berfungsi dengan semua format. Namun, saat menggunakan referensi atau perangkat lunak, satu-satunya format yang didukung adalah D3DFMT_X1R5G5B5, D3DFMT_A1R5G5B5, D3DFMT_R5G6B5, D3DFMT_X8R8G8B8, D3DFMT_A8R8G8B8, D3DFMT_YUY2, D3DFMT_G8R8_G8B8, D3DFMT_UYVY, D3DFMT_R8G8_B8G8, D3DFMT_R16F, D3DFMT_G16R16F, D3DFMT_A16B16G16R16F, D3DFMT_R32F, D3DFMT_G32R32F, dan D3DFMT_A32B32G32R32F.

Saat menggunakan driver DirectX 7 atau DirectX 8.x, satu-satunya format YUV yang didukung adalah D3DFMT_UYVY dan D3DFMT_YUY2.

Persyaratan

   
Target Platform Windows
Header d3d9.h (termasuk D3D9.h)
Pustaka D3D9.lib

Lihat juga

D3DPOOL

IDirect3DDevice9