Bitmap::ConvertFormat メソッド (gdiplusheaders.h)

Bitmap::ConvertFormat メソッドは、ビットマップを指定したピクセル形式に変換します。 ビットマップ内の元のピクセル データは、新しいピクセル データに置き換えられます。

構文

Status ConvertFormat(
  [in] PixelFormat  format,
  [in] DitherType   dithertype,
  [in] PaletteType  palettetype,
  [in] ColorPalette *palette,
  [in] REAL         alphaThresholdPercent
);

パラメーター

[in] format

種類: PixelFormat

新しいピクセル形式を指定するピクセル形式定数。

[in] dithertype

種類: DitherType

ディザリング アルゴリズムを指定する DitherType 列挙体の要素。 変換によってピクセル データのビット深度が低下しない場合は、 DitherTypeNone を渡します。

[in] palettetype

種類: PaletteType

ディザリングに使用する標準パレットを指定する PaletteType 列挙体の要素。 インデックスなしの形式に変換する場合、このパラメーターは無視されます。 その場合は、 PaletteType 列挙体の任意の要素 ( PaletteTypeCustom など) を渡します。

[in] palette

種類: ColorPalette*

変換されたビットマップのピクセル データにインデックスを格納するパレットを指定する ColorPalette 構造体へのポインター。 このパレット (実際のパレットと呼ばれます) は、 palettetype パラメーターで指定された型を持つ必要はありません。 palettetype パラメーターは、順序付けされたディザリング アルゴリズムまたはスパイラル ディザリング アルゴリズムで使用できる標準パレットを指定します。 実際のパレットに palettetype パラメーターで指定された型以外の型がある場合、 Bitmap::ConvertFormat メソッドは標準パレットから実際のパレットへの最も近い色変換を実行します。

[in] alphaThresholdPercent

種類: REAL

変換されたビットマップ内の透明な色にマップするソース ビットマップ内のピクセルを指定する 0 ~ 100 の範囲の実数。 値 0 は、どのソース ピクセルも透明色にマップされないよう指定します。 値 100 は、完全に不透明でないピクセルが透明色にマップされることを指定します。 t の値は、完全に不透明な t% 未満のソース ピクセルが透明色にマップされることを指定します。 アルファしきい値を有効にするには、パレットの色が透明である必要があります。 パレットに透明色がない場合、アルファ値がしきい値を下回るピクセルは、通常は黒 (0、0、0、0) に最も近い色にマップされます。

戻り値

種類: 状態

メソッドが成功した場合は、Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusheaders.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

関連項目

Bitmap

Bitmap::InitializePalette