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
ピクセル コピーの前に実行する目的の回転または反転。
変換は 、DoesSupportTransform 呼び出しでサポートされる操作である必要があります。
dstTransform を指定した場合、nStride は変換されたストライドであり、元のソースのピクセル形式ではなく pguidDstFormat ピクセル形式に基づいています。
[in] nStride
型: UINT
宛先バッファーのストライド。
[in] cbBufferSize
型: UINT
コピー先バッファーのサイズ。
[out] pbBuffer
型: BYTE*
出力バッファー。
戻り値
種類: HRESULT
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
コーデック開発者向け解説
prc に NULL が渡されると、イメージ全体がコピーされます。このメソッドのコーデック開発者実装の詳細については、「 IWICBitmapSourceTransform の実装」を参照してください。
複数の変換操作が要求されると、結果は操作が実行される順序に依存します。 CODEC 全体の予測可能性と一貫性を確保するには、すべての CODEC でこれらの操作を同じ順序で実行することが重要です。 これらの操作の推奨される順序は次のとおりです。
- スケール
- Crop
- 反転/回転
ピクセル形式の変換は、他の変換には影響を及ぼすので、いつでも実行できます。
最初のパラメーター prc を使用して、イメージをクリッピングする対象領域を指定します。 慣例により、スケーリングはクリッピングの前に実行されるため、イメージを拡大または縮小する場合は、イメージのスケーリング後に目的の領域を決定する必要があります。
dstTransform が指定されている場合、ストライドは変換されたストライドであり、元のフレームのピクセル形式ではなく、CopyPixels 呼び出しで指定された pixelFormat に基づいています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | WINDOWS XP と SP2、Windows Vista [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wincodec.h |
| Library | Windowscodecs.lib |
関連項目
概念