Bitmap.ConvertFormat メソッド

定義

名前空間:

System.Drawing

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v11.0.0-preview.4.26230.115

オーバーロード

名前	説明
ConvertFormat(PixelFormat)	ビットマップを指定した formatに変換します。 元のピクセル データは、新しい形式に置き換えられます。
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)	指定したformatを使用して、ビットマップを指定したditherTypeに変換します。 元のピクセル データは、新しい形式に置き換えられます。

ConvertFormat(PixelFormat)

ソース:

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 -> unit

Public Sub ConvertFormat (format As PixelFormat)

パラメーター

format

PixelFormat

新しいピクセル形式。

注釈

formatでは、Format16bppGrayScaleはサポートされていません。

ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)

ソース:

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 -> unit

Public 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 を呼び出すだけで効果的です。