Bitmap::ConvertFormat-Methode (gdiplusheaders.h)
Die Bitmap::ConvertFormat-Methode konvertiert eine Bitmap in ein angegebenes Pixelformat. Die ursprünglichen Pixeldaten in der Bitmap werden durch die neuen Pixeldaten ersetzt.
Syntax
Status ConvertFormat(
[in] PixelFormat format,
[in] DitherType dithertype,
[in] PaletteType palettetype,
[in] ColorPalette *palette,
[in] REAL alphaThresholdPercent
);
Parameter
[in] format
Typ: PixelFormat
Pixelformatkonstante , die das neue Pixelformat angibt.
[in] dithertype
Typ: DitherType
Element der DitherType-Enumeration , das den Ditheringalgorithmus angibt. In Fällen, in denen die Konvertierung die Bittiefe der Pixeldaten nicht verringert, übergeben Sie DitherTypeNone.
[in] palettetype
Typ: PaletteType
Element der PaletteType-Enumeration , das eine Standardpalette angibt, die zum Dithering verwendet werden soll. Wenn Sie in ein nicht indiziertes Format konvertieren, wird dieser Parameter ignoriert. Übergeben Sie in diesem Fall ein beliebiges Element der PaletteType-Enumeration , z. B. PaletteTypeCustom.
[in] palette
Typ: ColorPalette*
Zeiger auf eine ColorPalette-Struktur , die die Palette angibt, deren Indizes in den Pixeldaten der konvertierten Bitmap gespeichert werden. Diese Palette (als tatsächliche Palette bezeichnet) muss nicht über den typ verfügen, der vom palettetype-Parameter angegeben wird. Der parameter palettetype gibt eine Standardpalette an, die von jedem der geordneten oder spiralförmigen Ditheringalgorithmen verwendet werden kann. Wenn die tatsächliche Palette über einen anderen Typ als den vom palettetype-Parameter angegebenen verfügt, führt die Bitmap::ConvertFormat-Methode eine Farbkonvertierung der Standardpalette in die tatsächliche Palette durch.
[in] alphaThresholdPercent
Typ: REAL
Reelle Zahl im Bereich von 0 bis 100, die angibt, welche Pixel in der Quellbitmap der transparenten Farbe in der konvertierten Bitmap zugeordnet werden. Der Wert 0 gibt an, dass keiner der Quellpixel der transparenten Farbe zugeordnet ist. Der Wert 100 gibt an, dass alle Pixel, die nicht vollständig undurchsichtig sind, der transparenten Farbe zugeordnet werden. Der Wert t gibt an, dass alle Quellpixel, die kleiner als t Prozent vollständig undurchsichtig sind, der transparenten Farbe zugeordnet werden. Beachten Sie, dass die Palette eine transparente Farbe aufweisen muss, damit der Alphaschwellenwert wirksam ist. Wenn die Palette keine transparente Farbe aufweist, werden Pixel mit Alphawerten unterhalb des Schwellenwerts der Farbe zugeordnet, die am ehesten übereinstimmt (0, 0, 0, 0, 0), normalerweise schwarz.
Rückgabewert
Typ: Status
Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .
Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | gdiplusheaders.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |