Class ColorPaletteHelper
Název místa: Aspose.Imaging Shromáždění: Aspose.Imaging.dll (25.4.0)
Pomocná třída pro manipulaci barevnými paletami.
public static class ColorPaletteHelperInheritance
Dědiční členové
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Vytváří čtyřbitovou barevnou paletu.
public static IColorPalette Create4Bit()Returns
4 bitové barevné palety.
Create4BitGrayscale(Bolíček)
Vytváří čtyřbitovou paletu.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Pokud je nastaven na “pravdu”, paleta začíná bílou barvou, jinak začíná černou barvou.
Returns
4 bitová grayscale paleta.
Create8Bit()
Vytváří 8bitovou barevnou paletu.
public static IColorPalette Create8Bit()Returns
8bitová barevná paleta.
Create8BitGrayscale(Bolíček)
Vytváří 8bitovou šedou paletu.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Pokud je nastaven na “pravdu”, paleta začíná bílou barvou, jinak začíná černou barvou.
Returns
8 bitů grayscale palety.
Examples
Následující příklad vytváří paletovaný grayscale BMP obrázek a pak ho uloží do souboru.
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)
Obdrží šedou paletu stanoveného počtu bitů. Povolené bitové hodnoty jsou 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Je to malý počet.
Returns
Grayscale paleta.
Exceptions
bits'
CreateMonochrome()
Vytváří monochromatickou barevnou paletu obsahující pouze 2 barvy.
public static IColorPalette CreateMonochrome()Returns
Barevná paleta pro monochromatické obrázky.
GetCloseImagePalette(Vzdálenost, int)
Obdrží barevnou paletu z rasterového obrazu (palletizuje obraz) v případě, že obraz nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Snímek z rastu.
entriesCount int
Požadované vstupy počítaj.
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
Examples
Následující příklad nahrává obrázek BMP a ukládá ho zpět do BMP pomocí různých možností ušetřen.
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);
}Následující příklad ukazuje, jak palletizovat obrázek BMP, aby se snížila jeho výstupní velikost.
// 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)
Obdrží barevnou paletu z rasterového obrazu (palletizes image) v případě, že obrázek nemá jednu. paleta se blíží k optimalizaci pro lepší indexovanou kvalitu obrazu nebo se “AS IS” při použití PaletteMiningMethod.UseCurrentPalette.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Snímek z rastu.
entriesCount int
Požadované vstupy počítaj.
paletteMiningMethod PaletteMiningMethod
Metoda paletového těžby.
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
Examples
Následující příklad ukazuje, jak komprimovat PNG obrázek, pomocí indexované barvy s nejvhodnější paletou
// 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)
Obdrží barevnou paletu z rasterového obrazu (palletizuje obraz) v případě, že obraz nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Snímek z rastu.
destBounds Rectangle
Období cílového obrazu je omezeno.
entriesCount int
Požadované vstupy počítaj.
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Obdrží barevnou paletu z rasterového obrazu (palletizuje obraz) v případě, že obraz nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Snímek z rastu.
destBounds Rectangle
Období cílového obrazu je omezeno.
entriesCount int
Požadované vstupy počítaj.
useImagePalette bool
Pokud je nastaven, bude používat vlastní obrazovou paletu, pokud je k dispozici
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, barva)
Obdrží barevnou paletu z rasterového obrazu (palletizuje obraz) v případě, že obraz nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Snímek z rastu.
destBounds Rectangle
Období cílového obrazu je omezeno.
entriesCount int
Požadované vstupy počítaj.
useImagePalette bool
Pokud je nastaven, bude používat vlastní obrazovou paletu, pokud je k dispozici
alphaBlendInColor Color
Barva, která by měla být použita jako barva pozadí pro semi-transparentní alfa výměnu.
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, barva, bool)
Obdrží barevnou paletu z rasterového obrazu (palletizuje obraz) v případě, že obraz nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Snímek z rastu.
destBounds Rectangle
Období cílového obrazu je omezeno.
entriesCount int
Požadované vstupy počítaj.
useImagePalette bool
Pokud je nastaven, bude používat vlastní obrazovou paletu, pokud je k dispozici
alphaBlendInColor Color
Barva, která by měla být použita jako barva pozadí pro semi-transparentní alfa výměnu.
keepTransparency bool
Pokud je nastaven, bude zvážit alfa kanály bity barvy obrazu.
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
GetCloseTransparentImagePalette(Vzdálenost, int)
Obdrží barevnou paletu z rasterového obrazu (palletizuje obraz) v případě, že obraz nemá jednu.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Snímek z rastu.
entriesCount int
Požadované vstupy počítaj.
Returns
Barevná paleta, která začíná nejčastějšími barvami z image’ a obsahuje entriesCount’ vstupy.
GetDownscalePalette(RasterImage)
Získejte 256 barevnou paletu, skládající se z horních bitů počátečních barevných hodnot obrázku.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
To je obraz.
Returns
Přečtěte si o tématu: Imagination.ColorPalette.
GetUniformColorPalette(RasterImage)
Získejte uniformní 256 barevnou paletu.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
To je obraz.
Returns
Přečtěte si o tématu: Imagination.ColorPalette.
HasTransparentColors(Ikolorová paleta)
Určuje, zda specifikovaná paleta má transparentní barvy.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
A paleta je.
Returns
‘pravdivá“ pokud specifikovaná paleta má transparentní barvy; jinak „falšovan’.
Exceptions
palette’ is null.
