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

Метод 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 , задающий алгоритм dithering. В случаях, когда преобразование не уменьшает битовую глубину данных пикселей, передайте DitherTypeNone.

[in] palettetype

Тип: PaletteType

Элемент перечисления PaletteType , указывающий стандартную палитру, используемую для дитеринга. При преобразовании в неиндексованный формат этот параметр игнорируется. В этом случае передайте любой элемент перечисления PaletteType , скажем , PaletteTypeCustom.

[in] palette

Тип: ColorPalette*

Указатель на структуру ColorPalette , указывающую палитру, индексы которой хранятся в пиксельных данных преобразованного растрового изображения. Эта палитра (называемая фактической палитрой) не обязательно имеет тип, заданный параметром палитры . Параметр palettetype задает стандартную палитру, которую можно использовать любым из упорядоченных или спирали алгоритмов дитеринга. Если фактическая палитра имеет тип, отличный от указанного параметром палитры , то метод Bitmap::ConvertFormat выполняет преобразование ближайшего цвета из стандартной палитры в фактическую палитру.

[in] alphaThresholdPercent

Тип: REAL

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

Возвращаемое значение

Тип: состояние

Если метод выполнен успешно, он возвращает ok, который является элементом перечисления Status .

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

Требования

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

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

Bitmap

Bitmap::InitializePalette