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
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | wincodec.h |
Library | Windowscodecs.lib |
Archivo DLL | Windowscodecs.dll |
Consulte también
Conceptual
Introducción a la codificación