Метод Bitmap::ConvertFormat (gdiplusheaders.h)

Статья
08/24/2023

Метод 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 .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	gdiplusheaders.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll

См. также раздел

Bitmap

Bitmap::InitializePalette