IWICPlanarBitmapSourceTransform::CopyPixels メソッド (wincodec.h)

コピー先の平面にピクセルをコピーします。 指定された入力パラメーターによって構成されます。

dstTransform、scale、または format 変換を指定した場合、cbStride は変換されたストライドであり、元のソースのピクセル形式ではなく、pDstPlanes パラメーターのターゲット ピクセル形式に基づいています。

構文

HRESULT CopyPixels(
  [in] const WICRect             *prcSource,
       UINT                      uiWidth,
       UINT                      uiHeight,
       WICBitmapTransformOptions dstTransform,
  [in] WICPlanarOptions          dstPlanarOptions,
       const WICBitmapPlane      *pDstPlanes,
       UINT                      cPlanes
);

パラメーター

[in] prcSource

型: const WICRect*

コピーするピクセルのソース四角形。

uiWidth

型: UINT

ソース ビットマップをスケーリングする幅。 このパラメーターは、 IWICPlanarBitmapSourceTransform:: DoesSupportTransform を介して取得できる値と等しい必要があります。

uiHeight

型: UINT

ソース ビットマップをスケーリングする高さ。 このパラメーターは、 IWICPlanarBitmapSourceTransform:: DoesSupportTransform を介して取得できる値と等しい必要があります。

dstTransform

種類: WICBitmapTransformOptions

ピクセル コピーの前に実行する目的の回転または反転。 回転は、左右反転または垂直反転と組み合わせることができます。 「WICBitmapTransformOptions」を参照してください。

[in] dstPlanarOptions

型: const WICPlanarOptions

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

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

pDstPlanes

種類: WICBitmapPlane

各コンポーネント プレーンのピクセル形式と出力バッファーを指定します。 各平面の平面数とピクセル形式は、 IWICPlanarBitmapSourceTransform::D oesSupportTransform を介して取得できる値と一致する必要があります。

cPlanes

型: UINT

pDstPlanes パラメーターで指定されたコンポーネント 平面の数。

戻り値

型: HRESULT

指定したスケール、反転/回転、および平面形式の構成がサポートされていない場合、このメソッドは WINCODEC_ERR_INVALIDPARAMETERで失敗します。 変換がサポートされているかどうかをチェックするには、IWICPlanarBitmapSourceTransform::D oesSupportTransform を呼び出します。

注釈

WIC JPEG デコーダー: イメージの構成済みの彩度サブサンプリングに応じて、ソース四角形には次の制限があります。

pDstPlanes パラメーターは、次のピクセル形式をサポートしています。

必要条件

こちらもご覧ください

IWICPlanarBitmapSourceTransform