ビットマップソースをクリップする方法

[アーティクル]
06/13/2023

このトピックでは、IWICBitmapClipper コンポーネントを使用して IWICBitmapSource の四角形の部分を取得する方法について説明します。

ビットマップソースをクリップするには

IWICImagingFactory オブジェクトを作成して、Windows イメージングコンポーネント (WIC) オブジェクトを作成します。

// Create WIC factory
hr = CoCreateInstance(
    CLSID_WICImagingFactory,
    NULL,
    CLSCTX_INPROC_SERVER,
    IID_PPV_ARGS(&m_pIWICFactory)
    );

CreateDecoderFromFilename メソッドを使用して、イメージファイルから IWICBitmapDecoder を作成します。

HRESULT hr = S_OK;

IWICBitmapDecoder *pIDecoder = NULL;
IWICBitmapFrameDecode *pIDecoderFrame  = NULL;

hr = m_pIWICFactory->CreateDecoderFromFilename(
   L"turtle.jpg",                  // Image to be decoded
   NULL,                           // Do not prefer a particular vendor
   GENERIC_READ,                   // Desired read access to the file
   WICDecodeMetadataCacheOnDemand, // Cache metadata when needed
   &pIDecoder                      // Pointer to the decoder
   );

イメージの最初の IWICBitmapFrameDecode を取得します。
```
// Retrieve the first bitmap frame.
if (SUCCEEDED(hr))
{
   hr = pIDecoder->GetFrame(0, &pIDecoderFrame);
}
```
JPEG ファイル形式では、1 つのフレームのみがサポートされます。この例のファイルは JPEG ファイルであるため、最初のフレーム (0) が使用されます。複数のフレームを持つイメージ形式については、「イメージの各フレームにアクセスするためのイメージのフレームを取得する方法」を参照してください。

画像のクリッピングに使用する IWICBitmapClipper を作成します。

IWICBitmapClipper *pIClipper = NULL;

if (SUCCEEDED(hr))
{
   hr = m_pIWICFactory->CreateBitmapClipper(&pIClipper);
}

ビットマップフレームの指定された四角形内のイメージデータを使用して、clipper オブジェクトを初期化します。

// Create the clipping rectangle.
WICRect rcClip = { 0, 0, uiWidth/2, uiHeight/2 };

// Initialize the clipper with the given rectangle of the frame's image data.
if (SUCCEEDED(hr))
{
   hr = pIClipper->Initialize(pIDecoderFrame, &rcClip);
}