Metodo IWICDdsDecoder::GetFrame (wincodec.h)

Recupera il frame specificato dell'immagine DDS.

Sintassi

HRESULT GetFrame(
  [in]  UINT                  arrayIndex,
  [in]  UINT                  mipLevel,
  [in]  UINT                  sliceIndex,
  [out] IWICBitmapFrameDecode **ppIBitmapFrame
);

Parametri

[in] arrayIndex

Tipo: UINT

Indice richiesto all'interno della matrice di trame.

[in] mipLevel

Tipo: UINT

Livello mip richiesto.

[in] sliceIndex

Tipo: UINT

Sezione richiesta all'interno della trama 3D.

[out] ppIBitmapFrame

Tipo: IWICBitmapFrameDecode**

Puntatore a un oggetto IWICBitmapFrameDecode .

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Un file DDS può contenere più immagini organizzate in una gerarchia a tre livelli. Per prima cosa, il file DDS può contenere più trame in una matrice di trame. In secondo luogo, ogni trama può avere più livelli mip. Infine, la trama può essere una trama 3D (volume) e avere più sezioni, ognuna delle quali è una trama 2D. Per altre informazioni, vedere la documentazione DDS .

WIC esegue il mapping di questa gerarchia a tre livelli in una matrice lineare di IWICBitmapFrameDecode, accessibile tramite IWICBitmapDecoder::GetFrame. Tuttavia, determinare quale frame corrisponde a un triade di arrayIndex, mipLevel e sliceIndex valore non è semplice perché ogni livello mip di una trama 3D ha una profondità diversa (numero di sezioni). Questo metodo offre maggiore praticità rispetto a IWICBitmapDecoder::GetFrame per le immagini DDS calcolando il frame corretto in base ai tre indici.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [app desktop | App UWP]
Server minimo supportato	Windows Server 2012 R2 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll

Vedi anche

CreateBitmap

ID3D11Device::CreateTexture2D

IWICDdsDecoder

WICDdsFormatInfo