描述
将位图转换为指定的像素格式。位图中的原始像素数据被新的像素数据所取代。
C++ 语法
GpStatus WINGDIPAPI GdipBitmapConvertFormat( IN GpBitmap *pInputBitmap, PixelFormat format, DitherType dithertype, PaletteType palettetype, ColorPalette *palette, REAL alphaThresholdPercent ); |
PowerBASIC 语法
FUNCTION GdipBitmapConvertFormat ( _ BYVAL pInputBitmap AS DWORD, _ BYVAL format AS LONG, _ BYREF dithertype AS LONG, _ BYVAL palettetype AS LONG, _ BYREF palette AS ColorPalette, _ BYVAL alphaThresholdPercent AS SINGLE _ ) AS LONG |
参数
pInputBitmap
[in]指向位图对象的指针的地址。
format
[in]像素格式常量，用于指定新的像素格式。
dithertype
[in]指定抖动算法的DitherType枚举元素。在转换不会降低像素数据的位深度的情况下，通过DitherTypeNone.
palettetype
[out]PaletteType枚举的元素，指定用于抖动的标准调色板。如果要转换为非索引格式，则忽略该参数。在这种情况下，通过PaletteType枚举的任何元素，例如PaletteTypeCustom.
palette
[in ]指向ColorPalette结构的指针，指定其索引存储在转换后的位图的像素数据中的调色板。此调色板（称为实际调色板）不必具有由paletteetype参数指定的类型。palettetype参数指定可以由任何有序或螺旋抖动算法使用的标准调色板。如果实际的调色板的类型不同于palettetype参数指定的类型，则GdipBitmapConvertFormat函数将执行从标准调色板到实际调色板的最近颜色转换。
alphaThresholdPercent
[in]范围0到100中的实数，用于指定源位图中的哪些像素将映射到转换后的位图中的透明颜色。值为0表示没有源像素映射到透明颜色。值100指定任何不完全不透明的像素将映射到透明颜色。值t指定小于完全不透明度的t％的任何源像素将映射到透明颜色。请注意，要使alpha阈值有效，调色板必须具有透明色。如果调色板不具有透明颜色，则Alpha值低于阈值的像素将映射到最接近匹配的颜色（0,0,0,0），通常为黑色。
返回值
如果函数成功，则返回Ok，它是状态枚举的一个元素。
如果函数失败，它返回状态枚举的其他元素之一。
要求
GDI+ 1.1