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

Copia pixels para os planos de destino. Configurado pelos parâmetros de entrada fornecidos.

Se uma conversão dstTransform, scale ou format for especificada, cbStride será o passo transformado e será baseado no formato de pixel de destino do parâmetro pDstPlanes , não no formato de pixel da origem original.

Sintaxe

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*

O retângulo de origem de pixels a serem copiados.

uiWidth

Tipo: UINT

A largura para dimensionar o bitmap de origem. Esse parâmetro deve ser igual a um valor obtido por meio de IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

uiHeight

Tipo: UINT

A altura para dimensionar o bitmap de origem. Esse parâmetro deve ser igual a um valor obtido por meio de IWICPlanarBitmapSourceTransform:: DoesSupportTransform.

dstTransform

Tipo: WICBitmapTransformOptions

A rotação ou inversão desejada para executar antes da cópia de pixel. Uma rotação pode ser combinada com um inverter horizontal ou um inverter vertical, consulte WICBitmapTransformOptions.

[in] dstPlanarOptions

Tipo: const WICPlanarOptions

Usado para especificar opções de configuração adicionais para a transformação. Consulte WICPlanarOptions para obter mais detalhes.

Wic JPEG Decoder: WICPlanarOptionsPreserveSubsampling pode ser especificado para manter as taxas de subampling durante o downscaling. Por padrão, o decodificador JPEG tenta preservar a qualidade reduzindo apenas o plano Y em alguns casos, alterando a imagem para subampa de chroma 4:4:4.

pDstPlanes

Tipo: WICBitmapPlane

Especifica o formato de pixel e o buffer de saída para cada plano de componente. O número de planos e o formato de pixel de cada plano devem corresponder aos valores obtidos por meio de IWICPlanarBitmapSourceTransform::D oesSupportTransform.

cPlanes

Tipo: UINT

O número de planos de componente especificados pelo parâmetro pDstPlanes .

Retornar valor

Tipo: HRESULT

Se não houver suporte para a configuração de escala, inverter/girar e formato planar especificados, esse método falhará com WINCODEC_ERR_INVALIDPARAMETER. Você pode marcar se houver suporte para uma transformação chamando IWICPlanarBitmapSourceTransform::D oesSupportTransform.

Comentários

Decodificador WIC JPEG: dependendo da subampa do chroma configurada da imagem, o retângulo de origem tem as seguintes restrições:

Subampling chroma	Coordenada X	Coordenada Y	Largura do Chroma	Altura de Chroma
4:2:0	Múltiplo de 2	Múltiplo de 2	lumaWidth / 2 Arredondado até o inteiro mais próximo.	lumaHeight / 2 Arredondado até o inteiro mais próximo.
4:2:2	Múltiplo de 2	Qualquer	lumaWidth / 2 Arredondado até o inteiro mais próximo.	lumaHeight
4:4:4	Qualquer	Qualquer	llumaWidth	llumaHeight
4:4:0	Qualquer	Múltiplo de 2	lumaWidth	llumaHeight / 2 Arredondado até o inteiro mais próximo.

 

O parâmetro pDstPlanes dá suporte aos seguintes formatos de pixel.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll

Confira também

IWICPlanarBitmapSourceTransform