Método IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)
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