Class ColorPaletteHelper
Navne til: Aspose.Imaging Sammensætning: Aspose.Imaging.dll (25.4.0)
Hjælper klasse for farve paletter manipulation.
public static class ColorPaletteHelperInheritance
De arvede medlemmer
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Skaber den 4 bit farvepalette.
public static IColorPalette Create4Bit()Returns
Den 4 bit farve palet.
Create4BitGrayscale(Bool)
Skaber den 4 bit grayscale palette.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Hvis paletten starter med hvid, så begynder den med sort.
Returns
Den 4 bit grayscale palette.
Create8Bit()
Skaber den 8 bit farvepalette.
public static IColorPalette Create8Bit()Returns
Den 8 bit farve palet.
Create8BitGrayscale(Bool)
Skaber den 8 bit grayscale palette.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Hvis paletten starter med hvid, så begynder den med sort.
Returns
Den 8 bit grayscale palette.
Examples
Følgende eksempel skaber et paletiseret grayscale BMP-billede og gemmer det derefter til en fil.
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)
Giver den grayscale palette af det angivne bittælling. Tilladte bitværdier er 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Det lille tal.
Returns
Grayscale palet.
Exceptions
bits'
CreateMonochrome()
Det skaber en monochrome farvepalette, der kun indeholder 2 farver.
public static IColorPalette CreateMonochrome()Returns
Farvepalet til monochrome billeder.
GetCloseImagePalette(Skæbne, int)
Får farvepalet fra rasterbilledet (palletizes billedet) i tilfælde af, at billedet ikke har en. I tilfælde af palet eksisterer det vil blive brugt i stedet for at udføre beregninger.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Det rasterbillede.
entriesCount int
De ønskede indtægter tæller.
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
Examples
Følgende eksempel oplader et BMP-billede og sparer det tilbage til BMP ved hjælp af forskellige sparingsmuligheder.
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);
}Følgende eksempel viser, hvordan man palletiserer et BMP-billede for at reducere dens udkomststørrelse.
// 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)
Får farvepaletten fra rasterbilledet (palletizes billedet) i tilfælde af, at billeden ikke har en. Paletten er på vej til at blive optimeret for bedre indekseret billedkvalitet eller tages “AS IS” når PaletteMiningMethod.UseCurrentPalette bruges.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Det rasterbillede.
entriesCount int
De ønskede indtægter tæller.
paletteMiningMethod PaletteMiningMethod
Den palette mining metode.
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
Examples
Følgende eksempel viser, hvordan man komprimerer et PNG-billede, ved hjælp af indekseret farve med den bedst egnede palette
// 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(Rektangle, Rektangle og Int)
Får farvepalet fra rasterbilledet (palletizes billedet) i tilfælde af, at billedet ikke har en. I tilfælde af palet eksisterer det vil blive brugt i stedet for at udføre beregninger.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Det rasterbillede.
destBounds Rectangle
Destinationsbilledet er begrænset.
entriesCount int
De ønskede indtægter tæller.
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Får farvepalet fra rasterbilledet (palletizes billedet) i tilfælde af, at billedet ikke har en. I tilfælde af palet eksisterer det vil blive brugt i stedet for at udføre beregninger.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Det rasterbillede.
destBounds Rectangle
Destinationsbilledet er begrænset.
entriesCount int
De ønskede indtægter tæller.
useImagePalette bool
Hvis det er indstillet, vil det bruge sin egen billedpalette, hvis det er tilgængeligt
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Farve)
Får farvepalet fra rasterbilledet (palletizes billedet) i tilfælde af, at billedet ikke har en. I tilfælde af palet eksisterer det vil blive brugt i stedet for at udføre beregninger.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Det rasterbillede.
destBounds Rectangle
Destinationsbilledet er begrænset.
entriesCount int
De ønskede indtægter tæller.
useImagePalette bool
Hvis det er indstillet, vil det bruge sin egen billedpalette, hvis det er tilgængeligt
alphaBlendInColor Color
Den farve, der skal bruges som baggrundsfarve til halvt gennemsigtig alfa erstattelse.
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Farve, Bool)
Får farvepalet fra rasterbilledet (palletizes billedet) i tilfælde af, at billedet ikke har en. I tilfælde af palet eksisterer det vil blive brugt i stedet for at udføre beregninger.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Det rasterbillede.
destBounds Rectangle
Destinationsbilledet er begrænset.
entriesCount int
De ønskede indtægter tæller.
useImagePalette bool
Hvis det er indstillet, vil det bruge sin egen billedpalette, hvis det er tilgængeligt
alphaBlendInColor Color
Den farve, der skal bruges som baggrundsfarve til halvt gennemsigtig alfa erstattelse.
keepTransparency bool
Hvis det er indstillet, vil det overveje alfa-kanalbits af billedfarverne.
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
GetCloseTransparentImagePalette(Skæbne, int)
Får farvepalet fra rasterbilledet (palletizes billedet) i tilfælde af, at billedet ikke har en. I tilfælde af palet eksisterer det vil blive brugt i stedet for at udføre beregninger.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Det rasterbillede.
entriesCount int
De ønskede indtægter tæller.
Returns
Den farvepalette, der begynder med de hyppigste farver fra image’ og indeholder entriesCount’ indtægter.
GetDownscalePalette(RasterImage)
Få 256 farvepaletter, der består af øverste bits af de oprindelige billedfarveværdier.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
Det billede.
Returns
Den Aspose.Imaging.ColorPalette
GetUniformColorPalette(RasterImage)
Få en uniform 256 farver palet.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
Det billede.
Returns
Den Aspose.Imaging.ColorPalette
HasTransparentColors(ICOLORPalette)
Det bestemmer, om den angivne palette har gennemsigtige farver.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
og paletten.
Returns
’true’ hvis den angivne palette har gennemsigtige farver; ellers ‘falske’.
Exceptions
palette’ is null.
