Class ColorPaletteHelper
Der Name: Aspose.Imaging Versammlung: Aspose.Imaging.dll (25.4.0)
Hilferklasse für Farbpaletten Manipulation.
public static class ColorPaletteHelperInheritance
Vererbte Mitglieder
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Erstellt die 4 Bit-Farbpalette.
public static IColorPalette Create4Bit()Returns
Die 4 Bit Farbpalette.
Create4BitGrayscale(Bool)
Erstellt die 4 bit grayscale Palette.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Wenn die Palette auf “richtig” festgelegt wird, beginnt die Palette mit weißer Farbe, sonst beginnt sie mit schwarzer Farbe.
Returns
Die 4 bit grayscale Palette.
Create8Bit()
Erstellt die 8-Bit-Farbpalette.
public static IColorPalette Create8Bit()Returns
Die 8 Bit Farbpalette.
Create8BitGrayscale(Bool)
Erstellt die 8 bit grayscale Palette.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Wenn die Palette auf “richtig” festgelegt wird, beginnt die Palette mit weißer Farbe, sonst beginnt sie mit schwarzer Farbe.
Returns
Die 8 bit grayscale Palette.
Examples
Das folgende Beispiel erstellt eine palettierte Grayscale BMP-Bild und speichert es dann in eine Datei.
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)
Er erhält die Grayscale Palette der angegebenen Bitzahlen. Erlaubte Bitwerte sind 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Das kleine Zahlen.
Returns
Die Grayscale Palette.
Exceptions
bits'
CreateMonochrome()
Erstellt eine monochrome Farbpalette, die nur 2 Farben enthält.
public static IColorPalette CreateMonochrome()Returns
Farbpalette für monochrome Bilder.
GetCloseImagePalette(RasterImage, Int)
Fängt die Farbpalette aus dem Rasterbild (Palletizes Bild) ab, wenn das Bild nicht einen hat. Wenn Palette existiert, wird es stattdessen verwendet, um Berechnungen zu machen.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Das Raster Bild.
entriesCount int
Die gewünschten Einträge zählen.
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
Examples
Das folgende Beispiel laden ein BMP-Bild auf und speichert es zurück zu BMP mit verschiedenen Speicheroptionen.
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);
}Das folgende Beispiel zeigt, wie man ein BMP-Bild palletiert, um seine Ausgangsgröße zu reduzieren.
// 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ängt die Farbpalette aus dem Rasterbild (Palletizes Bild) an, wenn das Bild nicht einen hat. Die Palette wird für eine bessere indexierte Bildqualität optimiert oder “AS IS” genutzt, wenn PaletteMiningMethod.UseCurrentPalette verwendet wird.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Das Raster Bild.
entriesCount int
Die gewünschten Einträge zählen.
paletteMiningMethod PaletteMiningMethod
Die Palette Mining Methode.
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
Examples
Das folgende Beispiel zeigt, wie man ein PNG-Bild komprimiert, mit indexierter Farbe mit der am besten geeigneten 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(RasterImage, Rectangle, Int)
Fängt die Farbpalette aus dem Rasterbild (Palletizes Bild) ab, wenn das Bild nicht einen hat. Wenn Palette existiert, wird es stattdessen verwendet, um Berechnungen zu machen.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Das Raster Bild.
destBounds Rectangle
Der Zielbild begrenzt sich.
entriesCount int
Die gewünschten Einträge zählen.
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
GetCloseImagePalette(RasterImage, Rectangle, int, Bool)
Fängt die Farbpalette aus dem Rasterbild (Palletizes Bild) ab, wenn das Bild nicht einen hat. Wenn Palette existiert, wird es stattdessen verwendet, um Berechnungen zu machen.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Das Raster Bild.
destBounds Rectangle
Der Zielbild begrenzt sich.
entriesCount int
Die gewünschten Einträge zählen.
useImagePalette bool
Wenn festgelegt, wird es seine eigene Bildpalette verwenden, wenn verfügbar
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
GetCloseImagePalette(RasterImage, Rectangle, int, Bool, Farbe)
Fängt die Farbpalette aus dem Rasterbild (Palletizes Bild) ab, wenn das Bild nicht einen hat. Wenn Palette existiert, wird es stattdessen verwendet, um Berechnungen zu machen.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Das Raster Bild.
destBounds Rectangle
Der Zielbild begrenzt sich.
entriesCount int
Die gewünschten Einträge zählen.
useImagePalette bool
Wenn festgelegt, wird es seine eigene Bildpalette verwenden, wenn verfügbar
alphaBlendInColor Color
Die Farbe, die als Hintergrundfarbe für eine halb transparente Alpha Ersatz verwendet werden sollte.
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
GetCloseImagePalette(RasterImage, Rectangle, int, Bool, Farbe, Bool)
Fängt die Farbpalette aus dem Rasterbild (Palletizes Bild) ab, wenn das Bild nicht einen hat. Wenn Palette existiert, wird es stattdessen verwendet, um Berechnungen zu machen.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Das Raster Bild.
destBounds Rectangle
Der Zielbild begrenzt sich.
entriesCount int
Die gewünschten Einträge zählen.
useImagePalette bool
Wenn festgelegt, wird es seine eigene Bildpalette verwenden, wenn verfügbar
alphaBlendInColor Color
Die Farbe, die als Hintergrundfarbe für eine halb transparente Alpha Ersatz verwendet werden sollte.
keepTransparency bool
Wenn festgelegt, wird es die Alpha-Kanal-Bits der Bildfarben berücksichtigen.
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
GetCloseTransparentImagePalette(RasterImage, Int)
Fängt die Farbpalette aus dem Rasterbild (Palletizes Bild) ab, wenn das Bild nicht einen hat. Wenn Palette existiert, wird es stattdessen verwendet, um Berechnungen zu machen.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Das Raster Bild.
entriesCount int
Die gewünschten Einträge zählen.
Returns
Die Farbpalette beginnt mit den häufigsten Farben aus der image’ und enthält entriesCount’ Einträge.
GetDownscalePalette(RasterImage)
Erhalten Sie eine 256 Farbpalette, die aus den oberen Bits der ursprünglichen Farbwerte des Bildes besteht.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
Das Bild.
Returns
Das Aspose.Imaging.ColorPalette.
GetUniformColorPalette(RasterImage)
Erhalten Sie einheitliche 256 Farbpalette.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
Das Bild.
Returns
Das Aspose.Imaging.ColorPalette.
HasTransparentColors(ICOLORPALETTE)
Bestimmt, ob die angegebenen Palette transparente Farben hat.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
Und die Palette.
Returns
‘rich" wenn die angegebenen Palette transparente Farben hat; sonst “falsch’.
Exceptions
palette’ is null.
