Class ColorPaletteHelper
Pôvodný názov: Aspose.Imaging Zhromaždenie: Aspose.Imaging.dll (25.4.0)
Pomocná trieda pre manipuláciu farebnými paletami.
public static class ColorPaletteHelperInheritance
Z dedičných členov
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Vytvára 4 bitovú farebnú paletu.
public static IColorPalette Create4Bit()Returns
4 bitová farebná paleta.
Create4BitGrayscale(bool)
Vytvára štyri bitové palety.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Ak je nastavený na “skutočný”, paleta začína bielou farbou, inak začína čiernou farbou.
Returns
4 bitová grilovacia paleta.
Create8Bit()
Vytvára 8 bitovú farebnú paletu.
public static IColorPalette Create8Bit()Returns
8 bitová farebná paleta.
Create8BitGrayscale(bool)
Vytvára 8 bitovú šedú paletu.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Ak je nastavený na “skutočný”, paleta začína bielou farbou, inak začína čiernou farbou.
Returns
8 bitová grécka paleta.
Examples
Nasledujúci príklad vytvára paletovaný obraz BMP a potom ho ukladá do súboru.
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)
Získa paletu špecifikovaného počtu bitov. Povolené bitové hodnoty sú 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
To je malý počet.
Returns
Grayscale paleta
Exceptions
bits'
CreateMonochrome()
Vytvára monochrómovú farebnú paletu obsahujúcu iba 2 farby.
public static IColorPalette CreateMonochrome()Returns
Farebná paleta pre monochrómové obrázky.
GetCloseImagePalette(Rozšírenie, int)
Dostane farebnú paletu z rasterového obrazu (palletizes obrázok) v prípade, že obrázok nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Obrázok z rastu.
entriesCount int
Požadované vstupy sa počítajú.
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
Examples
Nasledujúci príklad nahráva obrázok BMP a ušetrí ho späť do BMPs pomocou rôznych možností ušetrenia.
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);
}Nasledujúci príklad ukazuje, ako palletizovať BMP obrázok na zníženie jeho výstupnej veľkosti.
// 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, PaletteMiningMetóda)
Obdrží farebnú paletu z rasterového obrazu (palletizes image) v prípade, že obraz nemá jednu. paleta sa blíži k optimalizácii pre lepšiu indexovanú kvalitu obrázka alebo sa “AS IS” pri používaní PaletteMiningMethod.UseCurrentPalette.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Obrázok z rastu.
entriesCount int
Požadované vstupy sa počítajú.
paletteMiningMethod PaletteMiningMethod
Metóda paletového ťažby.
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
Examples
Nasledujúci príklad ukazuje, ako komprimovať obrázok PNG pomocou indexovanej farby s najlepšou 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)
Dostane farebnú paletu z rasterového obrazu (palletizes obrázok) v prípade, že obrázok nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Obrázok z rastu.
destBounds Rectangle
Obmedzuje sa obrázok destinácie.
entriesCount int
Požadované vstupy sa počítajú.
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Dostane farebnú paletu z rasterového obrazu (palletizes obrázok) v prípade, že obrázok nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Obrázok z rastu.
destBounds Rectangle
Obmedzuje sa obrázok destinácie.
entriesCount int
Požadované vstupy sa počítajú.
useImagePalette bool
Ak je nastavený, bude používať vlastnú obrazovú paletu, ak je k dispozícii
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, farba)
Dostane farebnú paletu z rasterového obrazu (palletizes obrázok) v prípade, že obrázok nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Obrázok z rastu.
destBounds Rectangle
Obmedzuje sa obrázok destinácie.
entriesCount int
Požadované vstupy sa počítajú.
useImagePalette bool
Ak je nastavený, bude používať vlastnú obrazovú paletu, ak je k dispozícii
alphaBlendInColor Color
Farba, ktorá by mala byť použitá ako farba pozadia pre semi-prirodzenú náhradu alfa.
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, farba, Bool)
Dostane farebnú paletu z rasterového obrazu (palletizes obrázok) v prípade, že obrázok nemá jednu.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Obrázok z rastu.
destBounds Rectangle
Obmedzuje sa obrázok destinácie.
entriesCount int
Požadované vstupy sa počítajú.
useImagePalette bool
Ak je nastavený, bude používať vlastnú obrazovú paletu, ak je k dispozícii
alphaBlendInColor Color
Farba, ktorá by mala byť použitá ako farba pozadia pre semi-prirodzenú náhradu alfa.
keepTransparency bool
Ak je nastavený, bude zvážiť alfa kanálové bity farieb obrazu.
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
GetCloseTransparentImagePalette(Rozšírenie, int)
Dostane farebnú paletu z rasterového obrazu (palletizes obrázok) v prípade, že obrázok nemá jednu.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Obrázok z rastu.
entriesCount int
Požadované vstupy sa počítajú.
Returns
Farebná paleta, ktorá začína najčastejšími farbami z image’ a obsahuje položky entriesCount'.
GetDownscalePalette(RasterImage)
Získajte 256 farebnú paletu, ktorá sa skladá z vrchných bitov pôvodných farebných hodnôt obrazu.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
a obrázok .
Returns
Zariadenie Aspose.Imaging.ColorPalette
GetUniformColorPalette(RasterImage)
Získajte uniformnú 256 farebnú paletu.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
a obrázok .
Returns
Zariadenie Aspose.Imaging.ColorPalette
HasTransparentColors(farebná paleta)
Určuje, či špecifikovaná paleta má transparentné farby.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
a palety .
Returns
“skutočná” ak špecifikovaná paleta má priehľadné farby; inak, “falšovaná”.
Exceptions
palette’ is null.
