IWICPlanarBitmapSourceTransform::D oesSupportTransform メソッド (wincodec.h)

  • [アーティクル]

このメソッドを使用して、目的の平面出力がサポートされているかどうかを判断し、呼び出し元が最適化されたコード パスを選択できるようにします。 それ以外の場合、呼び出し元は IWICBitmapSourceTransform または IWICBitmapSource にフォールバックし、インターリーブピクセルを取得する必要があります。

次の変換を確認できます。

  • WICBitmapTransformOptions を使用して指定された反転/回転オプションがサポートされているかどうかを確認します。
  • 要求された平面ピクセル形式の構成がサポートされているかどうかを確認します。
  • 目的のディメンションを指定して、実装がネイティブにスケーリングできる最も近いディメンションを決定します。

変換がサポートされている場合、このメソッドは pPlaneDescriptions パラメーターで結果の平面の説明を返します。

構文

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

パラメーター

[in, out] puiWidth

型: UINT*

入力時に、目的の幅。 出力時に、サポートされている幅が目的の幅に最も近い。これは、目的の幅と同じサイズまたは大きいサイズです。

[in, out] puiHeight

型: UINT*

入力時に必要な高さ。 出力では、サポートされている高さが目的の高さに最も近い。これは、目的の幅と同じサイズまたは大きいサイズです。

dstTransform

種類: WICBitmapTransformOptions

目的の回転または反転操作。 このフラグ パラメーターでは、複数の WICBitmapTransformOptions を組み合わせることができます。 「WICBitmapTransformOptions」を参照してください。

dstPlanarOptions

種類: WICPlanarOptions

変換の追加の構成オプションを指定するために使用します。 詳細については、「 WICPlanarOptions 」を参照してください。

WIC JPEG デコーダー:

WICPlanarOptionsPreserveSubsampling を指定すると、ダウンスケール時にサブサンプリングの比率を保持できます。 既定では、JPEG デコーダーは、場合によっては Y プレーンのみをダウンスケーリングして品質を維持しようとします。画像を 4:4:4 の彩度サブサンプリングに変更します。

[in] pguidDstFormats

型: const WICPixelFormatGUID*

それぞれの平面の要求されたピクセル形式。

[out] pPlaneDescriptions

種類: WICBitmapPlaneDescription*

*pfIsSupported == TRUE の場合、平面の説明の配列には、各平面のサイズと形式が含まれます。

WIC JPEG デコーダー: Cb プレーンと Cr プレーンは、彩度サブサンプリングによって puiWidth と puiHeight によって返される値とは異なるサイズにすることができます。

cPlanes

型: UINT

要求されたコンポーネント プレーンの数。

[out] pfIsSupported

種類: BOOL*

要求された変換がネイティブにサポートされている場合は、TRUE に設定します。

戻り値

型: HRESULT

pfIsSupported の値を調べて、変換が IWICPlanarBitmapSourceTransform::CopyPixels を介してサポートされているかどうかを確認します。 このメソッドが失敗した場合、幅、高さ、および平面の説明の出力パラメーターはゼロ初期化されます。 その他の戻り値は、エラーを示します。

要件

要件 値
サポートされている最小のクライアント Windows 8.1 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2012 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー wincodec.h
Library Windowscodecs.lib
[DLL] Windowscodecs.dll

こちらもご覧ください

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

WICPlanarOptions