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