Class ColorPaletteHelper
Nazwa przestrzeń: Aspose.Imaging Zgromadzenie: Aspose.Imaging.dll (25.4.0)
Klasy pomocnicze do manipulacji paletami kolorów.
public static class ColorPaletteHelperInheritance
Dziedziczeni członkowie
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Tworzy 4 bitową paletę kolorów.
public static IColorPalette Create4Bit()Returns
4 bitowe palety kolorów.
Create4BitGrayscale(Bool)
Tworzy 4 bitową paletę grayscale.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Jeśli ustawione do “prawdy”, paleta zaczyna się od białego koloru, w przeciwnym razie zaczyna się od czarnego.
Returns
4 bitowe palety grayscale.
Create8Bit()
Tworzy 8 bitową paletę kolorów.
public static IColorPalette Create8Bit()Returns
8 litrów palety kolorów.
Create8BitGrayscale(Bool)
Tworzy 8 bitową paletę grayscale.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Jeśli ustawione do “prawdy”, paleta zaczyna się od białego koloru, w przeciwnym razie zaczyna się od czarnego.
Returns
8 bitową paletę grayscale.
Examples
Poniższy przykład tworzy paletowany obraz grayscale BMP, a następnie przechowuje go do pliku.
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)
Otrzymuje paletę grayscale określonego liczby bitów. dopuszczone wartości bitowe wynoszą 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
To małe liczenie.
Returns
Grayscale paletki.
Exceptions
bits'
CreateMonochrome()
Stwarza monochromatyczną paletę kolorów zawierającą tylko 2 kolory.
public static IColorPalette CreateMonochrome()Returns
Paleta kolorów dla obrazów monochromatycznych.
GetCloseImagePalette(Szydło, int)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Wizerunek rasterów.
entriesCount int
Pożądane wpisy liczą.
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
Examples
Poniższy przykład przesyła obraz BMP i przechowuje go z powrotem do BMP za pomocą różnych opcji oszczędzania.
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);
}Poniższy przykład pokazuje, jak paletizować obraz BMP, aby zmniejszyć jego rozmiar wyjścia.
// 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)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego. paleta jest gotowy do optymalizacji dla lepszej jakości indeksować obraz lub wziąć “AS IS”, gdy PaletteMiningMethod.UseCurrentPalette jest używany.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Wizerunek rasterów.
entriesCount int
Pożądane wpisy liczą.
paletteMiningMethod PaletteMiningMethod
Metoda wydobywania palety.
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
Examples
Poniższy przykład pokazuje, jak kompresować obraz PNG, używając kolorów indeksowanych z najlepszą paletą
// 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 , Int)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Wizerunek rasterów.
destBounds Rectangle
Zdjęcie docelowe ogranicza.
entriesCount int
Pożądane wpisy liczą.
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Wizerunek rasterów.
destBounds Rectangle
Zdjęcie docelowe ogranicza.
entriesCount int
Pożądane wpisy liczą.
useImagePalette bool
Jeśli ustawione, będzie używać własnej palety obrazu, jeśli dostępna
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Kolor)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Wizerunek rasterów.
destBounds Rectangle
Zdjęcie docelowe ogranicza.
entriesCount int
Pożądane wpisy liczą.
useImagePalette bool
Jeśli ustawione, będzie używać własnej palety obrazu, jeśli dostępna
alphaBlendInColor Color
Kolor, który powinien być używany jako kolor tła do półprzezroczystego zastąpienia alfa.
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Kolor, Bool)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Wizerunek rasterów.
destBounds Rectangle
Zdjęcie docelowe ogranicza.
entriesCount int
Pożądane wpisy liczą.
useImagePalette bool
Jeśli ustawione, będzie używać własnej palety obrazu, jeśli dostępna
alphaBlendInColor Color
Kolor, który powinien być używany jako kolor tła do półprzezroczystego zastąpienia alfa.
keepTransparency bool
Jeśli ustawione, będzie rozważyć alfa kanał bity kolorów obrazu.
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
GetCloseTransparentImagePalette(Szydło, int)
Otrzymuje paletę kolorów z obrazu raster (palletizes obraz) w przypadku, gdy obraz nie ma jednego.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Wizerunek rasterów.
entriesCount int
Pożądane wpisy liczą.
Returns
Paleta kolorów, która zaczyna się od najczęstszych kolorów z image’ i zawiera entriesCount’ wpisy.
GetDownscalePalette(RasterImage)
Uzyskaj 256 palet kolorów, składających się z górnych bitów wartości kolorów pierwotnego obrazu.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
i obrazu .
Returns
Zestawienie WL17_.ColorPalette
GetUniformColorPalette(RasterImage)
Wystarczy uzyskać 256 kolorów.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
i obrazu .
Returns
Zestawienie WL17_.ColorPalette
HasTransparentColors(Kolorowe palety)
Określa, czy określona paleta ma przejrzyste kolory.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
Na paletę.
Returns
“prawdziwy” jeśli określona paleta ma przejrzyste kolory; w przeciwnym razie “fałszywy”.
Exceptions
palette’ is null.
