struktur D3DX11_IMAGE_LOAD_INFO
Catatan
Pustaka utilitas D3DX (D3DX 9, D3DX 10, dan D3DX 11) tidak digunakan lagi untuk Windows 8 dan tidak didukung untuk aplikasi Windows Store.
Secara opsional berikan informasi ke API pemuat tekstur untuk mengontrol bagaimana tekstur dimuat. Nilai D3DX11_DEFAULT untuk salah satu parameter ini akan menyebabkan D3DX secara otomatis menggunakan nilai dari file sumber.
Sintaks
typedef struct D3DX11_IMAGE_LOAD_INFO {
UINT Width;
UINT Height;
UINT Depth;
UINT FirstMipLevel;
UINT MipLevels;
D3D11_USAGE Usage;
UINT BindFlags;
UINT CpuAccessFlags;
UINT MiscFlags;
DXGI_FORMAT Format;
UINT Filter;
UINT MipFilter;
D3DX11_IMAGE_INFO *pSrcInfo;
} D3DX11_IMAGE_LOAD_INFO, *LPD3DX11_IMAGE_LOAD_INFO;
Anggota
-
Lebar
-
Jenis: UINT
-
Lebar target tekstur. Jika lebar aktual tekstur lebih besar atau lebih kecil dari nilai ini, maka tekstur akan ditingkatkan atau diturunkan skalanya agar pas dengan lebar target ini.
-
Tinggi
-
Jenis: UINT
-
Tinggi target tekstur. Jika tinggi aktual tekstur lebih besar atau lebih kecil dari nilai ini, maka tekstur akan ditingkatkan atau diturunkan skalanya agar pas dengan tinggi target ini.
-
Kedalaman
-
Jenis: UINT
-
Kedalaman tekstur. Ini hanya berlaku untuk tekstur volume.
-
FirstMipLevel
-
Jenis: UINT
-
Tingkat mipmap resolusi tertinggi dari tekstur. Jika ini lebih besar dari 0, maka setelah tekstur dimuat FirstMipLevel akan dipetakan ke tingkat mipmap 0.
-
MipLevels
-
Jenis: UINT
-
Jumlah maksimum tingkat mipmap dalam tekstur. Lihat keterangan di D3D11_TEX1D_SRV. Menggunakan 0 atau D3DX11_DEFAULT akan menyebabkan rantai mipmap penuh dibuat.
-
Penggunaan
-
Jenis: D3D11_USAGE
-
Cara sumber daya tekstur dimaksudkan untuk digunakan. Lihat D3D11_USAGE.
-
BindFlags
-
Jenis: UINT
-
Tahap alur tempat tekstur akan diizinkan untuk mengikat. Lihat D3D11_BIND_FLAG.
-
CpuAccessFlags
-
Jenis: UINT
-
Izin akses yang akan dimiliki cpu untuk sumber daya tekstur. Lihat D3D11_CPU_ACCESS_FLAG.
-
MiscFlags
-
Jenis: UINT
-
Properti sumber daya lain-lain (lihat D3D11_RESOURCE_MISC_FLAG).
-
Format
-
Jenis: DXGI_FORMAT
-
Enumerasi DXGI_FORMAT yang menunjukkan format tekstur akan berada di setelah dimuat.
-
Filter
-
Jenis: UINT
-
Filter tekstur menggunakan filter yang ditentukan (hanya saat pengambilan sampel ulang). Lihat D3DX11_FILTER_FLAG.
-
MipFilter
-
Jenis: UINT
-
Filter tingkat mip tekstur menggunakan filter yang ditentukan (hanya jika menghasilkan mipmap). Nilai yang valid adalah D3DX11_FILTER_NONE, D3DX11_FILTER_POINT, D3DX11_FILTER_LINEAR, atau D3DX11_FILTER_TRIANGLE. Lihat D3DX11_FILTER_FLAG.
-
pSrcInfo
-
Jenis: D3DX11_IMAGE_INFO*
-
Informasi tentang gambar asli. Lihat D3DX11_IMAGE_INFO. Dapat diperoleh dengan D3DX11GetImageInfoFromFile, D3DX11GetImageInfoFromMemory, atau D3DX11GetImageInfoFromResource.
Keterangan
Saat menginisialisasi struktur, Anda dapat mengatur anggota mana pun ke D3DX11_DEFAULT dan D3DX akan menginisialisasinya dengan nilai default dari tekstur sumber saat tekstur dimuat.
Struktur ini dapat digunakan oleh API yang:
- Buat sumber daya, seperti D3DX11CreateTextureFromFile dan D3DX11CreateShaderResourceViewFromFile.
- Buat prosesor data, seperti D3DX11CreateAsyncTextureInfoProcessor atau D3DX11CreateAsyncShaderResourceViewProcessor.
Nilai defaultnya adalah:
Width = D3DX11_DEFAULT;
Height = D3DX11_DEFAULT;
Depth = D3DX11_DEFAULT;
FirstMipLevel = D3DX11_DEFAULT;
MipLevels = D3DX11_DEFAULT;
Usage = (D3D11_USAGE) D3DX11_DEFAULT;
BindFlags = D3DX11_DEFAULT;
CpuAccessFlags = D3DX11_DEFAULT;
MiscFlags = D3DX11_DEFAULT;
Format = DXGI_FORMAT_FROM_FILE;
Filter = D3DX11_DEFAULT;
MipFilter = D3DX11_DEFAULT;
pSrcInfo = NULL;
Berikut adalah contoh singkat yang menggunakan struktur ini untuk menyediakan format piksel saat memuat tekstur. Untuk kode lengkapnya, lihat HDRFormats10.cpp dalam Sampel HDRToneMappingCS11.
ID3D11ShaderResourceView* pCubeRV = NULL;
WCHAR strPath[MAX_PATH];
D3DX11_IMAGE_LOAD_INFO LoadInfo;
DXUTFindDXSDKMediaFileCch( strPath, MAX_PATH,
L"Light Probes\\uffizi_cross.dds" );
LoadInfo.Format = DXGI_FORMAT_R16G16B16A16_FLOAT;
hr = D3DX11CreateShaderResourceViewFromFile( pd3dDevice, strPath,
&LoadInfo, NULL, &pCubeRV, NULL );
Persyaratan
Persyaratan | Nilai |
---|---|
Header |
|