Class ColorPaletteHelper
Nombre del espacio: Aspose.Imaging Asamblea: Aspose.Imaging.dll (25.4.0)
Clase de ayuda para la manipulación de paletas de color.
public static class ColorPaletteHelperInheritance
Miembros heredados
object.GetType() ,y, object.MemberwiseClone() ,y, object.ToString() ,y, object.Equals(object?) ,y, object.Equals(object?, object?) ,y, object.ReferenceEquals(object?, object?) ,y, object.GetHashCode()
Methods
Create4Bit()
Crea la paleta de colores de 4 bits.
public static IColorPalette Create4Bit()Returns
La paleta de colores de 4 bits.
Create4BitGrayscale(BOOL)
Crea la paleta de 4 bits.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Si se establece para “verdad” la paleta comienza con color blanco, de lo contrario comienza con color negro.
Returns
La paleta de 4 bits de gris.
Create8Bit()
Crea la paleta de color de 8 bits.
public static IColorPalette Create8Bit()Returns
La paleta de color de 8 bits.
Create8BitGrayscale(BOOL)
Crea la paleta de 8 bits.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Si se establece para “verdad” la paleta comienza con color blanco, de lo contrario comienza con color negro.
Returns
La paleta de 8 bits de gris.
Examples
El siguiente ejemplo crea una imagen de grayscale BMP paletada y luego la salva en un archivo.
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)
Recibe la paleta de gracia de la cuantía de bites especificada. Los valores de bites permitidos son 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
El pequeño cuento.
Returns
La paleta de Grayscale.
Exceptions
bits'
CreateMonochrome()
Crea una paleta de colores monochrómicos que contiene sólo 2 colores.
public static IColorPalette CreateMonochrome()Returns
Paleta de colores para imágenes monochrómicas.
GetCloseImagePalette(Cortesía, int)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en el caso de que la imagen no tenga una. en el caso de que la paleta exista se utilizará en lugar de realizar cálculos.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
La imagen del raster.
entriesCount int
Las entradas deseadas se cuentan.
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
Examples
El siguiente ejemplo carga una imagen de BMP y la salva de nuevo a BMP utilizando varias opciones de ahorro.
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);
}El siguiente ejemplo muestra cómo paletizar una imagen BMP para reducir su tamaño de salida.
// 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)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en caso de que la imagen no tenga una. la paleta está a punto de ser optimizada para una mejor calidad de imagen indexada o tomada “AS IS” cuando se utiliza PaletteMiningMethod.UseCurrentPalette.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
La imagen del raster.
entriesCount int
Las entradas deseadas se cuentan.
paletteMiningMethod PaletteMiningMethod
El método de minería de paletas.
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
Examples
El siguiente ejemplo muestra cómo comprimir una imagen PNG, utilizando el color indexado con la mejor paleta
// 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, Rectangle y Int)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en el caso de que la imagen no tenga una. en el caso de que la paleta exista se utilizará en lugar de realizar cálculos.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
La imagen del raster.
destBounds Rectangle
La imagen de destino está limitada.
entriesCount int
Las entradas deseadas se cuentan.
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en el caso de que la imagen no tenga una. en el caso de que la paleta exista se utilizará en lugar de realizar cálculos.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
La imagen del raster.
destBounds Rectangle
La imagen de destino está limitada.
entriesCount int
Las entradas deseadas se cuentan.
useImagePalette bool
Si se establece, utilizará su propia paleta de imagen si está disponible
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en el caso de que la imagen no tenga una. en el caso de que la paleta exista se utilizará en lugar de realizar cálculos.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
La imagen del raster.
destBounds Rectangle
La imagen de destino está limitada.
entriesCount int
Las entradas deseadas se cuentan.
useImagePalette bool
Si se establece, utilizará su propia paleta de imagen si está disponible
alphaBlendInColor Color
El color que debe utilizarse como color de fondo para la sustitución alfa semi-transparente.
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color, bool)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en el caso de que la imagen no tenga una. en el caso de que la paleta exista se utilizará en lugar de realizar cálculos.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
La imagen del raster.
destBounds Rectangle
La imagen de destino está limitada.
entriesCount int
Las entradas deseadas se cuentan.
useImagePalette bool
Si se establece, utilizará su propia paleta de imagen si está disponible
alphaBlendInColor Color
El color que debe utilizarse como color de fondo para la sustitución alfa semi-transparente.
keepTransparency bool
Si se establece, considerará los bits de canal alfa de los colores de la imagen.
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
GetCloseTransparentImagePalette(Cortesía, int)
Obtenga la paleta de color de la imagen de raster (palletizes imagen) en el caso de que la imagen no tenga una. en el caso de que la paleta exista se utilizará en lugar de realizar cálculos.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
La imagen del raster.
entriesCount int
Las entradas deseadas se cuentan.
Returns
La paleta de colores que comienza con los colores más frecuentes de la imagen y contiene las entradas de entriesCount.
GetDownscalePalette(RasterImage)
Obtenga una paleta de 256 colores, compuesta de los bits superiores de los valores de color de la imagen inicial.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
La imagen.
Returns
El Aspose.Imaging.ColorPalette.
GetUniformColorPalette(RasterImage)
Obtenga una paleta de 256 colores uniforme.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
La imagen.
Returns
El Aspose.Imaging.ColorPalette.
HasTransparentColors(ICOLORPALETA)
Determina si la paleta especificada tiene colores transparentes.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
y la paleta.
Returns
‘verdad’ si la paleta especificada tiene colores transparentes; de lo contrario, ‘falso’.
Exceptions
palette’ is null.
