IWICPalette

カラーテーブルへのアクセスおよび構築を行うためのメソッドを公開します。主にインデックス付きピクセル形式向けです。

WICBitmapPaletteType が WICBitmapPaletteCustom でない場合、色は上記のテーブルに基づいて自動的に生成されます。ユーザーがその後カラーパレットのエントリを変更すると、その操作によって WICBitmapPalette は Custom に設定されます。

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

パレットインターフェイスは補助的なイメージングインターフェイスであり、ビットマップやピクセルを直接扱うものではありません。むしろ、インデックス付きビットマップに対してインデックス色変換を提供します。1 ピクセルあたり 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);

                    // ここで色を使って何らかの処理を行う...

                    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 として型定義しています。

WICBitmapPaletteType で指定された事前定義パレットのいずれかにパレットを初期化し、オプションで透明色を追加します。

型: HRESULT

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

パレットに透明色が追加されると、そのパレットは事前定義ではなくなり、WICBitmapPaletteTypeCustom として返されます。256 エントリ未満のパレットの場合、透明エントリはパレットの末尾に追加されます(つまり、16 色パレットは 17 色パレットになります)。256 色のパレットの場合、透明パレットエントリは事前定義パレットの最後のエントリを置き換えます。

指定されたカスタムカラーエントリにパレットを初期化します。

型: HRESULT

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

透明色が必要な場合は、カスタムエントリの一部として指定します。パレットに透明値を追加するには、そのアルファ値を 0 にする必要があります(0x00RRGGBB)。

エントリ数は 256 に制限されています。

参照ビットマップに基づいて計算された最適化された値を使用してパレットを初期化します。

型: HRESULT

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

結果として得られるパレットには、ビットマップ内に存在する色を最もよく表現する、指定された数の色が含まれます。アルゴリズムは参照ビットマップの各ピクセルの不透明な RGB カラー値に対して動作するため、アルファ値は無視されます。透明色が必要な場合は、fAddTransparentColor パラメーターを TRUE に設定します。その場合、最適化される色が 1 つ少なく計算されて colorCount が減り、完全に透明なカラーエントリが追加されます。

指定されたパレットに基づいてパレットを初期化します。

型: HRESULT

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

パレットを記述する WICBitmapPaletteType を取得します。

型: HRESULT

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

WICBitmapPaletteCustom は、InitializeCustom と InitializeFromBitmap の両方から初期化されたパレットに使用されます。最適化パレットとカスタムパレットの区別はありません。

カラーテーブル内の色数を取得します。

型: HRESULT

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

指定されたカラー配列を、内部カラーテーブルの色で埋めます。カラー配列は GetColorCount の戻り結果に従ってサイズを設定する必要があります。

型: HRESULT

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

パレットが白黒であるかどうかを示す値を取得します。

型: HRESULT

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

パレットが白黒とみなされるのは、完全な黒(0xFF000000)と完全な白(0xFFFFFFF)の 2 つのエントリのみを含む場合に限られます。

パレットがグレースケールであるかどうかを示す値を取得します。

型: HRESULT

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

パレットがグレースケールとみなされるのは、すべてのエントリについてアルファ値が 0xFF であり、赤・緑・青の値が一致する場合に限られます。

パレットに不透明でないエントリ(すなわちアルファが 1 未満のエントリ)が含まれているかどうかを示します。

型: HRESULT

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

さまざまな画像形式が、それぞれ異なる方法でアルファをサポートしています。PNG は部分的に透明なパレットエントリをサポートすることで、完全なアルファサポートを備えています。GIF は色をアルファなしの 24bpp で格納しますが、1 つのパレットエントリを完全に透明として指定できます。パレットに複数の完全透明エントリ(0x00RRGGBB)がある場合、GIF は最後のものを透明インデックスとして使用します。