Class ColorPaletteHelper
Nome do espaço: Aspose.Imaging Assembleia: Aspose.Imaging.dll (25.4.0)
Clase de auxílio para manipulação de paletes de cores.
public static class ColorPaletteHelperInheritance
Membros herdados
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Crie a paleta de cores de 4 bits.
public static IColorPalette Create4Bit()Returns
A paleta de cores de 4 bits.
Create4BitGrayscale(Bolha)
Crie a paleta de 4 bits.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Se definido para “verdadeiro”, a paleta começa com a cor branca, caso contrário, começa com a cor preta.
Returns
A paleta de 4 bit grayscale.
Create8Bit()
Crie a paleta de cores de 8 bits.
public static IColorPalette Create8Bit()Returns
Paleta de cores de 8 bits.
Create8BitGrayscale(Bolha)
Crie a paleta de 8 bits.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Se definido para “verdadeiro”, a paleta começa com a cor branca, caso contrário, começa com a cor preta.
Returns
A paleta de 8 bits.
Examples
O exemplo a seguir cria uma imagem de grayscale BMP paletada e, em seguida, a salva em um arquivo.
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)
Obtenha a paleta de grauscale do número de bit especificado. os valores de bit permitidos são 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
O pequeno número.
Returns
Palete de graça.
Exceptions
bits'
CreateMonochrome()
Cria uma paleta de cores monocrômica que contém apenas 2 cores.
public static IColorPalette CreateMonochrome()Returns
Paleta de cores para imagens monocromáticas.
GetCloseImagePalette(Apresentação, int)
Obter a paleta de cor da imagem de raster (palletizes imagem) no caso da imagem não tem uma.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
A imagem do rasto.
entriesCount int
As entradas desejadas contam.
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
Examples
O exemplo a seguir carrega uma imagem BMP e a salva de volta para BMP usando várias opções de poupança.
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);
}O exemplo a seguir mostra como paletizar uma imagem BMP para reduzir o seu tamanho de saída.
// 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)
Recebe a paleta de cor da imagem raster (palletizes imagem) se a imagem não tiver uma. Paleta está prestes a ser otimizada para melhor qualidade de imagem indexada ou tomada “AS IS” quando PaletteMiningMethod.UseCurrentPalette é usado.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
A imagem do rasto.
entriesCount int
As entradas desejadas contam.
paletteMiningMethod PaletteMiningMethod
Método de mineração de paletes.
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
Examples
O exemplo a seguir mostra como comprimir uma imagem PNG, usando a cor indexada com a melhor 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(Título: Rectangle, Int)
Obter a paleta de cor da imagem de raster (palletizes imagem) no caso da imagem não tem uma.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
A imagem do rasto.
destBounds Rectangle
A imagem de destino é limitada.
entriesCount int
As entradas desejadas contam.
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
GetCloseImagePalette(Título: Rectangle, int, bool)
Obter a paleta de cor da imagem de raster (palletizes imagem) no caso da imagem não tem uma.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
A imagem do rasto.
destBounds Rectangle
A imagem de destino é limitada.
entriesCount int
As entradas desejadas contam.
useImagePalette bool
Se configurado, utilizará sua própria paleta de imagem, se disponível
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, cor)
Obter a paleta de cor da imagem de raster (palletizes imagem) no caso da imagem não tem uma.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
A imagem do rasto.
destBounds Rectangle
A imagem de destino é limitada.
entriesCount int
As entradas desejadas contam.
useImagePalette bool
Se configurado, utilizará sua própria paleta de imagem, se disponível
alphaBlendInColor Color
A cor que deve ser usada como uma cor de fundo para substituição alfa semi-transparente.
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color, bool)
Obter a paleta de cor da imagem de raster (palletizes imagem) no caso da imagem não tem uma.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
A imagem do rasto.
destBounds Rectangle
A imagem de destino é limitada.
entriesCount int
As entradas desejadas contam.
useImagePalette bool
Se configurado, utilizará sua própria paleta de imagem, se disponível
alphaBlendInColor Color
A cor que deve ser usada como uma cor de fundo para substituição alfa semi-transparente.
keepTransparency bool
Se configurado, considerará bits de canal alfa das cores da imagem.
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
GetCloseTransparentImagePalette(Apresentação, int)
Obter a paleta de cor da imagem de raster (palletizes imagem) no caso da imagem não tem uma.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
A imagem do rasto.
entriesCount int
As entradas desejadas contam.
Returns
A paleta de cores que começa com as cores mais comuns da image’ e contém entriesCount’ entradas.
GetDownscalePalette(RasterImage)
Obtenha uma paleta de 256 cores, composta de bits superiores dos valores de cor da imagem inicial.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
A imagem .
Returns
Apresentação.Imaging.ColorPalette
GetUniformColorPalette(RasterImage)
Obter uma paleta de 256 cores uniforme.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
A imagem .
Returns
Apresentação.Imaging.ColorPalette
HasTransparentColors(Iluminação)
Determina se a paleta especificada tem cores transparentes.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
e a paleta.
Returns
‘verdadeiro’ se a paleta especificada tem cores transparentes; caso contrário, ‘falso’.
Exceptions
palette’ is null.
