IWICBitmap

IWICBitmapSource に対して、書き込み可能性の概念と、ビットマップのメモリ内での静的な表現を追加するメソッドを定義します。

IWICBitmap は IWICBitmapSource を継承しており、そのため CopyPixels メソッドも継承します。 ピクセルを新しいメモリ位置へ移動する必要がある場合は、CopyPixels が最も効率的であることが多いです。

IWICBitmap が想定する内部的なメモリ表現があるため、Lock を用いたインプレースでの変更や処理は CopyPixels よりも効率的であり、通常はコピーではなく、ビットマップが所有するメモリへ直接アクセスする単純なポインタ操作に帰着します。 これは、CopyPixels のみを実装する手続き型ビットマップとは対照的です。手続き型ビットマップには内部的なメモリ表現が存在しないため、Lock の呼び出しに応えるにはその都度メモリ表現を生成する必要があります。

ビットマップの矩形領域へのアクセスを提供します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

ロックは書き込みに対しては排他的ですが、読み取りに対しては共有できます。IWICBitmap が書き込み用にロックされている間は CopyPixels を呼び出すことはできません。ロックは排他的であるため、呼び出すとエラーが返されます。

例

次の例では、IWICBitmap を作成し、IWICBitmapLock を使用して画像データをクリアします。

    IWICImagingFactory *pFactory = NULL;
    IWICBitmap *pBitmap = NULL;

    UINT uiWidth = 640;
    UINT uiHeight = 480;
    WICPixelFormatGUID formatGUID = GUID_WICPixelFormat32bppBGRA;

    WICRect rcLock = { 0, 0, uiWidth, uiHeight };
    IWICBitmapLock *pLock = NULL;

    HRESULT hr = CoCreateInstance(
        CLSID_WICImagingFactory,
        NULL,
        CLSCTX_INPROC_SERVER,
        IID_IWICImagingFactory,
        (LPVOID*)&pFactory
        );

    if (SUCCEEDED(hr))
    {
        hr = pFactory->CreateBitmap(uiWidth, uiHeight, formatGUID, WICBitmapCacheOnDemand, &pBitmap);
    }

    if (SUCCEEDED(hr))
    {
        hr = pBitmap->Lock(&rcLock, WICBitmapLockWrite, &pLock);

        if (SUCCEEDED(hr))
        {
            UINT cbBufferSize = 0;
            UINT cbStride = 0;
            BYTE *pv = NULL;

            hr = pLock->GetStride(&cbStride);

            if (SUCCEEDED(hr))
            {
                hr = pLock->GetDataPointer(&cbBufferSize, &pv);
            }

            // Clear the image data
            ZeroMemory(pv, cbBufferSize);

            // Release the bitmap lock.
            pLock->Release();
        }
    }

    if (pBitmap)
    {
        pBitmap->Release();
    }

    if (pFactory)
    {
        pFactory->Release();
    }

    return hr;

パレットを変更するためのアクセスを提供します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

画像の物理的な解像度を変更します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

このメソッドは、ビットマップに格納されている実際のピクセルやサンプルには影響しません。 代わりに、サンプリングレートの解釈が変更されます。 つまり、幅 96 ピクセルの 96 DPI 画像は 1 インチとなります。 物理的な解像度を 48 DPI に変更すると、そのビットマップは幅 2 インチと見なされますが、ピクセル数は同じままです。 解像度が REAL_EPSILON(1.192092896e-07F)未満の場合は、エラーコード WINCODEC_ERR_INVALIDPARAMETER が返されます。