Bitmap::ConvertFormat-Methode (gdiplusheaders.h)

  • Artikel

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

Weitere Informationen

Bitmap

Bitmap::InitializePalette