Método IWICPlanarBitmapSourceTransform::CopyPixels (wincodec.h)

Copia píxeles en los planos de destino. Configurado por los parámetros de entrada proporcionados.

Si se especifica una conversión de formato, escala o dstTransform, cbStride es el intervalo transformado y se basa en el formato de píxel de destino del parámetro pDstPlanes , no en el formato de píxel del origen original.

Sintaxis

HRESULT CopyPixels(
  [in] const WICRect             *prcSource,
       UINT                      uiWidth,
       UINT                      uiHeight,
       WICBitmapTransformOptions dstTransform,
  [in] WICPlanarOptions          dstPlanarOptions,
       const WICBitmapPlane      *pDstPlanes,
       UINT                      cPlanes
);

Parámetros

[in] prcSource

Tipo: const WICRect*

Rectángulo de origen de píxeles que se va a copiar.

uiWidth

Tipo: UINT

Ancho que se va a escalar el mapa de bits de origen. Este parámetro debe ser igual a un valor que se puede obtener mediante IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

uiHeight

Tipo: UINT

Alto para escalar el mapa de bits de origen. Este parámetro debe ser igual a un valor que se puede obtener mediante IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

dstTransform

Tipo: WICBitmapTransformOptions

Rotación deseada o volteo que se va a realizar antes de la copia de píxeles. Un giro se puede combinar con un volteo horizontal o vertical, consulta WICBitmapTransformOptions.

[in] dstPlanarOptions

Tipo: const WICPlanarOptions

Se usa para especificar opciones de configuración adicionales para la transformación. Consulte WICPlanarOptions para obtener más detalles.

Descodificador JPEG de WIC: WICPlanarOptionsPreserveSubsampling se puede especificar para conservar las relaciones de submuestreo al reducir el escalado. De forma predeterminada, el descodificador JPEG intenta conservar la calidad mediante el escalado descendente solo del plano Y en algunos casos, cambiando la imagen a submuestreo cromático 4:4:4.

pDstPlanes

Tipo: WICBitmapPlane

Especifica el formato de píxeles y el búfer de salida para cada plano de componente. El número de planos y formato de píxel de cada plano debe coincidir con los valores que se pueden obtener mediante IWICPlanarBitmapSourceTransform::D oesSupportTransform.

cPlanes

Tipo: UINT

Número de planos de componente especificados por el parámetro pDstPlanes .

Valor devuelto

Tipo: HRESULT

Si no se admite la configuración de escala, volteo/giro y formato planar especificado, este método produce un error WINCODEC_ERR_INVALIDPARAMETER. Puede comprobar si se admite una transformación llamando a IWICPlanarBitmapSourceTransform::D oesSupportTransform.

Comentarios

Descodificador JPEG de WIC: según el submuestreo cromático configurado de la imagen, el rectángulo de origen tiene las siguientes restricciones:

El parámetro pDstPlanes admite los siguientes formatos de píxeles.

Requisitos

Consulte también

IWICPlanarBitmapSourceTransform