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 |