struktur D3D11_TEXTURE2D_DESC (d3d11.h)

  • Artikel

Menjelaskan tekstur 2D.

Sintaks

typedef struct D3D11_TEXTURE2D_DESC {
  UINT             Width;
  UINT             Height;
  UINT             MipLevels;
  UINT             ArraySize;
  DXGI_FORMAT      Format;
  DXGI_SAMPLE_DESC SampleDesc;
  D3D11_USAGE      Usage;
  UINT             BindFlags;
  UINT             CPUAccessFlags;
  UINT             MiscFlags;
} D3D11_TEXTURE2D_DESC;

Anggota

Width

Jenis: UINT

Lebar tekstur (dalam texel). Rentangnya adalah dari 1 hingga D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Untuk peta kubus tekstur, rentangnya adalah dari 1 hingga D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Namun, rentang sebenarnya dibatasi oleh tingkat fitur tempat Anda membuat perangkat penyajian. Untuk informasi selengkapnya tentang pembatasan, lihat Komentar.

Height

Jenis: UINT

Tinggi tekstur (dalam texel). Rentangnya adalah dari 1 hingga D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Untuk peta kubus tekstur, rentangnya adalah dari 1 hingga D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Namun, rentang sebenarnya dibatasi oleh tingkat fitur tempat Anda membuat perangkat penyajian. Untuk informasi selengkapnya tentang pembatasan, lihat Komentar.

MipLevels

Jenis: UINT

Jumlah maksimum tingkat mipmap dalam tekstur. Lihat keterangan di D3D11_TEX1D_SRV. Gunakan 1 untuk tekstur multisampel; atau 0 untuk menghasilkan sekumpulan subtekstur lengkap.

ArraySize

Jenis: UINT

Jumlah tekstur dalam array tekstur. Rentangnya adalah dari 1 hingga D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). Untuk peta kubus tekstur, nilai ini adalah kelipatan 6 (yaitu, 6 kali nilai dalam anggota NumCubesD3D11_TEXCUBE_ARRAY_SRV), dan rentangnya adalah dari 6 hingga 2046. Rentang sebenarnya dibatasi oleh tingkat fitur tempat Anda membuat perangkat penyajian. Untuk informasi selengkapnya tentang pembatasan, lihat Komentar.

Format

Jenis: DXGI_FORMAT

Format tekstur (lihat DXGI_FORMAT).

SampleDesc

Jenis: DXGI_SAMPLE_DESC

Struktur yang menentukan parameter multisampling untuk tekstur. Lihat DXGI_SAMPLE_DESC.

Usage

Jenis: D3D11_USAGE

Nilai yang mengidentifikasi bagaimana tekstur akan dibaca dan ditulis. Nilai yang paling umum adalah D3D11_USAGE_DEFAULT; lihat D3D11_USAGE untuk semua nilai yang mungkin.

BindFlags

Jenis: UINT

Bendera (lihat D3D11_BIND_FLAG) untuk pengikatan ke tahap alur. Bendera dapat digabungkan dengan bitwise OR.

CPUAccessFlags

Jenis: UINT

Bendera (lihat D3D11_CPU_ACCESS_FLAG) untuk menentukan jenis akses CPU yang diizinkan. Gunakan 0 jika akses CPU tidak diperlukan. Bendera ini dapat dikombinasikan dengan bitwise OR.

MiscFlags

Jenis: UINT

Bendera (lihat D3D11_RESOURCE_MISC_FLAG) yang mengidentifikasi opsi sumber daya lain yang kurang umum. Gunakan 0 jika tidak ada bendera ini yang berlaku. Bendera ini dapat digabungkan dengan menggunakan bitwise OR. Untuk peta kubus tekstur, atur bendera D3D11_RESOURCE_MISC_TEXTURECUBE . Array peta kubus (yaitu, ArraySize> 6) memerlukan tingkat fitur D3D_FEATURE_LEVEL_10_1 atau lebih tinggi.

Keterangan

Struktur ini digunakan dalam panggilan ke ID3D11Device::CreateTexture2D.

Selain struktur ini, Anda juga dapat menggunakan struktur turunan CD3D11_TEXTURE2D_DESC , yang didefinisikan dalam D3D11.h dan berperilaku seperti kelas yang diwariskan, untuk membantu membuat deskripsi tekstur.

Perangkat menempatkan beberapa batasan ukuran (harus kelipatan ukuran minimum) untuk sumber daya subsampel, blok terkompresi, atau format bit.

Rentang ukuran tekstur ditentukan oleh tingkat fitur tempat Anda membuat perangkat dan bukan versi antarmuka Microsoft Direct3D. Misalnya, jika Anda menggunakan perangkat keras Microsoft Direct3D 10 di tingkat fitur 10 (D3D_FEATURE_LEVEL_10_0) dan memanggil D3D11CreateDevice untuk membuat ID3D11Device, Anda harus membatasi ukuran tekstur maksimum ke D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192) saat membuat tekstur 2D.

Persyaratan

Persyaratan Nilai
Header d3d11.h

Lihat juga

Struktur Sumber Daya