Class ColorPaletteHelper
Le nom : Aspose.Imaging Assemblée: Aspose.Imaging.dll (25.4.0)
Classement d’aide pour la manipulation des palettes de couleurs.
public static class ColorPaletteHelperInheritance
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Créez la palette de couleurs de 4 bits.
public static IColorPalette Create4Bit()Returns
La palette de couleurs de 4 bits.
Create4BitGrayscale(Boulée)
Créer la palette de 4 bits grayscale.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
si la palette commence par la couleur blanche, sinon elle commence par la couleur noire.
Returns
La palette de 4 bit grayscale.
Create8Bit()
Créez la palette de couleurs de 8 bits.
public static IColorPalette Create8Bit()Returns
La palette de couleur de 8 bits.
Create8BitGrayscale(Boulée)
Création de la palette de 8 bits.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
si la palette commence par la couleur blanche, sinon elle commence par la couleur noire.
Returns
La palette de 8 bit grayscale.
Examples
L’exemple suivant crée une image de grayscale palliée et la sauve ensuite dans un fichier.
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)
Obtenez la palette grayscale du nombre de bit spécifié. Les valeurs autorisées sont 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Le petit compte.
Returns
La palette graisseuse.
Exceptions
bits'
CreateMonochrome()
Il crée une palette de couleurs monochrome contenant seulement 2 couleurs.
public static IColorPalette CreateMonochrome()Returns
Palette de couleurs pour les images monochrômes.
GetCloseImagePalette(Méditerranée, int)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
L’image du raser.
entriesCount int
Les entrées souhaitées comptent.
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
Examples
L’exemple suivant chargera une image BMP et la sauvegarde à l’aide de différentes options d’enregistrement.
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);
}L’exemple ci-dessous montre comment pallier une image BMP pour réduire sa taille de sortie.
// 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(Images, int, PaletteMiningMethode)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une. la Palette est sur le point d’être optimisée pour une meilleure qualité d’imagerie indexée ou prendre “AS IS” lorsqu’on utilise PalletMiningMethod.UseCurrent
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
L’image du raser.
entriesCount int
Les entrées souhaitées comptent.
paletteMiningMethod PaletteMiningMethod
La méthode de minage de palette.
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
Examples
L’exemple ci-dessous montre comment comprimer une image PNG, en utilisant la couleur indexée avec la meilleure 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(Télécharger Rectangle, int)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
L’image du raser.
destBounds Rectangle
L’image de destination est limitée.
entriesCount int
Les entrées souhaitées comptent.
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
L’image du raser.
destBounds Rectangle
L’image de destination est limitée.
entriesCount int
Les entrées souhaitées comptent.
useImagePalette bool
S’il est configuré, il utilisera sa propre palette d’image si disponible
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, couleur)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
L’image du raser.
destBounds Rectangle
L’image de destination est limitée.
entriesCount int
Les entrées souhaitées comptent.
useImagePalette bool
S’il est configuré, il utilisera sa propre palette d’image si disponible
alphaBlendInColor Color
La couleur qui devrait être utilisée comme couleur de fond pour un remplacement alpha semi-transparent.
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Couleur, Bool)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
L’image du raser.
destBounds Rectangle
L’image de destination est limitée.
entriesCount int
Les entrées souhaitées comptent.
useImagePalette bool
S’il est configuré, il utilisera sa propre palette d’image si disponible
alphaBlendInColor Color
La couleur qui devrait être utilisée comme couleur de fond pour un remplacement alpha semi-transparent.
keepTransparency bool
S’il est configuré, il prendra en compte les bits du canal alpha des couleurs de l’image.
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
GetCloseTransparentImagePalette(Méditerranée, int)
Obtenez la palette de couleur de l’image de raster (palletizes image) dans le cas où l’image n’a pas une.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
L’image du raser.
entriesCount int
Les entrées souhaitées comptent.
Returns
La palette de couleurs qui commence avec les couleurs les plus fréquentes de l’image " et contient les entrées entriesCount'.
GetDownscalePalette(RasterImage)
Obtenez une palette de 256 couleurs, composée de bits supérieurs des valeurs de couleur d’image initiale.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
La immagine .
Returns
Le Aspose.Imaging.ColorPalette.
GetUniformColorPalette(RasterImage)
Obtenez une palette de 256 couleurs uniforme.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
La immagine .
Returns
Le Aspose.Imaging.ColorPalette.
HasTransparentColors(L’ICOLORPALETE)
Déterminer si la palette spécifiée a des couleurs transparentes.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
et la palette.
Returns
« vrai » si la palette spécifiée a des couleurs transparentes ; autrement, « faux ».
Exceptions
palette’ is null.
