Class ColorPaletteHelper
De naam: Aspose.Imaging Verzameling: Aspose.Imaging.dll (25.4.0)
Hulpklasse voor kleurpaletten manipulatie.
public static class ColorPaletteHelperInheritance
Geëerbiede leden
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Creëert de 4 bit kleurpalet.
public static IColorPalette Create4Bit()Returns
De 4 bit kleurpalet.
Create4BitGrayscale(Bool)
Het creëert de 4 bit grayscale palet.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Als het ‘waar’ wordt ingesteld, begint de palet met wit, anders begint het met zwart.
Returns
De 4 bit grayscale palet.
Create8Bit()
Het creëert de 8 bit kleurpalet.
public static IColorPalette Create8Bit()Returns
De 8 bit kleurpalet.
Create8BitGrayscale(Bool)
Het creëert de 8 bit grayscale palet.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Als het ‘waar’ wordt ingesteld, begint de palet met wit, anders begint het met zwart.
Returns
De 8 bit grayscale palet.
Examples
Het volgende voorbeeld creëert een paletiseerde grayscale BMP-afbeelding en slaat het vervolgens op in een bestand.
string dir = "c:\\temp\\";
Aspose.Imaging.ImageOptions.BmpOptions createOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
// Save to a file
createOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(dir + "output.palette8bit.bmp", false);
// Use 8 bits per pixel to reduce the size of the output image.
createOptions.BitsPerPixel = 8;
// Set the standard 8-bit grayscale color palette which covers all grayscale colors.
// If the processed image contains only grayscale colors, then its palettized version
// is visually indistinguishable from a non-palletized one.
createOptions.Palette = Aspose.Imaging.ColorPaletteHelper.Create8BitGrayscale(false);
// Save without compression.
// You can also use RLE-8 compression to reduce the size of the output image.
createOptions.Compression = Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb;
// Set the horizontal and vertical resolution to 96 dpi.
createOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
// Create a BMP image of 100 x 100 px and save it to a file.
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Create(createOptions, 100, 100))
{
Aspose.Imaging.Graphics graphics = new Aspose.Imaging.Graphics(image);
Aspose.Imaging.Brushes.LinearGradientBrush gradientBrush = new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(image.Width, image.Height),
Aspose.Imaging.Color.Black,
Aspose.Imaging.Color.White);
// Fill the image with a grayscale gradient
graphics.FillRectangle(gradientBrush, image.Bounds);
image.Save();
}CreateGrayscale(Int)
Geeft de grayscale palet van een bepaald bit count. toegestane bitwaarden zijn 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Het kleine getal.
Returns
De Grayscale palet.
Exceptions
bits’
CreateMonochrome()
Het creëert een monochrome kleurpalet die slechts 2 kleuren bevat.
public static IColorPalette CreateMonochrome()Returns
Kleurpalen voor monochrome afbeeldingen.
GetCloseImagePalette(Hoofdstukken, int)
Geeft kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld geen. in het geval dat palet bestaat, wordt het in plaats daarvan gebruikt om berekeningen uit te voeren.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Het raster beeld.
entriesCount int
De gewenste inschrijvingen tellen.
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
Examples
Het volgende voorbeeld laden een BMP-afbeelding op en bespaart het terug naar BMPs met behulp van verschillende opties voor het opslaan.
string dir = "c:\\temp\\";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.bmp"))
{
Aspose.Imaging.RasterImage rasterImage = (Aspose.Imaging.RasterImage)image;
// Create BmpOptions
Aspose.Imaging.ImageOptions.BmpOptions saveOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
// Use 8 bits per pixel to reduce the size of the output image.
saveOptions.BitsPerPixel = 8;
// Set the closest 8-bit color palette which covers the maximal number of image pixels, so that a palettized image
// is almost visually indistinguishable from a non-palletized one.
saveOptions.Palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette(rasterImage, 256);
// Save without compression.
// You can also use RLE-8 compression to reduce the size of the output image.
saveOptions.Compression = Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb;
// Set the horizontal and vertical resolution to 96 dpi.
saveOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
image.Save(dir + "sample.bmpoptions.bmp", saveOptions);
}Het volgende voorbeeld laat zien hoe je een BMP-afbeelding palletiseert om de uitvoergrootte ervan te verminderen.
// Create a BMP image 100 x 100 px.
using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100))
{
// The linear gradient from the left-top to the right-bottom corner of the image.
Aspose.Imaging.Brushes.LinearGradientBrush brush =
new Aspose.Imaging.Brushes.LinearGradientBrush(
new Aspose.Imaging.Point(0, 0),
new Aspose.Imaging.Point(bmpImage.Width, bmpImage.Height),
Aspose.Imaging.Color.Red,
Aspose.Imaging.Color.Green);
// Fill the entire image with the linear gradient brush.
Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(bmpImage);
gr.FillRectangle(brush, bmpImage.Bounds);
// Get the closest 8-bit color palette which covers as many pixels as possible, so that a palettized image
// is almost visually indistinguishable from a non-palletized one.
Aspose.Imaging.IColorPalette palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette(bmpImage, 256);
// 8-bit palette contains at most 256 colors.
Aspose.Imaging.ImageOptions.BmpOptions saveOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
saveOptions.Palette = palette;
saveOptions.BitsPerPixel = 8;
using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
{
bmpImage.Save(stream, saveOptions);
System.Console.WriteLine("The palettized image size is {0} bytes.", stream.Length);
}
using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
{
bmpImage.Save(stream);
System.Console.WriteLine("The non-palettized image size is {0} bytes.", stream.Length);
}
}
// The output looks like this:
// The palettized image size is 11078 bytes.
// The non-palettized image size is 40054 bytes.GetCloseImagePalette(RasterImage, int, PaletteMiningMethod)
Het krijgt de kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld niet één heeft. palet gaat worden geoptimaliseerd voor een betere geïndexeerde beeldkwaliteit of wordt “AS IS” genomen wanneer PaletteMiningMethod.UseCurrentPalette wordt gebruikt.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Het raster beeld.
entriesCount int
De gewenste inschrijvingen tellen.
paletteMiningMethod PaletteMiningMethod
De paletmijnmethode.
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
Examples
Het volgende voorbeeld laat zien hoe je een PNG-afbeelding kunt compresseren, met behulp van geïndexeerde kleur met de best fit palet.
// Loads png image
string sourceFilePath="OriginalRings.png";
string outputFilePath="OriginalRingsOutput.png";
using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(sourceFilePath))
{
image.Save(outputFilePath, new Aspose.Imaging.ImageOptions.PngOptions()
{
Progressive = true,
// Use indexed color type
ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.IndexedColor,
// Use maximal compression
CompressionLevel = 9,
// Get the closest 8-bit color palette which covers as many pixels as possible, so that a palettized image
// is almost visually indistinguishable from a non-palletized one.
Palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette((Aspose.Imaging.RasterImage)image, 256, Aspose.Imaging.PaletteMiningMethod.Histogram)
});
}
// The output file size should be significantly reducedGetCloseImagePalette(RasterImage, Rectangle, int)
Geeft kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld geen. in het geval dat palet bestaat, wordt het in plaats daarvan gebruikt om berekeningen uit te voeren.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Het raster beeld.
destBounds Rectangle
De afbeelding van de bestemming beperkt.
entriesCount int
De gewenste inschrijvingen tellen.
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Geeft kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld geen. in het geval dat palet bestaat, wordt het in plaats daarvan gebruikt om berekeningen uit te voeren.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Het raster beeld.
destBounds Rectangle
De afbeelding van de bestemming beperkt.
entriesCount int
De gewenste inschrijvingen tellen.
useImagePalette bool
Als het is ingesteld, zal het gebruik maken van zijn eigen beeldpalet als beschikbaar
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, kleur)
Geeft kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld geen. in het geval dat palet bestaat, wordt het in plaats daarvan gebruikt om berekeningen uit te voeren.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Het raster beeld.
destBounds Rectangle
De afbeelding van de bestemming beperkt.
entriesCount int
De gewenste inschrijvingen tellen.
useImagePalette bool
Als het is ingesteld, zal het gebruik maken van zijn eigen beeldpalet als beschikbaar
alphaBlendInColor Color
De kleur die moet worden gebruikt als achtergrondkleur voor semi-transparente alfa vervanging.
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, kleur, Bool)
Geeft kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld geen. in het geval dat palet bestaat, wordt het in plaats daarvan gebruikt om berekeningen uit te voeren.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Het raster beeld.
destBounds Rectangle
De afbeelding van de bestemming beperkt.
entriesCount int
De gewenste inschrijvingen tellen.
useImagePalette bool
Als het is ingesteld, zal het gebruik maken van zijn eigen beeldpalet als beschikbaar
alphaBlendInColor Color
De kleur die moet worden gebruikt als achtergrondkleur voor semi-transparente alfa vervanging.
keepTransparency bool
Als het is ingesteld, zal het de alfa-kanaal bits van de afbeelding kleuren overwegen.
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
GetCloseTransparentImagePalette(Hoofdstukken, int)
Geeft kleurpalet van het raster beeld (palletizes beeld) in het geval dat het beeld geen. in het geval dat palet bestaat, wordt het in plaats daarvan gebruikt om berekeningen uit te voeren.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Het raster beeld.
entriesCount int
De gewenste inschrijvingen tellen.
Returns
De kleurpalet die begint met de meest voorkomende kleuren van de image’ en bevat de entriesCount’ inzichten.
GetDownscalePalette(RasterImage)
Krijg een 256 kleurenpalet, bestaande uit bovenste bits van de oorspronkelijke kleurwaarden van het beeld.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
De afbeelding .
Returns
De Aspose.Imaging.ColorPalette
GetUniformColorPalette(RasterImage)
Krijg een uniform 256 kleurenpalet.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
De afbeelding .
Returns
De Aspose.Imaging.ColorPalette
HasTransparentColors(ICOLORPALET)
Het bepaalt of de gespecificeerde palet transparante kleuren heeft.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
De palet.
Returns
‘waar’ als de aangegeven palet transparante kleuren heeft; anders, ‘false’.
Exceptions
palette’ is null.
