Metode IDirect3DCubeTexture9::AddDirtyRect (d3d9helper.h)

Artikel
08/23/2023

Menambahkan wilayah kotor ke sumber daya tekstur kubus.

Sintaks

HRESULT AddDirtyRect(
  [in] D3DCUBEMAP_FACES FaceType,
  [in] const RECT       *pDirtyRect
);

Parameter

[in] FaceType

Jenis: D3DCUBEMAP_FACES

Anggota jenis D3DCUBEMAP_FACES yang dijumlahkan, mengidentifikasi wajah peta kubus.

[in] pDirtyRect

Jenis: const RECT*

Penunjuk ke struktur RECT , menentukan wilayah kotor. Menentukan NULL memperluas wilayah kotor untuk mencakup seluruh tekstur kubus.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Untuk alasan performa, wilayah kotor hanya dicatat untuk tingkat nol tekstur. Untuk sublevel, diasumsikan bahwa persegi panjang atau kotak yang sesuai (diskalakan) juga kotor. Wilayah kotor secara otomatis direkam ketika IDirect3DCubeTexture9::LockRect dipanggil tanpa D3DLOCK_NO_DIRTY_UPDATE atau D3DLOCK_READONLY. Permukaan tujuan IDirect3DDevice9::UpdateSurface juga ditandai kotor secara otomatis.

Menggunakan D3DLOCK_NO_DIRTY_UPDATE dan secara eksplisit menentukan wilayah kotor dapat digunakan untuk meningkatkan efisiensi IDirect3DDevice9::UpdateTexture. Dengan menggunakan metode ini, aplikasi dapat mengoptimalkan subset sumber daya apa yang disalin dengan menentukan wilayah kotor pada sumber daya. Namun, wilayah kotor dapat diperluas untuk mengoptimalkan penyelarasan.