Class ColorPaletteHelper
Numele spaţiului: Aspose.Imaging Asamblare: Aspose.Imaging.dll (25.4.0)
Clasa de ajutor pentru manipularea paletelor de culoare.
public static class ColorPaletteHelperInheritance
Membrii moștenitori
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Creează paleta de culori de 4 bit.
public static IColorPalette Create4Bit()Returns
Paleta de culori de 4 bit.
Create4BitGrayscale(Boulă)
Creează paleta cu 4 bit de grayscale.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Dacă este setat pentru a fi adevărat, paleta începe cu culoarea albă, altfel începe cu culoarea neagră.
Returns
Paleta cu 4 bit de grayscale.
Create8Bit()
Creează paleta de culori de 8 bit.
public static IColorPalette Create8Bit()Returns
Paleta de culori de 8 bit.
Create8BitGrayscale(Boulă)
Creează paleta de 8 bit grayscale.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Dacă este setat pentru a fi adevărat, paleta începe cu culoarea albă, altfel începe cu culoarea neagră.
Returns
Paleta de 8 bit grayscale.
Examples
Următorul exemplu creează o imagine BMP cu grayscale paletată și apoi o salvează într-un fișier.
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)
Obține paleta grayscale a numărului de bituri specificate. valorile autorizate ale biturilor sunt 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Un pic de număr.
Returns
Paletă de Grayscale.
Exceptions
bits'
CreateMonochrome()
Creează o paletă de culori monochrome care conține doar 2 culori.
public static IColorPalette CreateMonochrome()Returns
Paleta de culori pentru imagini monochrome.
GetCloseImagePalette(Războiul, int)
Obține paleta de culoare din imaginea raster (palletizes imaginea) în cazul în care imaginea nu are una. în cazul în care paleta există va fi utilizat în loc de efectuarea calculelor.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Imaginea lui raster.
entriesCount int
Numărul de intrări dorite.
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
Examples
Următorul exemplu încărcă o imagine BMP și o salvează înapoi la BMPs folosind diferite opțiuni de salvare.
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);
}Următorul exemplu arată cum să palletizați o imagine BMP pentru a reduce dimensiunea sa de ieșire.
// 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)
Obține paleta de culori de la imaginea raster (palletizes imagini) în cazul în care imaginile nu au unul. Paleta se apropie de a fi optimizat pentru o calitate mai bună a imaginii indexate sau luate “AS IS” atunci când PaletteMiningMethod.UseCurrentPalette este utilizat.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Imaginea lui raster.
entriesCount int
Numărul de intrări dorite.
paletteMiningMethod PaletteMiningMethod
Metoda de minare a paletelor.
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
Examples
Următorul exemplu arată cum să compresezi o imagine PNG, folosind culoarea indexată cu cea mai bună paletă potrivită
// 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)
Obține paleta de culoare din imaginea raster (palletizes imaginea) în cazul în care imaginea nu are una. în cazul în care paleta există va fi utilizat în loc de efectuarea calculelor.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Imaginea lui raster.
destBounds Rectangle
Imaginea de destinație este limitată.
entriesCount int
Numărul de intrări dorite.
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Obține paleta de culoare din imaginea raster (palletizes imaginea) în cazul în care imaginea nu are una. în cazul în care paleta există va fi utilizat în loc de efectuarea calculelor.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Imaginea lui raster.
destBounds Rectangle
Imaginea de destinație este limitată.
entriesCount int
Numărul de intrări dorite.
useImagePalette bool
Dacă este setat, va folosi propria paletă de imagine dacă este disponibilă
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Culoare)
Obține paleta de culoare din imaginea raster (palletizes imaginea) în cazul în care imaginea nu are una. în cazul în care paleta există va fi utilizat în loc de efectuarea calculelor.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Imaginea lui raster.
destBounds Rectangle
Imaginea de destinație este limitată.
entriesCount int
Numărul de intrări dorite.
useImagePalette bool
Dacă este setat, va folosi propria paletă de imagine dacă este disponibilă
alphaBlendInColor Color
Culoarea care ar trebui utilizată ca culoare de fundal pentru înlocuirea semi-transparentă alfa.
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Culoare, Bool)
Obține paleta de culoare din imaginea raster (palletizes imaginea) în cazul în care imaginea nu are una. în cazul în care paleta există va fi utilizat în loc de efectuarea calculelor.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Imaginea lui raster.
destBounds Rectangle
Imaginea de destinație este limitată.
entriesCount int
Numărul de intrări dorite.
useImagePalette bool
Dacă este setat, va folosi propria paletă de imagine dacă este disponibilă
alphaBlendInColor Color
Culoarea care ar trebui utilizată ca culoare de fundal pentru înlocuirea semi-transparentă alfa.
keepTransparency bool
Dacă este setat, va lua în considerare alfa canale bite ale culorilor imaginii.
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
GetCloseTransparentImagePalette(Războiul, int)
Obține paleta de culoare din imaginea raster (palletizes imaginea) în cazul în care imaginea nu are una. în cazul în care paleta există va fi utilizat în loc de efectuarea calculelor.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Imaginea lui raster.
entriesCount int
Numărul de intrări dorite.
Returns
Paleta de culori care începe cu culorile cele mai frecvente din image’ și conține intrările entriesCount'.
GetDownscalePalette(RasterImage)
Obțineți o paletă de 256 de culori, compusă din bite superioare ale valorilor de culoare ale imaginii inițiale.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
şi imaginea .
Returns
Cuvânt cheie WL17_.ColorPalette.
GetUniformColorPalette(RasterImage)
Obțineți o paletă uniformă de 256 de culori.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
şi imaginea .
Returns
Cuvânt cheie WL17_.ColorPalette.
HasTransparentColors(Întâlnirea)
Determine dacă paleta specificată are culori transparente.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
şi paletă.
Returns
„verit” dacă paleta specificată are culori transparente; altfel, „false”.
Exceptions
palette’ is null.
