Compartilhar via

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

  • Artigo

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