Metodo IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)

Articolo
08/27/2023

Usare questo metodo per determinare se è supportato un output planare desiderato e consentire al chiamante di scegliere un percorso di codice ottimizzato. In caso contrario, i chiamanti devono tornare a IWICBitmapSourceTransform o IWICBitmapSource e recuperare pixel interleaved.

È possibile controllare le trasformazioni seguenti:

Determinare se l'opzione flip/ruota specificata tramite WICBitmapTransformOptions è supportata.
Determinare se è supportata la configurazione del formato pixel planare richiesto.
Determinare le dimensioni più vicine che l'implementazione può ridimensionare in modo nativo in base alle dimensioni desiderate.

Quando è supportata una trasformazione, questo metodo restituisce la descrizione dei piani risultanti nel parametro pPlaneDescriptions .

Sintassi

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
);

Parametri

[in, out] puiWidth

Tipo: UINT*

In input, la larghezza desiderata. In output, la larghezza supportata più vicina alla larghezza desiderata; questa è la stessa dimensione o maggiore della larghezza desiderata.

[in, out] puiHeight

Tipo: UINT*

In input, l'altezza desiderata. Nell'output l'altezza supportata più vicina all'altezza desiderata; questa è la stessa dimensione o maggiore della larghezza desiderata.

dstTransform

Tipo: WICBitmapTransformOptions

Operazione di rotazione o capovolgimento desiderata. Più WICBitmapTransformOptions possono essere combinati in questo parametro flag, vedere WICBitmapTransformOptions.

dstPlanarOptions

Tipo: WICPlanarOptions

Usato per specificare opzioni di configurazione aggiuntive per la trasformazione. Per altre informazioni, vedere WICPlanarOptions .

Decodificatore JPEG WIC:

È possibile specificare WICPlanarOptionsPreserveSubsampling per mantenere le proporzioni di sottocampionamento durante la scalabilità inferiore. Per impostazione predefinita, il decodificatore JPEG tenta di mantenere la qualità riducendo la scalabilità solo del piano Y in alcuni casi, modificando l'immagine in sottocampionamento 4:4:4.

[in] pguidDstFormats

Tipo: const WICPixelFormatGUID*

Formati di pixel richiesti dei rispettivi piani.

[out] pPlaneDescriptions

Tipo: WICBitmapPlaneDescription*

Quando *pfIsSupported == TRUE, la matrice di descrizioni del piano contiene le dimensioni e il formato di ognuno dei piani.

Decodificatore WIC JPEG: i piani Cb e Cr possono essere una dimensione diversa dai valori restituiti da puiWidth e puiHeight a causa della subsampling di chroma.

cPlanes

Tipo: UINT

Numero di piani di componente richiesti.

[out] pfIsSupported

Tipo: BOOL*

Impostare su TRUE se le trasformazioni richieste sono supportate in modo nativo.

Valore restituito

Tipo: HRESULT

Controllare il valore di pfIsSupported per determinare se la trasformazione è supportata tramite IWICPlanarBitmapSourceTransform::CopyPixels. Se questo metodo ha esito negativo, i parametri di output per la larghezza, l'altezza e le descrizioni del piano sono zero inizializzati. Altri valori restituiti indicano un errore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll

Vedi anche

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

Condividi tramite