IWICImagingFactory::CreateBitmapFromSourceRect メソッド (wincodec.h)

IWICBitmapSource の指定した四角形から IWICBitmap を作成します。

構文

HRESULT CreateBitmapFromSourceRect(
  [in]  IWICBitmapSource *pIBitmapSource,
  [in]  UINT             x,
  [in]  UINT             y,
  [in]  UINT             width,
  [in]  UINT             height,
  [out] IWICBitmap       **ppIBitmap
);

パラメーター

[in] pIBitmapSource

種類: IWICBitmapSource*

ビットマップの作成元となる IWICBitmapSource 。

[in] x

型: UINT

四角形の左上隅の水平方向の座標。

[in] y

型: UINT

四角形の左上隅の垂直方向の座標。

[in] width

型: UINT

四角形と新しいビットマップの幅。

[in] height

型: UINT

四角形と新しいビットマップの高さ。

[out] ppIBitmap

種類: IWICBitmap**

新しいビットマップへのポインターを受け取るポインター。

戻り値

種類: HRESULT

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

解説

ソースより大きい四角形を指定すると、未定義の結果が生成されます。

このメソッドは、キャッシュ オプション WICBitmapCacheOnLoad と同様に、ソース イメージの個別のコピーを常に作成します。

要件