Class ColorPaletteHelper
Nom dels espais: Aspose.Imaging Assemblea: Aspose.Imaging.dll (25.4.0)
Classes d’ajuda per a la manipulació de paletes de colors.
public static class ColorPaletteHelperInheritance
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Crea la paleta de colors de 4 bit.
public static IColorPalette Create4Bit()Returns
La paleta de colors de 4 bit.
Create4BitGrayscale(La botiga)
Crea la paleta de 4 bits de graix.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Si s’estableix a ’true’ la paleta comença amb color blanc, d’una altra manera comenci amb el color negre.
Returns
La paleta de 4 bits de graix.
Create8Bit()
Crea la paleta de colors de 8 bits.
public static IColorPalette Create8Bit()Returns
La paleta de colors de 8 bit.
Create8BitGrayscale(La botiga)
Crea la paleta de 8 bits de graix.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Si s’estableix a ’true’ la paleta comença amb color blanc, d’una altra manera comenci amb el color negre.
Returns
La paleta de 8 bits de graix.
Examples
L’exemple següent crea una imatge de graiscales paletitzada BMP i l’emmagatzema a un fitxer.
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)
Obté la paleta d’escala de la xifra de bit especificada. Els valors dels bit autoritzats són 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
El petit compte.
Returns
La paleta grega.
Exceptions
bits'
CreateMonochrome()
Crea una paleta de colors monocròmica que només conté 2 colors.
public static IColorPalette CreateMonochrome()Returns
Paleta de colors per a imatges monocromes.
GetCloseImagePalette(Càtedra, int)
Obté la paleta de color de la imatge de raster (palletizes imatge) en cas que l’imatge no té una. En cas de palet existeix s’utilitzarà en lloc de realitzar càlculs.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Imatge del raster.
entriesCount int
Les entrades desitjades són comptades.
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
Examples
L’exemple següent carrega una imatge de BMP i l’emmagatzema enrere a BMPs utilitzant diverses opcions d’estalvi.
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’exemple següent mostra com paletitzar una imatge BMP per reduir la seva mida de producció.
// 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)
Obté la paleta de color de la imatge de raster (palletizes imatge) en el cas que l’imatge no tingui una. Paleta està a punt d’optimitzar-se per a una millor qualitat de imatge indexada o prendre “AS IS” quan PaletteMiningMethod.UseCurrentPalette s’utilitza.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Imatge del raster.
entriesCount int
Les entrades desitjades són comptades.
paletteMiningMethod PaletteMiningMethod
El mètode de mineria de paletes.
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
Examples
L’exemple següent mostra com comprimir una imatge PNG, utilitzant el color indexat amb la millor paleta
// 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(Títol: Rectangle, int)
Obté la paleta de color de la imatge de raster (palletizes imatge) en cas que l’imatge no té una. En cas de palet existeix s’utilitzarà en lloc de realitzar càlculs.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Imatge del raster.
destBounds Rectangle
La imatge de la destinació limita.
entriesCount int
Les entrades desitjades són comptades.
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Obté la paleta de color de la imatge de raster (palletizes imatge) en cas que l’imatge no té una. En cas de palet existeix s’utilitzarà en lloc de realitzar càlculs.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Imatge del raster.
destBounds Rectangle
La imatge de la destinació limita.
entriesCount int
Les entrades desitjades són comptades.
useImagePalette bool
Si s’estableix, utilitzarà la seva pròpia paleta d’imatge si està disponible
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color)
Obté la paleta de color de la imatge de raster (palletizes imatge) en cas que l’imatge no té una. En cas de palet existeix s’utilitzarà en lloc de realitzar càlculs.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Imatge del raster.
destBounds Rectangle
La imatge de la destinació limita.
entriesCount int
Les entrades desitjades són comptades.
useImagePalette bool
Si s’estableix, utilitzarà la seva pròpia paleta d’imatge si està disponible
alphaBlendInColor Color
El color que s’ha d’utilitzar com a color de fons per a la substitució alfa semi-transparent.
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color, Bool)
Obté la paleta de color de la imatge de raster (palletizes imatge) en cas que l’imatge no té una. En cas de palet existeix s’utilitzarà en lloc de realitzar càlculs.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Imatge del raster.
destBounds Rectangle
La imatge de la destinació limita.
entriesCount int
Les entrades desitjades són comptades.
useImagePalette bool
Si s’estableix, utilitzarà la seva pròpia paleta d’imatge si està disponible
alphaBlendInColor Color
El color que s’ha d’utilitzar com a color de fons per a la substitució alfa semi-transparent.
keepTransparency bool
Si s’estableix, considerarà bits de canal alfa dels colors de la imatge.
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
GetCloseTransparentImagePalette(Càtedra, int)
Obté la paleta de color de la imatge de raster (palletizes imatge) en cas que l’imatge no té una. En cas de palet existeix s’utilitzarà en lloc de realitzar càlculs.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Imatge del raster.
entriesCount int
Les entrades desitjades són comptades.
Returns
La paleta de colors que comença amb els colors més freqüents de la imatge " i conté les entrades de l’enllaç.
GetDownscalePalette(RasterImage)
Obtenir una paleta de 256 colors, que consta de bits superiors dels valors de color d’imatge inicial.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
La imatge .
Returns
El Aspose.Imaging.ColorPalette.
GetUniformColorPalette(RasterImage)
Obtenir una paleta de 256 colors uniformes.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
La imatge .
Returns
El Aspose.Imaging.ColorPalette.
HasTransparentColors(Col·lecció)
Determina si la paleta especificada té colors transparents.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
i la paleta.
Returns
‘verdadera’ si la paleta especificada té colors transparents; d’altra banda, ‘falsa’.
Exceptions
palette’ is null.
