Class ColorPaletteHelper
Το όνομα: Aspose.Imaging Συγκέντρωση: Aspose.Imaging.dll (25.4.0)
Βοηθός τάξη για την χειραγώγηση παλέτες χρωμάτων.
public static class ColorPaletteHelperInheritance
Κληρονομημένα μέλη
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Δημιουργεί την παλέτα χρωμάτων 4 bit.
public static IColorPalette Create4Bit()Returns
Το 4 bit χρώμα παλέτα.
Create4BitGrayscale(Μπόλ)
Δημιουργεί την 4 bit γκρίζα παλέτα.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Εάν η παλέτα ξεκινά με λευκό χρώμα, αλλιώς ξεκινά με μαύρο.
Returns
Το 4 bit γκρίζα παλέτα.
Create8Bit()
Δημιουργεί την παλέτα χρωμάτων 8 bit.
public static IColorPalette Create8Bit()Returns
Η παλέτα χρωμάτων 8 bit.
Create8BitGrayscale(Μπόλ)
Δημιουργεί την παλέτα 8 bit γκρίζας.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Εάν η παλέτα ξεκινά με λευκό χρώμα, αλλιώς ξεκινά με μαύρο.
Returns
Η παλέτα 8 bit γκρίζας.
Examples
Το παρακάτω παράδειγμα δημιουργεί μια παλέτη γραφική εικόνα BMP και στη συνέχεια την αποθηκεύει σε ένα αρχείο.
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(ΕΝΤ)
Απολαμβάνει την γκρίζα παλέτα του καθορισμένου αριθμού bit. Οι επιτρεπόμενες τιμές bit είναι 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Ο μικρός αριθμός.
Returns
Πλατφόρμα Grayscale.
Exceptions
bits'
CreateMonochrome()
Δημιουργεί μια μονοχρωματική παλέτα χρωμάτων που περιέχει μόνο 2 χρώματα.
public static IColorPalette CreateMonochrome()Returns
Παλέτα χρωμάτων για μονοχρωμικές εικόνες.
GetCloseImagePalette(Παρουσίαση, int)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. σε περίπτωση παλέτας υπάρχει θα χρησιμοποιηθεί αντί να εκτελεί υπολογισμούς.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Η εικόνα του Ράστερ.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
Examples
Το παρακάτω παράδειγμα φορτώνει μια εικόνα BMP και την αποθηκεύει πίσω στο BMP χρησιμοποιώντας διάφορες επιλογές αποθήκευσης.
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);
}Το παρακάτω παράδειγμα δείχνει πώς να παλέσει μια εικόνα BMP για να μειώσει το μέγεθος της παραγωγής της.
// 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(Φωτογραφία, int, PaletteMiningMethod)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. παλέτα πρόκειται να βελτιστοποιηθεί για την καλύτερη ποιότητα της εικόνας indexed ή λαμβάνεται “AS IS” όταν χρησιμοποιείται PaletteMiningMethod.UseCurrentPalette.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Η εικόνα του Ράστερ.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
paletteMiningMethod PaletteMiningMethod
Η μέθοδος εξόρυξης παλέτας.
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
Examples
Το παρακάτω παράδειγμα δείχνει πώς να συμπιέσετε μια εικόνα PNG, χρησιμοποιώντας δείκτη χρώματος με την καλύτερη παλέτα που ταιριάζει
// 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(Ετικέτες, Rectangle, int)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. σε περίπτωση παλέτας υπάρχει θα χρησιμοποιηθεί αντί να εκτελεί υπολογισμούς.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Η εικόνα του Ράστερ.
destBounds Rectangle
Η εικόνα του προορισμού περιορίζεται.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
GetCloseImagePalette(Ρέκταγκλ, Rectangle, int, bool)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. σε περίπτωση παλέτας υπάρχει θα χρησιμοποιηθεί αντί να εκτελεί υπολογισμούς.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Η εικόνα του Ράστερ.
destBounds Rectangle
Η εικόνα του προορισμού περιορίζεται.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
useImagePalette bool
Εάν ρυθμιστεί, θα χρησιμοποιήσει τη δική του παλέτα εικόνας, εάν είναι διαθέσιμη
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, Bool, Χρώμα)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. σε περίπτωση παλέτας υπάρχει θα χρησιμοποιηθεί αντί να εκτελεί υπολογισμούς.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Η εικόνα του Ράστερ.
destBounds Rectangle
Η εικόνα του προορισμού περιορίζεται.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
useImagePalette bool
Εάν ρυθμιστεί, θα χρησιμοποιήσει τη δική του παλέτα εικόνας, εάν είναι διαθέσιμη
alphaBlendInColor Color
Το χρώμα που πρέπει να χρησιμοποιηθεί ως χρώμα φόντου για ημι-διαφανή υποκατάστατο αλφα.
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Χρώμα, bool)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. σε περίπτωση παλέτας υπάρχει θα χρησιμοποιηθεί αντί να εκτελεί υπολογισμούς.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Η εικόνα του Ράστερ.
destBounds Rectangle
Η εικόνα του προορισμού περιορίζεται.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
useImagePalette bool
Εάν ρυθμιστεί, θα χρησιμοποιήσει τη δική του παλέτα εικόνας, εάν είναι διαθέσιμη
alphaBlendInColor Color
Το χρώμα που πρέπει να χρησιμοποιηθεί ως χρώμα φόντου για ημι-διαφανή υποκατάστατο αλφα.
keepTransparency bool
Εάν ρυθμιστεί, θα εξετάσει το άλφα κανάλι bit των χρωμάτων της εικόνας.
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
GetCloseTransparentImagePalette(Παρουσίαση, int)
Λαμβάνει χρώμα παλέτα από την εικόνα ράστερ (palletizes εικόνα) σε περίπτωση που η εικόνα δεν έχει ένα. σε περίπτωση παλέτας υπάρχει θα χρησιμοποιηθεί αντί να εκτελεί υπολογισμούς.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Η εικόνα του Ράστερ.
entriesCount int
Οι επιθυμητές εισαγωγές υπολογίζονται.
Returns
Η παλέτα χρωμάτων που ξεκινά με τα πιο συνηθισμένα χρώματα από την image’ και περιέχει τις εισαγωγές entriesCount'.
GetDownscalePalette(RasterImage)
Αποκτήστε μια παλέτα χρωμάτων 256 που αποτελείται από ανώτερα bit των αρχικών τιμών χρωμάτων εικόνας.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
Η εικόνα .
Returns
Φωτογραφία - Φωτογραφία - Φωτογραφία - ColorPalette
GetUniformColorPalette(RasterImage)
Αποκτήστε ομοιόμορφη παλέτα 256 χρωμάτων.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
Η εικόνα .
Returns
Φωτογραφία - Φωτογραφία - Φωτογραφία - ColorPalette
HasTransparentColors(ΙΚΟΛΟΡΦΙΑ)
Προσδιορίζει αν η καθορισμένη παλέτα έχει διαφανή χρώματα.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
Το παλέτο.
Returns
«πραγματικό» εάν η καθορισμένη παλέτα έχει διαφανή χρώματα, αλλιώς «ψεύτικο».
Exceptions
palette’ is null.
