Método IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)

Artigo
03/09/2024

Use esse método para determinar se há suporte para uma saída planar desejada e permitir que o chamador escolha um caminho de código otimizado se for. Caso contrário, os chamadores devem fazer fallback para IWICBitmapSourceTransform ou IWICBitmapSource e recuperar pixels intercalados.

As seguintes transformações podem ser verificadas:

Determine se há suporte para a opção de inverter/girar especificada por meio de WICBitmapTransformOptions .
Determine se há suporte para a configuração de formato de pixel planar solicitado.
Determine as dimensões mais próximas para as quais a implementação pode ser dimensionada nativamente para determinadas dimensões desejadas.

Quando há suporte para uma transformação, esse método retorna a descrição dos planos resultantes no parâmetro pPlaneDescriptions .

Sintaxe

HRESULT DoesSupportTransform(
  [in, out] UINT                      *puiWidth,
  [in, out] UINT                      *puiHeight,
            WICBitmapTransformOptions dstTransform,
            WICPlanarOptions          dstPlanarOptions,
  [in]      const WICPixelFormatGUID  *pguidDstFormats,
  [out]     WICBitmapPlaneDescription *pPlaneDescriptions,
            UINT                      cPlanes,
  [out]     BOOL                      *pfIsSupported
);

Parâmetros

[in, out] puiWidth

Tipo: UINT*

Na entrada, a largura desejada. Na saída, a largura mais próxima com suporte para a largura desejada; esse é o mesmo tamanho ou maior que a largura desejada.

[in, out] puiHeight

Tipo: UINT*

Na entrada, a altura desejada. Na saída, a altura com suporte mais próxima da altura desejada; esse é o mesmo tamanho ou maior que a largura desejada.

dstTransform

Tipo: WICBitmapTransformOptions

A operação de rotação ou inversão desejada. Vários WICBitmapTransformOptions podem ser combinados nesse parâmetro de sinalizador, consulte WICBitmapTransformOptions.

dstPlanarOptions

Tipo: WICPlanarOptions

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

Decodificador WIC JPEG:

WICPlanarOptionsPreserveSubsampling pode ser especificado para manter as taxas de subampasagem 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.

[in] pguidDstFormats

Tipo: const WICPixelFormatGUID*

Os formatos de pixel solicitados dos respectivos planos.

[out] pPlaneDescriptions

Tipo: WICBitmapPlaneDescription*

Quando *pfIsSupported == TRUE, a matriz de descrições do plano contém o tamanho e o formato de cada um dos planos.

Decodificador WIC JPEG: os planos Cb e Cr podem ter um tamanho diferente dos valores retornados por puiWidth e puiHeight devido à subampação chroma.

cPlanes

Tipo: UINT

O número de planos de componente solicitados.

[out] pfIsSupported

Tipo: BOOL*

Defina como TRUE se as transformações solicitadas tiverem suporte nativo.

Retornar valor

Tipo: HRESULT

Verifique o valor de pfIsSupported para determinar se a transformação tem suporte por meio de IWICPlanarBitmapSourceTransform::CopyPixels. Se esse método falhar, os parâmetros de saída para as descrições de largura, altura e plano não serão inicializados. Outros valores retornados indicam falha.

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

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

Share via