Bitmap.ConvertFormat Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| ConvertFormat(PixelFormat) |
Konvertiert die Bitmap in die angegebene |
| ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) |
Konvertiert die Bitmap mithilfe der angegebenen |
ConvertFormat(PixelFormat)
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
Konvertiert die Bitmap in die angegebene format. Die ursprünglichen Pixeldaten werden durch das neue Format ersetzt.
public:
void ConvertFormat(System::Drawing::Imaging::PixelFormat format);public void ConvertFormat(System.Drawing.Imaging.PixelFormat format);member this.ConvertFormat : System.Drawing.Imaging.PixelFormat -> unitPublic Sub ConvertFormat (format As PixelFormat)Parameter
- format
- PixelFormat
Das neue Pixelformat.
Hinweise
Für format, Format16bppGrayScale wird nicht unterstützt.
Gilt für:
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
- Quelle:
- Bitmap.cs
Konvertiert die Bitmap mithilfe der angegebenen formatditherType. Die ursprünglichen Pixeldaten werden durch das neue Format ersetzt.
public void ConvertFormat(System.Drawing.Imaging.PixelFormat format, System.Drawing.Imaging.DitherType ditherType, System.Drawing.Imaging.PaletteType paletteType = System.Drawing.Imaging.PaletteType.Custom, System.Drawing.Imaging.ColorPalette? palette = default, float alphaThresholdPercent = 0);member this.ConvertFormat : System.Drawing.Imaging.PixelFormat * System.Drawing.Imaging.DitherType * System.Drawing.Imaging.PaletteType * System.Drawing.Imaging.ColorPalette * single -> unitPublic Sub ConvertFormat (format As PixelFormat, ditherType As DitherType, Optional paletteType As PaletteType = System.Drawing.Imaging.PaletteType.Custom, Optional palette As ColorPalette = Nothing, Optional alphaThresholdPercent As Single = 0)Parameter
- format
- PixelFormat
Das neue Pixelformat.
- ditherType
- DitherType
Der Ditheringalgorithmus.
- paletteType
- PaletteType
Der Palettentyp, der verwendet werden soll, wenn das Pixelformat indiziert wird.
- palette
- ColorPalette
Zeiger auf eine ColorPalette , die die Palette angibt, deren Indizes in den Pixeldaten der konvertierten Bitmap gespeichert sind. Dies muss für indizierte Pixelformate angegeben werden.
- alphaThresholdPercent
- Single
Eine reelle Zahl im Bereich 0 bis 100, die angibt, welche Pixel in der Quellbitmap der transparenten Farbe in der konvertierten Bitmap zugeordnet werden.
Hinweise
Für format, Format16bppGrayScale wird nicht unterstützt.
Übergeben ditherTypeSie bei None der Konvertierung, wenn die Bittiefe der Pixeldaten nicht reduziert wird. Dies muss sein Solid oder ErrorDiffusion , wenn dies paletteType der Fall ist Custom oder FixedBlackAndWhite.
paletteType wird für nicht indizierte Pixelformate ignoriert.
Die palette (als tatsächliche Palette bezeichnete Palette) muss den vom paletteType Parameter angegebenen Typ nicht aufweisen. Der paletteType Parameter gibt eine Standardpalette an, die von einer der sortierten oder spiralförmigen Ditheringalgorithmen verwendet werden kann. Wenn die tatsächliche Palette einen anderen Typ als den durch den paletteType Parameter angegebenen Typ aufweist, führt sie ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) eine nächste Farbkonvertierung von der Standardpalette in die tatsächliche Palette aus.
For alphaThresholdPercent, a value of 0 specifies that none of the source pixels map to the transparent color. Ein Wert von 100 gibt an, dass jedes Pixel, das nicht vollständig undurchsichtig ist, der transparenten Farbe zugeordnet wird. Ein Wert von t gibt an, dass jedes Quellpixel, das kleiner als t Prozent der vollständig undurchsichtigen Farbe ist, der transparenten Farbe zugeordnet wird. 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), in der Regel schwarz.
paletteType und palette haben wirklich nur Relevanz für indizierte Pixelformate. Sie können ein ColorPalette nicht indiziertes Pixelformat übergeben, hat aber keine Auswirkungen auf die Transformation und ruft nur auf Palette , um die Palette festzulegen, wenn die Konvertierung abgeschlossen ist.
