Bitmap.ConvertFormat Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v11.0.0-preview.5.26302.115

Přetížení

Name	Description
ConvertFormat(PixelFormat)	Převede rastrový obrázek na zadaný format. Původní pixelová data se nahradí novým formátem.
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)	Převede rastrový obrázek na zadaný format pomocí daného ditherType. Původní pixelová data se nahradí novým formátem.

ConvertFormat(PixelFormat)

Zdroj:

Bitmap.cs

Převede rastrový obrázek na zadaný format. Původní pixelová data se nahradí novým formátem.

public:
 void ConvertFormat(System::Drawing::Imaging::PixelFormat format);

public void ConvertFormat(System.Drawing.Imaging.PixelFormat format);

member this.ConvertFormat : System.Drawing.Imaging.PixelFormat -> unit

Public Sub ConvertFormat (format As PixelFormat)

Parametry

format

PixelFormat

Nový formát pixelů.

Poznámky

Pro format, Format16bppGrayScale není podporováno.

ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)

Zdroj:

Bitmap.cs

Převede rastrový obrázek na zadaný format pomocí daného ditherType. Původní pixelová data se nahradí novým formátem.

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 -> unit

Public 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)

Parametry

format

PixelFormat

Nový formát pixelů.

ditherType

DitherType

Algoritmus dithering.

paletteType

PaletteType

Typ palety, který se má použít při indexování formátu pixelu.

palette

ColorPalette

Ukazatel na paletu ColorPalette , jejíž indexy jsou uloženy v pixelových datech převedeného rastrového obrázku. To musí být zadáno pro indexované pixelové formáty.

alphaThresholdPercent

Single

Reálné číslo v rozsahu 0 až 100, které určuje, které pixely ve zdrojovém rastrovém obrázku se mapují na průhlednou barvu v převedené bitmapě.

Poznámky

Pro format, Format16bppGrayScale není podporováno.

Pokud ditherTypepřevod nezmenšuje bitovou hloubku dat v pixelech, předejte None je. To musí být Solid nebo ErrorDiffusion pokud je CustomFixedBlackAndWhitenebo paletteType .

paletteType aplikace se ignoruje pro neindexované formáty pixelů.

Samotná paleta palette (označovaná jako skutečná paleta) nemusí mít typ určený parametrem paletteType . Parametr paletteType určuje standardní paletu, kterou může použít kterýkoli z seřazených nebo spirálových diteringových algoritmů. Pokud má skutečná paleta jiný typ než ten zadaný paletteType parametrem, ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single) provede nejbližší převod barev ze standardní palety na skutečnou paletu.

Hodnota alphaThresholdPercent0 určuje, že žádná ze zdrojových pixelů se nenamapuje na průhlednou barvu. Hodnota 100 určuje, že každý pixel, který není zcela neprůhledný, se mapuje na průhlednou barvu. Hodnota t určuje, že jakýkoli zdrojový pixel menší než t procento zcela neprůhledné bude mapovat na průhlednou barvu. Všimněte si, že aby byla prahová hodnota alfa efektivní, musí mít paleta průhlednou barvu. Pokud paleta nemá průhlednou barvu, pixely s alfa hodnotami pod prahovou hodnotou se mapují na barvu, která nejvíce odpovídá (0, 0, 0, 0), obvykle černé.

paletteType a palette ve skutečnosti mají jenom relevanci s indexovanými pixelovými formáty. Můžete předat ColorPalette pro neindexované pixelové formáty, ale nemá žádný vliv na transformaci a bude efektivní pouze volání Palette nastavit paletu po dokončení převodu.