IWICFormatConverter

画像データをあるピクセル形式から別のピクセル形式へ変換する IWICBitmapSource を表します。インデックス形式へのディザリングやハーフトーン処理、パレット変換、アルファしきい値処理を扱います。

フォーマットコンバーターを初期化します。

型: HRESULT

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

事前定義されたパレットがない場合は、まずパレットを作成する必要があります。InitializeFromBitmap を使用してパレットオブジェクトを作成し、それを他のパラメーターとともに渡してください。

dither、pIPalette、alphaThresholdPercent、paletteTranslate は、ビット深度を下げた形式へ変換する際の色の損失を軽減するために使用されます。これらの設定を必要としない変換では、次のパラメーター値を使用してください。dither を WICBitmapDitherTypeNone に、pIPalette を NULL に、alphaThresholdPercent を 0.0f に、paletteTranslate を WICBitmapPaletteTypeCustom に設定します。

順序付きディザ (ordered dither) を使用する際の基本的なアルゴリズムでは、WICBitmapPaletteType 列挙型にある固定パレットを、特定の順序で使用する必要があります。

多くの場合、出力用に実際に提供されるパレットは、異なる順序であったり、実際の色にわずかな違いがあったりします。これは、Windows のバージョン間でわずかな違いがある Microsoft Windows パレットを使用する場合に当てはまります。この問題に対応するため、フォーマットコンバーターにはパレットとパレット変換が渡されます。pIPalette は実際に使用される変換先パレットであり、paletteTranslate は固定パレットです。変換が完了すると、最近傍色マッチングアルゴリズムを使用して、固定パレットの色が pIPalette の実際の色にマッピングされます。

pIPalette の色が paletteTranslate の色と十分に一致しない場合、マッピングによって望ましくない結果が生じることがあります。

WICBitmapDitherTypeOrdered4x4 は、8 ビット形式から 5 ビットまたは 6 ビット形式への変換で、色データを正確に変換する方法がない場合に役立つことがあります。

WICBitmapDitherTypeErrorDiffusion は誤差拡散アルゴリズムを選択し、任意のパレットと併用できます。任意のパレットを指定する場合は、paletteTranslate として WICBitmapPaletteCustom を渡してください。誤差拡散は、特に IWICPalette の最適化されたパレット生成機能と組み合わせた場合に、順序付きディザリングアルゴリズムよりも優れた結果をもたらすことがよくあります。

Portable Network Graphics (PNG) のようにアルファチャンネルを持つビットマップを 8bpp に変換する場合、通常アルファチャンネルは無視されます。元のビットマップで透明だったピクセルは、最終出力で黒として現れます。これは、それぞれの形式において透明と黒の両方がピクセル値ゼロを持つためです。

一部の 8bpp コンテンツにはアルファ色を含めることができます。たとえば Graphics Interchange Format (GIF) 形式では、単一のパレットエントリを透明色として使用できます。 この種のコンテンツでは、alphaThresholdPercent によって、どの程度の透明度を透明色にマッピングするかを指定します。アルファ値はピクセルの (透明度ではなく) 不透明度に正比例するため、alphaThresholdPercent はどのレベルの不透明度を完全に透明な色にマッピングするかを示します。

たとえば 9.8% は、アルファ値が 25 未満のピクセルはすべて透明色にマッピングされることを意味します。100% の値は、完全に不透明でないすべてのピクセルを透明色にマッピングします。パレットには透明色を用意しておく必要があることに注意してください。用意されていない場合、「透明」色はゼロに最も近い色 (多くの場合は黒) になります。

例

次の例では、画像フレームをディザリングやアルファしきい値なしで 32bppPBGRA 形式に変換します。Direct2D では、レンダリングのためにビットマップソースが 32bppPBGRA 形式である必要があります。IWICFormatConverter の使用方法を示す完全なサンプルについては、WIC Image Viewer Using Direct2D Sample を参照してください。

HRESULT hr = S_OK;

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

// Create the decoder.
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
   );

// Retrieve the first bitmap frame.
if (SUCCEEDED(hr))
{
   hr = pIDecoder->GetFrame(0, &pIDecoderFrame);
}


// Create the flip/rotator.
if (SUCCEEDED(hr))
{
   hr = m_pIWICFactory->CreateFormatConverter(&pIFormatConverter);
}

// Initialize the format converter.
if (SUCCEEDED(hr))
{
   hr = pIFormatConverter->Initialize(
       pIDecoderFrame,                  // Input source to convert
       GUID_WICPixelFormat32bppPBGRA,   // Destination pixel format
       WICBitmapDitherTypeNone,         // Specified dither pattern
       NULL,                            // Specify a particular palette 
       0.f,                             // Alpha threshold
       WICBitmapPaletteTypeCustom       // Palette translation type
       );
}
//Create render target and D2D bitmap from IWICBitmapSource
if (SUCCEEDED(hr))
{
   hr = CreateDeviceResources(hWnd);
}

if (SUCCEEDED(hr))
{
   // Need to release the previous D2DBitmap if there is one
   SafeRelease(&m_pD2DBitmap);
   hr = m_pRT->CreateBitmapFromWicBitmap(pIFormatConverter, NULL, &m_pD2DBitmap);
}

SafeRelease(&pIFormatConverter);
SafeRelease(&pIDecoderFrame);
SafeRelease(&pIDecoder);

変換元のピクセル形式を変換先のピクセル形式に変換できるかどうかを判定します。

型: HRESULT

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