Bitmap.ConvertFormat メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| 名前 | 説明 |
|---|---|
| ConvertFormat(PixelFormat) |
ビットマップを指定した |
| ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) |
指定した |
ConvertFormat(PixelFormat)
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
ビットマップを指定した formatに変換します。 元のピクセル データは、新しい形式に置き換えられます。
public:
void ConvertFormat(System::Drawing::Imaging::PixelFormat format);public void ConvertFormat(System.Drawing.Imaging.PixelFormat format);member this.ConvertFormat : System.Drawing.Imaging.PixelFormat -> unitPublic Sub ConvertFormat (format As PixelFormat)パラメーター
- format
- PixelFormat
新しいピクセル形式。
注釈
formatでは、Format16bppGrayScaleはサポートされていません。
適用対象
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
- ソース:
- Bitmap.cs
指定したformatを使用して、ビットマップを指定したditherTypeに変換します。 元のピクセル データは、新しい形式に置き換えられます。
public void ConvertFormat(System.Drawing.Imaging.PixelFormat format, System.Drawing.Imaging.DitherType ditherType, System.Drawing.Imaging.PaletteType paletteType = System.Drawing.Imaging.PaletteType.Custom, System.Drawing.Imaging.ColorPalette? palette = default, float alphaThresholdPercent = 0);member this.ConvertFormat : System.Drawing.Imaging.PixelFormat * System.Drawing.Imaging.DitherType * System.Drawing.Imaging.PaletteType * System.Drawing.Imaging.ColorPalette * single -> unitPublic Sub ConvertFormat (format As PixelFormat, ditherType As DitherType, Optional paletteType As PaletteType = System.Drawing.Imaging.PaletteType.Custom, Optional palette As ColorPalette = Nothing, Optional alphaThresholdPercent As Single = 0)パラメーター
- format
- PixelFormat
新しいピクセル形式。
- ditherType
- DitherType
ディザリング アルゴリズム。
- paletteType
- PaletteType
ピクセル形式にインデックスを付けるときに使用するパレットの種類。
- palette
- ColorPalette
変換されたビットマップのピクセル データにインデックスを格納するパレットを指定する ColorPalette へのポインター。 これは、インデックス付きピクセル形式に対して指定する必要があります。
- alphaThresholdPercent
- Single
変換されたビットマップの透明な色にマップするソース ビットマップ内のピクセルを指定する、0 ~ 100 の範囲の実数。
注釈
formatでは、Format16bppGrayScaleはサポートされていません。
ditherTypeの場合は、変換によってピクセル データのビット深度が低下しない場合に、Noneを渡します。
paletteTypeがCustomまたはFixedBlackAndWhiteの場合、これはSolidまたはErrorDiffusionである必要があります。
paletteType は、インデックスのないピクセル形式では無視されます。
palette (実際のパレットと呼ばれます) には、paletteType パラメーターで指定された型は必要ありません。
paletteType パラメーターは、順序付けされたディザリング アルゴリズムまたはスパイラル ディザリング アルゴリズムのいずれかで使用できる標準パレットを指定します。 実際のパレットに、 paletteType パラメーターで指定された型以外の型がある場合、 ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) は標準パレットから実際のパレットへの最も近い色変換を実行します。
alphaThresholdPercentの場合、値 0 は、どのソース ピクセルも透明色にマップされないよう指定します。 値 100 は、完全に不透明でないピクセルが透明色にマップされることを指定します。 t の値は、完全に不透明な t% 未満のソース ピクセルが透明色にマップされることを指定します。 アルファしきい値を有効にするには、パレットに透明な色が必要です。 パレットに透明な色がない場合、しきい値を下回るアルファ値を持つピクセルは、 (0, 0, 0, 0) (通常は黒) に最も近い色にマップされます。
paletteType と palette は、インデックス付きピクセル形式にのみ関連性があります。 インデックスのないピクセル形式の ColorPalette を渡すことができますが、変換に影響はなく、変換が完了したときにパレットを設定するために Palette を呼び出すだけで効果的です。
