Método IWICDdsDecoder::GetFrame (wincodec.h)

Recupera o quadro especificado da imagem DDS.

Sintaxe

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

Parâmetros

[in] arrayIndex

Tipo: UINT

O índice solicitado dentro da matriz de textura.

[in] mipLevel

Tipo: UINT

O nível de mip solicitado.

[in] sliceIndex

Tipo: UINT

A fatia solicitada dentro da textura 3D.

[out] ppIBitmapFrame

Tipo: IWICBitmapFrameDecode**

Um ponteiro para um objeto IWICBitmapFrameDecode .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Um arquivo DDS pode conter várias imagens organizadas em uma hierarquia de três níveis. Primeiro, o arquivo DDS pode conter várias texturas em uma matriz de textura. Em segundo lugar, cada textura pode ter vários níveis de mip. Por fim, a textura pode ser uma textura 3D (volume) e ter várias fatias, cada uma delas uma textura 2D. Consulte a documentação do DDS para obter mais informações.

O WIC mapeia essa hierarquia de três níveis em uma matriz linear de IWICBitmapFrameDecode, acessível por meio de IWICBitmapDecoder::GetFrame. No entanto, determinar qual quadro corresponde a uma tríade de arrayIndex, mipLevel e sliceIndex valor não é trivial porque cada nível mip de uma textura 3D tem uma profundidade diferente (número de fatias). Esse método fornece conveniência adicional sobre IWICBitmapDecoder::GetFrame para imagens DDS calculando o quadro correto considerando os três índices.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll

Confira também

Createbitmap

ID3D11Device::CreateTexture2D

IWICDdsDecoder

WICDdsFormatInfo