Compartilhar via


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

Codifica uma fonte de bitmap.

Sintaxe

HRESULT WriteSource(
  [in] IWICBitmapSource *pIBitmapSource,
  [in] WICRect          *prc
);

Parâmetros

[in] pIBitmapSource

Tipo: IWICBitmapSource*

A origem do bitmap a ser codificada.

[in] prc

Tipo: WICRect*

O retângulo de tamanho da origem do bitmap.

Valor retornado

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

Se SetSize não for chamado antes de chamar WriteSource, o tamanho especificado em prc será usado se não for NULL. Caso contrário, o tamanho da IWICBitmapSource fornecida em pIBitmapSource será usado.

Se SetPixelFormat não for chamado antes de chamar WriteSource, o formato de pixel da IWICBitmapSource fornecida em pIBitmapSource será usado.

Se SetResolution não for chamado antes de chamar WriteSource, o formato de pixel de pIBitmapSource será usado.

Se SetPalette não for chamado antes de chamar WriteSource, o formato de pixel de destino será indexado e o formato de pixel de pIBitmapSource corresponderá ao formato de pixel do quadro do codificador, o formato de pixel pIBitmapSource será usado.

Ao codificar uma imagem GIF, se a paleta global estiver definida e a paleta de nível de quadro não for definida diretamente pelo usuário ou por um codec GIF isv (fornecedor independente de software) personalizado, WriteSource usará a paleta global para codificar o quadro mesmo quando pIBitmapSource tiver uma paleta de nível de quadro.

A partir do Windows Vista, chamadas repetidas writesource podem ser feitas desde que a altura total acumulada do rect de origem seja a mesma definida por meio de SetSize.

Começando com Windows 8.1, o rect de origem deve ser pelo menos as dimensões definidas por meio de SetSize. Se a largura do rect de origem exceder a largura setSize , pixels extras no lado direito serão ignorados. Se a altura do rect de origem exceder a altura não preenchida restante, as linhas de verificação extras na parte inferior serão ignoradas.

Requisitos

   
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho wincodec.h
Biblioteca Windowscodecs.lib
DLL Windowscodecs.dll

Confira também

Conceitual

Como escrever um CODEC WIC-Enabled

Iwicbitmapframeencode

Visão geral do componente de imagem do Windows