次の方法で共有

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