METODE ID3D11DeviceContext1::ClearView (d3d11_1.h)

Artikel
08/22/2023

Mengatur semua elemen dalam tampilan sumber daya ke satu nilai.

Sintaks

void ClearView(
  [in]           ID3D11View       *pView,
  [in]           const FLOAT [4]  Color,
  [in, optional] const D3D11_RECT *pRect,
                 UINT             NumRects
);

Parameter

[in] pView

Penunjuk ke antarmuka ID3D11View yang mewakili tampilan sumber daya untuk dihapus.

[in] Color

Array 4 komponen yang mewakili warna yang akan digunakan untuk menghapus tampilan sumber daya.

[in, optional] pRect

Array struktur D3D11_RECT untuk persegi panjang dalam tampilan sumber daya untuk dihapus. Jika NULL, ClearView akan menghapus seluruh permukaan.

NumRects

Jumlah persegi panjang dalam array yang ditentukan parameter pRect .

Nilai kembali

Tidak ada

Keterangan

ClearView hanya berfungsi pada tampilan target render (RTV), tampilan kedalaman/stensil (DSV) pada sumber daya khusus kedalaman (sumber daya tanpa komponen stensil), tampilan akses tidak berurut (UAV), atau tampilan video apa pun dari permukaan Texture2D . Runtime menghilangkan panggilan yang tidak valid. Persegi panjang kosong dalam array pRect adalah no-op. Persegi panjang kosong jika nilai atas sama dengan nilai bawah atau nilai kiri sama dengan nilai kanan.

ClearView tidak mendukung tekstur 3D.

ClearView menerapkan nilai warna yang sama untuk semua irisan array dalam tampilan; semua persegi panjang dalam array pRect sesuai dengan setiap ikatan array. Array persegi panjang pRect adalah sekumpulan area untuk dihapus pada satu permukaan. Jika tampilan adalah array, ClearView menghapus semua persegi panjang pada setiap ikatan array satu per satu.

Saat Anda menerapkan persegi panjang ke buffer, atur nilai teratas ke 0 dan nilai bawah ke 1 dan atur nilai kiri dan nilai kanan untuk menjelaskan jangkauan dalam buffer. Saat nilai atas sama dengan nilai bawah atau nilai kiri sama dengan nilai kanan, persegi panjang kosong dan no-op dicapai.

Driver mengonversi dan menjepit nilai warna ke format tujuan yang sesuai dengan aturan konversi Direct3D. Misalnya, jika format tampilan DXGI_FORMAT_R8G8B8A8_UNORM, driver menjepit input ke 0,0f hingga 1,0f (+INF -> 1,0f (0XFF)/NaN -> 0,0f).

Jika formatnya adalah bilangan bulat, seperti DXGI_FORMAT_R8G8B8A8_UINT, runtime menafsirkan input sebagai float integral. Oleh karena itu, 235,0f memetakan ke 235 (membulatkan ke nol, di luar rentang/klem nilai INF ke rentang target, dan NaN ke 0).

Berikut adalah pemetaan warnanya:

Warna[0]: R (atau Y untuk video)
Warna[1]: G (atau U/Cb untuk video)
Warna[2]: B (atau V/Cr untuk video)
Warna[3]: A

Untuk tampilan video dengan format YUV atau YCbBr, ClearView tidak mengonversi nilai warna. Dalam situasi di mana nama format tidak menunjukkan _UNORM, _UINT, dan sebagainya, ClearView mengasumsikan _UINT. Oleh karena itu, 235,0f memetakan ke 235 (membulatkan ke nol, di luar rentang/klem nilai INF ke rentang target, dan NaN ke 0).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 dan Pembaruan Platform untuk Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 dan Pembaruan Platform untuk Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	d3d11_1.h
Pustaka	D3D11.lib

Lihat juga

ID3D11DeviceContext1

Share via