Método IWICBitmapFrameEncode::SetThumbnail (wincodec.h)

Establece la miniatura del marco si es compatible con el códec.

Sintaxis

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parámetros

[in] pIThumbnail

Tipo: IWICBitmapSource*

Origen del mapa de bits que se va a usar como miniatura.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error.

Devuelve WINCODEC_ERR_UNSUPPORTEDOPERATION si el codificador no admite la característica.

Comentarios

Se recomienda llamar a SetThumbnail antes de llamar a WritePixels o WriteSource. La miniatura no se agregará al archivo codificado si se llama a SetThumbnail después de una llamada a WritePixels o WriteSource.

• BMP, PNGNo se admite la configuración de miniaturas. Esta función devolverá WINCODEC_ERR_UNSUPPORTEDOPERATION.
• JPEGSe admite la configuración de la miniatura. La imagen de origen se volverá a codificar como un JPEG de 8bpp o 24bpp y se escribirá en el bloque de metadatos APP1 de JPEG.
• TIFF Se admite la configuración de la miniatura. La imagen de origen se volverá a codificar como un TIFF y se escribirá en el bloque SubIFD del marco.
• JPEG-XRSe admite la configuración de la miniatura. La imagen de origen se volverá a codificar como un marco adicional de 8bpp o 24bpp.

Requisitos

Consulte también

Conceptual

Introducción a la codificación

Cómo escribir un CÓDEC de WIC-Enabled

IWICBitmapFrameEncode