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

彩度サブサンプリング	X 座標	Y 座標	彩度の幅	彩度の高さ
4:2:0	2 の倍数	2 の倍数	lumaWidth / 2 最も近い整数に切り上げられます。	lumaHeight / 2 最も近い整数に切り上げられます。
4:2:2	2 の倍数	Any	lumaWidth / 2 最も近い整数に切り上げられます。	lumaHeight
4:4:4	Any	Any	llumaWidth	llumaHeight
4:4:0	Any	2 の倍数	lumaWidth	llumaHeight / 2 最も近い整数に切り上げられます。

 

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

平面数	平面 1	平面 2	平面 3
3	GUID_WICPixelFormat8bppY	GUID_WICPixelFormat8bppCb	GUID_WICPixelFormat8bppCr
2	GUID_WICPixelFormat8bppY	GUID_WICPixelFormat16bppCbCr	N/A

必要条件

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

こちらもご覧ください

IWICPlanarBitmapSourceTransform