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

Define a miniatura do quadro se houver suporte do codec.

Sintaxe

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Parâmetros

[in] pIThumbnail

Tipo: IWICBitmapSource*

A fonte de bitmap a ser usada como miniatura.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, um valor de erro.

Retorna WINCODEC_ERR_UNSUPPORTEDOPERATION se o recurso não tiver suporte do codificador.

Comentários

Recomendamos que você chame SetThumbnail antes de chamar WritePixels ou WriteSource. A miniatura não será adicionada ao arquivo codificado se SetThumbnail for chamado após uma chamada para WritePixels ou WriteSource.

• BMP, PNGNão há suporte para a configuração de miniaturas. Essa função retornará WINCODEC_ERR_UNSUPPORTEDOPERATION.
• JPEGHá suporte para a configuração da miniatura. A imagem de origem será recodificada como um JPEG de 8bpp ou 24bpp e será gravada no bloco de metadados APP1 do JPEG.
• TIFF Há suporte para a configuração da miniatura. A imagem de origem será recodificada como um TIFF e será gravada no bloco SubIFD do quadro.
• JPEG-XRHá suporte para a configuração da miniatura. A imagem de origem será recodificada como um quadro adicional de 8bpp ou 24bpp.

Requisitos

Confira também

Conceitual

Visão geral da codificação

Como escrever um CODEC WIC-Enabled

Iwicbitmapframeencode