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

Recupera el marco especificado de la imagen DDS.

Sintaxis

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

Parámetros

[in] arrayIndex

Tipo: UINT

Índice solicitado dentro de la matriz de texturas.

[in] mipLevel

Tipo: UINT

Nivel mip solicitado.

[in] sliceIndex

Tipo: UINT

Segmento solicitado dentro de la textura 3D.

[out] ppIBitmapFrame

Tipo: IWICBitmapFrameDecode**

Puntero a un objeto IWICBitmapFrameDecode .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Un archivo DDS puede contener varias imágenes organizadas en una jerarquía de tres niveles. En primer lugar, el archivo DDS puede contener varias texturas en una matriz de texturas. En segundo lugar, cada textura puede tener varios niveles mip. Por último, la textura puede ser una textura 3D (volumen) y tener varios segmentos, cada uno de los cuales es una textura 2D. Consulte la documentación de DDS para obtener más información.

WIC asigna esta jerarquía de tres niveles a una matriz lineal de IWICBitmapFrameDecode, accesible a través de IWICBitmapDecoder::GetFrame. Sin embargo, determinar qué fotograma corresponde a una triad de arrayIndex, mipLevel y valor sliceIndex no es trivial porque cada nivel mip de una textura 3D tiene una profundidad diferente (número de segmentos). Este método proporciona comodidad adicional sobre IWICBitmapDecoder::GetFrame para imágenes DDS calculando el fotograma correcto según los tres índices.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll

Consulte también

CreateBitmap

ID3D11Device::CreateTexture2D

IWICDdsDecoder

WICDdsFormatInfo