struktur D3D11_VIEWPORT (d3d11.h)

Menentukan dimensi viewport.

Sintaks

typedef struct D3D11_VIEWPORT {
  FLOAT TopLeftX;
  FLOAT TopLeftY;
  FLOAT Width;
  FLOAT Height;
  FLOAT MinDepth;
  FLOAT MaxDepth;
} D3D11_VIEWPORT;

Anggota

TopLeftX

Jenis: FLOAT

Posisi X sisi kiri viewport. Rentang antara D3D11_VIEWPORT_BOUNDS_MIN dan D3D11_VIEWPORT_BOUNDS_MAX.

TopLeftY

Jenis: FLOAT

Posisi Y di bagian atas viewport. Rentang antara D3D11_VIEWPORT_BOUNDS_MIN dan D3D11_VIEWPORT_BOUNDS_MAX.

Width

Jenis: FLOAT

Lebar viewport.

Height

Jenis: FLOAT

Tinggi viewport.

MinDepth

Jenis: FLOAT

Kedalaman minimum viewport. Rentang antara 0 dan 1.

MaxDepth

Jenis: FLOAT

Kedalaman maksimum viewport. Rentang antara 0 dan 1.

Keterangan

Dalam semua kasus, Lebar dan Tinggi harus >= 0 danLebarTopLeftX + danTinggiTopLeftY + harus <= D3D11_VIEWPORT_BOUNDS_MAX.

Ukuran Viewport dan Perbedaan Dukungan Tingkat Fitur antara Direct3D 11 dan Direct3D 10:

Rentang untuk ukuran viewport minimum dan maksimum tergantung pada tingkat fitur yang ditentukan oleh D3D_FEATURE_LEVEL.

  • Direct3D 11 mendukung viewport pecahan; jenis parameter adalah angka floating-point. Tingkat fitur, D3D_FEATURE_LEVEL_11_0, mendukung nilai (D3D11_VIEWPORT_BOUNDS_MIN, D3D11_VIEWPORT_BOUNDS_MAX) antara (-32768, 32.767).
  • Direct3D 10 tidak mendukung viewport pecahan. Tingkat fitur, D3D_FEATURE_LEVEL_10_1 (atau di bawahnya), mendukung nilai (D3D10_VIEWPORT_BOUNDS_MIN, D3D10_VIEWPORT_BOUNDS_MAX) antara (-16384, 16383).
 
Catatan Meskipun Anda menentukan nilai float ke anggota struktur D3D11_VIEWPORT untuk array pViewports dalam panggilan ke ID3D11DeviceContext::RSSetViewports untuk tingkat fitur 9_x, RSSetViewports menggunakan DWORD secara internal. Karena perilaku ini, saat Anda menggunakan sudut kiri atas negatif untuk viewport, panggilan ke RSSetViewports untuk tingkat fitur 9_x gagal. Kegagalan ini terjadi karena RSSetViewports untuk 9_x mentransmisikan nilai floating point ke dalam bilangan bulat yang tidak ditandatangani tanpa validasi, yang mengakibatkan luapan bilangan bulat.
 

Persyaratan

Persyaratan Nilai
Header d3d11.h

Lihat juga

Struktur Inti