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