IWICPalette インターフェイス (wincodec.h)

主にインデックス付きピクセル形式のカラー テーブルにアクセスして構築するためのメソッドを公開します。

継承

IWICPalette インターフェイスは、IUnknown インターフェイスから継承されます。 IWICPalette には、次の種類のメンバーもあります。

メソッド

IWICPalette インターフェイスには、これらのメソッドがあります。

注釈

WICBitmapPaletteType が WICBitmapPaletteCustom でない場合は、上の表に基づいて色が自動的に生成されます。 ユーザーが後でカラー パレット エントリを変更した場合、WICBitmapPalette はそのアクションによって Custom に設定されます。

InitializeFromBitmap の fAddTransparentColor パラメーターは、サイズが 256 未満の場合は、色コレクションの末尾に透明色を追加します。それ以外の場合、インデックス 255 は透明色に置き換えられます。 定義済みのパレットの種類を使用すると、定義済みのパレットと一致しなくなったため、BitmapPaletteTypeCustom に変更されます。

パレットインターフェイスは、ビットマップとピクセルに直接関心を持たないという点で補助イメージングインターフェイスです。代わりに、インデックス付きビットマップのインデックス付き色変換が提供されます。 ピクセルあたりの M ビット数を持つインデックス付きピクセル形式の場合: (パレット内の色の数) が 2^M を超えています。

従来、パレットの基本的な操作は、バイト (または小さい) インデックスから 32bpp カラー値への変換を提供することです。 これは、多くの場合、カラー値の 256 エントリ テーブルによって実現されます。

例

    IWICImagingFactory *pFactory = NULL;
    IWICBitmapDecoder *pDecoder = NULL;
    IWICBitmapFrameDecode *pBitmapFrameDecode = NULL;
    IWICPalette *pPalette = NULL;

    UINT uiFrameCount = 0;

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

    if (SUCCEEDED(hr))
    {
        hr = pFactory->CreateDecoderFromFilename(
                           L"test.gif",
                           NULL,
                           GENERIC_READ,
                           &pDecoder);
    }

    if (SUCCEEDED(hr))
    {
        hr = pDecoder->GetFrameCount(&uiFrameCount);
    }

    if (SUCCEEDED(hr) && (uiFrameCount > 0))
    {
        hr = pDecoder->GetFrame(0, &pBitmapFrameDecode);

        if (SUCCEEDED(hr))
        {
            hr = pFactory->CreatePalette(&pPalette);
        }

        if (SUCCEEDED(hr))
        {
            hr = pBitmapFrameDecode->CopyPalette(pPalette);
        }

        if (SUCCEEDED(hr))
        {
            UINT uiColorCount = 0;
            UINT uiActualColorCount = 0;
            WICColor *pColors = NULL;

            hr = pPalette->GetColorCount(&uiColorCount);

            if (SUCCEEDED(hr) && (uiColorCount > 0))
            {
                pColors = new WICColor[uiColorCount];

                if (pColors)
                {
                    hr = pPalette->GetColors(uiColorCount, pColors, &uiActualColorCount);

                    // Do something with the colors here...

                    delete[] pColors;
                }
                else
                {
                    hr = E_OUTOFMEMORY;
                }
            }
        }
    }

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

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

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

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

    return hr;

このコード例では、 WICColor は次のレイアウトの UINT32 値として定義されています。

0xAARRGGBB

wincodec.h ヘッダーの種類は 、WICColor を UINT32 として定義します。

要件