Compartir a través de

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

  • Artículo

Codifica un origen de mapa de bits.

Sintaxis

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

Parámetros

[in] pIBitmapSource

Tipo: IWICBitmapSource*

Origen del mapa de bits que se va a codificar.

[in] prc

Tipo: WICRect*

Rectángulo de tamaño del origen del mapa de bits.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Si no se llama a SetSize antes de llamar a WriteSource, se usa el tamaño especificado en prc si no es NULL. De lo contrario, se usa el tamaño de IWICBitmapSource proporcionado en pIBitmapSource .

Si no se llama a SetPixelFormat antes de llamar a WriteSource, se usa el formato de píxel de IWICBitmapSource proporcionado en pIBitmapSource .

Si no se llama a SetResolution antes de llamar a WriteSource, se usa el formato de píxel de pIBitmapSource .

Si no se llama a SetPalette antes de llamar a WriteSource, se indexa el formato de píxel de destino y el formato de píxel de pIBitmapSource coincide con el formato de píxel del fotograma del codificador, se usa el formato de píxel pIBitmapSource .

Al codificar una imagen GIF, si se establece la paleta global y el usuario no establece directamente la paleta de nivel de marco o un códec GIF del proveedor de software independiente personalizado (ISV), WriteSource usará la paleta global para codificar el marco incluso cuando pIBitmapSource tenga una paleta de niveles de marco.

A partir de Windows Vista, se pueden realizar llamadas WriteSource repetidas siempre que el alto total acumulado de rect de origen sea el mismo que establecido a través de SetSize.

A partir de Windows 8.1, el rect. de origen debe ser al menos las dimensiones establecidas a través de SetSize. Si el ancho de la corrección de origen supera el ancho SetSize , se omiten los píxeles adicionales del lado derecho. Si el alto del rect de origen supera el alto restante no rellenado, se omiten las líneas de examen adicionales de la parte inferior.

Requisitos

   
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

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

IWICBitmapFrameEncode

Información general del componente de creación de imágenes de Windows