IWICDdsDecoder::Metode GetFrame (wincodec.h)
Mengambil bingkai gambar DDS yang ditentukan.
Sintaks
HRESULT GetFrame(
[in] UINT arrayIndex,
[in] UINT mipLevel,
[in] UINT sliceIndex,
[out] IWICBitmapFrameDecode **ppIBitmapFrame
);
Parameter
[in] arrayIndex
Jenis: UINT
Indeks yang diminta dalam array tekstur.
[in] mipLevel
Jenis: UINT
Tingkat mip yang diminta.
[in] sliceIndex
Jenis: UINT
Ikatan yang diminta dalam tekstur 3D.
[out] ppIBitmapFrame
Jenis: IWICBitmapFrameDecode**
Penunjuk ke objek IWICBitmapFrameDecode .
Nilai kembali
Jenis: HRESULT
Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
File DDS dapat berisi beberapa gambar yang diatur ke dalam hierarki tiga tingkat. Pertama, file DDS mungkin berisi beberapa tekstur dalam array tekstur. Kedua, setiap tekstur dapat memiliki beberapa tingkat mip. Akhirnya, teksturnya mungkin tekstur 3D (volume) dan memiliki beberapa irisan, yang masing-masing adalah tekstur 2D. Lihat dokumentasi DDS untuk informasi selengkapnya.
WIC memetakan hierarki tiga tingkat ini ke dalam array linier IWICBitmapFrameDecode, yang dapat diakses melalui IWICBitmapDecoder::GetFrame. Namun, menentukan bingkai mana yang sesuai dengan triad nilai arrayIndex, mipLevel, dan sliceIndex tidak sepele karena setiap tingkat mip tekstur 3D memiliki kedalaman yang berbeda (jumlah irisan). Metode ini memberikan kenyamanan tambahan atas IWICBitmapDecoder::GetFrame untuk gambar DDS dengan menghitung bingkai yang benar mengingat tiga indeks.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8.1 [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows Server 2012 R2 [aplikasi desktop | Aplikasi UWP] |
| Target Platform | Windows |
| Header | wincodec.h |
| Pustaka | Windowscodecs.lib |
| DLL | Windowscodecs.dll |