Class ColorPaletteHelper
Il nome: Aspose.Imaging Assemblea: Aspose.Imaging.dll (25.4.0)
Classi di assistenza per la manipolazione delle palette di colore.
public static class ColorPaletteHelperInheritance
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Crea la paletta colorata di 4 bit.
public static IColorPalette Create4Bit()Returns
La paletta di colori 4 bit.
Create4BitGrayscale(di bool)
Crea la paletta 4 bit di grayscale.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
se impostato per “true” la paletta inizia con il colore bianco, altrimenti inizia con il colore nero.
Returns
La paletta 4 bit di grayscale.
Create8Bit()
Crea la paletta di colori da 8 bit.
public static IColorPalette Create8Bit()Returns
La paletta di colori 8 bit.
Create8BitGrayscale(di bool)
Crea la paletta di 8 bit di grayscale.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
se impostato per “true” la paletta inizia con il colore bianco, altrimenti inizia con il colore nero.
Returns
La paletta a 8 bit di griglia.
Examples
L’esempio seguente crea un’immagine di grayscale BMP palettizzata e lo salva in un file.
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)
Riceve la paletta di grayscale del numero di bit specificato. I valori dei bit consentiti sono 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Il piccolo conte.
Returns
Palette di Grayscale.
Exceptions
bits'
CreateMonochrome()
Crea una paletta di colori monochromi che contiene solo 2 colori.
public static IColorPalette CreateMonochrome()Returns
Colore per immagini monochrome.
GetCloseImagePalette(Sviluppo, int)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) nel caso in cui l’immagine non abbia una.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
L’immagine del raster.
entriesCount int
Le entrate desiderate contano.
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
Examples
L’esempio seguente carica un’immagine BMP e lo salva indietro al BMM utilizzando varie opzioni di risparmio.
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);
}L’esempio seguente mostra come palletizzare un’immagine BMP per ridurre la sua dimensione di uscita.
// 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)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) in caso che l’imagine non abbia uno. La palette sta per essere ottimizzata per una migliore qualità di immagini indexate o prende “AS IS” quando PaletteMiningMethod.UseCurrentPalette viene utilizzato.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
L’immagine del raster.
entriesCount int
Le entrate desiderate contano.
paletteMiningMethod PaletteMiningMethod
Il metodo di mining palette.
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
Examples
L’esempio seguente mostra come comprimere un’immagine PNG, utilizzando il colore indexato con la paletta più adatta
// 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(Trattamento, Rectangle, int)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) nel caso in cui l’immagine non abbia una.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
L’immagine del raster.
destBounds Rectangle
L’immagine di destinazione è limitata.
entriesCount int
Le entrate desiderate contano.
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) nel caso in cui l’immagine non abbia una.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
L’immagine del raster.
destBounds Rectangle
L’immagine di destinazione è limitata.
entriesCount int
Le entrate desiderate contano.
useImagePalette bool
Se impostato, utilizzerà la propria paletta immagine se disponibile
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, colore)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) nel caso in cui l’immagine non abbia una.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
L’immagine del raster.
destBounds Rectangle
L’immagine di destinazione è limitata.
entriesCount int
Le entrate desiderate contano.
useImagePalette bool
Se impostato, utilizzerà la propria paletta immagine se disponibile
alphaBlendInColor Color
Il colore che dovrebbe essere utilizzato come colore di sfondo per la sostituzione alfa semi-transparente.
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color, Bool)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) nel caso in cui l’immagine non abbia una.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
L’immagine del raster.
destBounds Rectangle
L’immagine di destinazione è limitata.
entriesCount int
Le entrate desiderate contano.
useImagePalette bool
Se impostato, utilizzerà la propria paletta immagine se disponibile
alphaBlendInColor Color
Il colore che dovrebbe essere utilizzato come colore di sfondo per la sostituzione alfa semi-transparente.
keepTransparency bool
Se impostato, prenderà in considerazione i bit di canale alfa dei colori dell’immagine.
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
GetCloseTransparentImagePalette(Sviluppo, int)
Riceve la paletta di colore dall’immagine di raster (palletizes immagine) nel caso in cui l’immagine non abbia una.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
L’immagine del raster.
entriesCount int
Le entrate desiderate contano.
Returns
La paletta di colori che inizia con i colori più comuni dalla image’ e contiene le entrate di entriesCount.
GetDownscalePalette(RasterImage)
Ottieni una paletta di 256 colori, composta da bits superiori dei valori di colore dell’immagine iniziale.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
La immagine .
Returns
Il Aspose.Imaging.ColorPalette
GetUniformColorPalette(RasterImage)
Ottieni una paletta uniforme di 256 colori.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
La immagine .
Returns
Il Aspose.Imaging.ColorPalette
HasTransparentColors(Il colore)
Determina se la paletta specifica ha colori trasparenti.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
La paletta è
Returns
‘verità’ se la paletta specifica ha colori trasparenti; altrimenti, ‘falso’.
Exceptions
palette’ is null.
