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

指定された入力パラメーターを使用してピクセル データをコピーします。

構文

HRESULT CopyPixels(
  [in]  const WICRect             *prc,
  [in]  UINT                      uiWidth,
  [in]  UINT                      uiHeight,
  [in]  WICPixelFormatGUID        *pguidDstFormat,
  [in]  WICBitmapTransformOptions dstTransform,
  [in]  UINT                      nStride,
  [in]  UINT                      cbBufferSize,
  [out] BYTE                      *pbBuffer
);

パラメーター

[in] prc

型: const WICRect*

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

[in] uiWidth

型: UINT

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

[in] uiHeight

型: UINT

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

[in] pguidDstFormat

種類: WICPixelFormatGUID*

ピクセルを返す必要がある目的のピクセル形式の GUID。

この GUID は、 GetClosestPixelFormat 呼び出しによって取得される形式である必要があります。

[in] dstTransform

種類: WICBitmapTransformOptions

ピクセル コピーの前に実行する目的の回転または反転。

変換は 、DoesSupportTransform 呼び出しでサポートされる操作である必要があります。

dstTransform を指定した場合、nStride は変換されたストライドであり、元のソースのピクセル形式ではなく pguidDstFormat ピクセル形式に基づいています。

[in] nStride

型: UINT

宛先バッファーのストライド。

[in] cbBufferSize

型: UINT

コピー先バッファーのサイズ。

[out] pbBuffer

型: BYTE*

出力バッファー。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

コーデック開発者向け解説

このメソッドのコーデック開発者実装の詳細については、「 IWICBitmapSourceTransform の実装」を参照してください。

複数の変換操作が要求されると、結果は操作が実行される順序に依存します。 CODEC 全体の予測可能性と一貫性を確保するには、すべての CODEC でこれらの操作を同じ順序で実行することが重要です。 これらの操作の推奨される順序は次のとおりです。

1. スケール
2. Crop
3. 反転/回転

ピクセル形式の変換は、他の変換には影響を及ぼすので、いつでも実行できます。

最初のパラメーター prc を使用して、イメージをクリッピングする対象領域を指定します。 慣例により、スケーリングはクリッピングの前に実行されるため、イメージを拡大または縮小する場合は、イメージのスケーリング後に目的の領域を決定する必要があります。

dstTransform が指定されている場合、ストライドは変換されたストライドであり、元のフレームのピクセル形式ではなく、CopyPixels 呼び出しで指定された pixelFormat に基づいています。

要件

関連項目

概念

IWICBitmapSourceTransform

Microsoft Windows Imaging Codec

プログラミング ガイド

参照

サンプルとコード例