Bitmap.ConvertFormat Метод

Определение

Пространство имен:

System.Drawing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v11.0.0-preview.5.26302.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

Алгоритм dithering.

paletteType

PaletteType

Тип палитры, используемый при индексировании формата пикселей.

palette

ColorPalette

Указатель на ColorPalette палитру, индексы которой хранятся в пиксельных данных преобразованного растрового изображения. Это необходимо указать для индексированных форматов пикселей.

alphaThresholdPercent

Single

Реальное число в диапазоне от 0 до 100, указывающее, какие пиксели в исходном растровом рисунке сопоставляются с прозрачным цветом в преобразованном битовом рисунке.

Комментарии

Для formatэтого Format16bppGrayScale не поддерживается.

Для ditherTypeэтого передайте None , когда преобразование не уменьшает битовую глубину данных пикселей. Это должно быть Solid илиErrorDiffusion, если paletteType он или FixedBlackAndWhiteCustom .

paletteType игнорируется для неиндексированных форматов пикселей.

Тип palette (называемый фактической палитрой) не должен иметь тип, указанный параметром paletteType . Параметр paletteType задает стандартную палитру, которая может использоваться любым из упорядоченных или спиральных алгоритмов дитеринга. Если фактическая палитра имеет тип, отличный от указанного paletteType параметром, то ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) выполняется ближайшее преобразование цветов из стандартной палитры в фактическую палитру.

Значение alphaThresholdPercent0 указывает, что ни одна из исходных пикселей не сопоставляется с прозрачным цветом. Значение 100 указывает, что любой пиксель, который не полностью непрозрачный, сопоставляется с прозрачным цветом. Значение t указывает, что любой исходный пиксель меньше, чем процент полностью непрозрачного, сопоставляется с прозрачным цветом. Обратите внимание, что для эффективного альфа-порога палитра должна иметь прозрачный цвет. Если палитра не имеет прозрачного цвета, пиксели с альфа-значениями ниже порогового значения будут сопоставляться с цветом, который наиболее тесно соответствует (0, 0, 0, 0), обычно черный.

paletteType и palette действительно имеют релевантность только с индексированных форматов пикселей. Вы можете передать ColorPalette неиндексированные форматы пикселей, но оно не влияет на преобразование и будет эффективно просто вызывать Palette палитру при завершении преобразования.