Compartir a través de

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

  • Artículo

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:

Submuestreo cromático X Coordinate Y Coordinate Ancho cromático Alto cromático
4:2:0 Múltiplo de 2 Múltiplo de 2 lumaWidth / 2 Redondeado hasta el entero más cercano. lumaHeight / 2 Redondeado hasta el entero más cercano.
4:2:2 Múltiplo de 2 Any lumaWidth / 2 Redondeado hasta el entero más cercano. lumaHeight
4:4:4 Any Any llumaWidth llumaHeight
4:4:0 Any Múltiplo de 2 lumaWidth llumaHeight / 2 Redondeado hasta el entero más cercano.
 

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

Recuento de planos Plano 1 Plano 2 Plano 3
3 GUID_WICPixelFormat8bppY GUID_WICPixelFormat8bppCb GUID_WICPixelFormat8bppCr
2 GUID_WICPixelFormat8bppY GUID_WICPixelFormat16bppCbCr N/D

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado wincodec.h
Library Windowscodecs.lib
Archivo DLL Windowscodecs.dll

Consulte también

IWICPlanarBitmapSourceTransform