DitherType 列挙 (gdipluspixelformats.h)
DitherType 列挙は、ビットマップの変換時にディザリングに使用できるアルゴリズムを識別します。
Bitmap オブジェクトの Bitmap::ConvertFormat メソッドを呼び出すと、その Bitmap のピクセル形式が変更されます。 変換の結果、ビット深度が減少する (ピクセルあたりのビット数が少なくなる) 場合、元のビットマップ内の特定の色は、新しいピクセル形式で使用可能な色で構成されたディザー (チェッカーボード) パターンによってシミュレートされます。 DitherType 列挙体のメンバーは、このディザリングを実行するために使用できるアルゴリズムを識別します。
構文
typedef enum DitherType {
DitherTypeNone = 0,
DitherTypeSolid = 1,
DitherTypeOrdered4x4 = 2,
DitherTypeOrdered8x8 = 3,
DitherTypeOrdered16x16 = 4,
DitherTypeSpiral4x4 = 5,
DitherTypeSpiral8x8 = 6,
DitherTypeDualSpiral4x4 = 7,
DitherTypeDualSpiral8x8 = 8,
DitherTypeErrorDiffusion = 9,
DitherTypeMax = 10
} ;
定数
DitherTypeNone 値: 0 ディザリングは実行されません。 ソース ビットマップ内のピクセルは、Bitmap::ConvertFormat メソッドの palette パラメーターで指定されたパレットの最も近い色にマップされます。 このアルゴリズムは、任意のパレットで使用できます。 palette パラメーターで指定されたパレットに PaletteType 列挙に一覧表示されている標準の固定形式がない場合は、PaletteTypeCustom を palettetype パラメーターに渡します。 |
DitherTypeSolid 値: 1 ディザリングは実行されません。 ソース ビットマップ内のピクセルは、Bitmap::ConvertFormat メソッドの palette パラメーターで指定されたパレットの最も近い色にマップされます。 このアルゴリズムは、任意のパレットで使用できます。 palette パラメーターで指定されたパレットに PaletteType 列挙に一覧表示されている標準の固定形式がない場合は、PaletteTypeCustom を palettetype パラメーターに渡します。 |
DitherTypeOrdered4x4 値: 2 このアルゴリズムを使用すると、標準の固定パレットの 1 つの色に基づいてディザリングを実行できます。 このアルゴリズムを使用して、ビットマップをパレットのない 16 ビット/ピクセル形式に変換することもできます。 |
DitherTypeOrdered8x8 値: 3 ディザリングは、標準の固定パレットのいずれかで色を使用して実行されます。 |
DitherTypeOrdered16x16 値: 4 ディザリングは、標準の固定パレットのいずれかで色を使用して実行されます。 |
DitherTypeSpiral4x4 値: 5 ディザリングは、標準の固定パレットのいずれかで色を使用して実行されます。 |
DitherTypeSpiral8x8 値: 6 ディザリングは、標準の固定パレットのいずれかで色を使用して実行されます。 |
DitherTypeDualSpiral4x4 値: 7 ディザリングは、標準の固定パレットのいずれかで色を使用して実行されます。 |
DitherTypeDualSpiral8x8 値: 8 ディザリングは、標準の固定パレットのいずれかで色を使用して実行されます。 |
DitherTypeErrorDiffusion 値: 9 ディザリングは、Bitmap::ConvertFormat メソッドの palette パラメーターで指定されたパレットに基づいて実行されます。 このアルゴリズムは、任意のパレットで使用できます。 palette パラメーターで指定されたパレットに PaletteType 列挙に一覧表示されている標準の固定形式がない場合は、PaletteTypeCustom を palettetype パラメーターに渡します。 |
DitherTypeMax 値: 10 TBD |
解説
Bitmap::ConvertFormat メソッドの dithertype パラメーターに順序付けられたディザ型またはスパイラル ディザ型 (DitherTypeOrdered4x4 を除く) を渡す場合は、次のいずれかの固定パレット型を palettetype パラメーターに渡す必要があります。
- PaletteTypeFixedBW
- PaletteTypeFixedHalftone8
- PaletteTypeFixedHalftone27
- PaletteTypeFixedHalftone64
- PaletteTypeFixedHalftone125
- PaletteTypeFixedHalftone216
- PaletteTypeFixedHalftone252
- PaletteTypeFixedHalftone256
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
Header | gdipluspixelformats.h (Gdiplus.h を含む) |