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 битную цветную палету.
public static IColorPalette Create4Bit()Returns
4 bit цветной палиты.
Create4BitGrayscale(Боол)
Создает 4 битную грейскальную палту.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Если поставить на «правду», палет начинается с белого цвета, в противном случае начинается с черного цвета.
Returns
4 бита грейскальной палиты.
Create8Bit()
Создает 8-битную цветную палету.
public static IColorPalette Create8Bit()Returns
8 битов цветной палиты.
Create8BitGrayscale(Боол)
Создает 8-битную грейскальную палту.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Если поставить на «правду», палет начинается с белого цвета, в противном случае начинается с черного цвета.
Returns
8 бит грейскальной палиты.
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(ИНТ)
Получается палетка грейскалей определенного числа бит. Допустимые битные значения составляют 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Считается немного.
Returns
Грейскальная палетка.
Exceptions
bits'
CreateMonochrome()
Создает монохромную палету цветов, содержащую только 2 цвета.
public static IColorPalette CreateMonochrome()Returns
Палетка цветов для монохромных изображений.
GetCloseImagePalette(Изображение, int)
Получается цветная палетка из изображения растер (палетки изображения) в том случае, если изображение не имеет одной.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Изображение растер.
entriesCount int
Считается желаемое количество входов.
Returns
Палетка цветов, которая начинается с наиболее частых цветов из image’ и содержит entriesCount’ входы.
Examples
Следующий пример загружает 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(RasterImage, int, PaletteMiningМетод)
Получается цветная палетка из изображения растер (палетки изображений) в том случае, если изображение не имеет одного. Палетку предстоит оптимизировать для лучшего индексируемого качества картины или принимать «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(РастерИмаж, Ректангль, инт)
Получается цветная палетка из изображения растер (палетки изображения) в том случае, если изображение не имеет одной.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Изображение растер.
destBounds Rectangle
Место назначения изображения ограничивается.
entriesCount int
Считается желаемое количество входов.
Returns
Палетка цветов, которая начинается с наиболее частых цветов из image’ и содержит entriesCount’ входы.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Получается цветная палетка из изображения растер (палетки изображения) в том случае, если изображение не имеет одной.
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, цвет)
Получается цветная палетка из изображения растер (палетки изображения) в том случае, если изображение не имеет одной.
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)
Получается цветная палетка из изображения растер (палетки изображения) в том случае, если изображение не имеет одной.
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
Если установлено, то будет рассматриваться альфа-канал битов цвета изображения.
Returns
Палетка цветов, которая начинается с наиболее частых цветов из image’ и содержит entriesCount’ входы.
GetCloseTransparentImagePalette(Изображение, int)
Получается цветная палетка из изображения растер (палетки изображения) в том случае, если изображение не имеет одной.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Изображение растер.
entriesCount int
Считается желаемое количество входов.
Returns
Палетка цветов, которая начинается с наиболее частых цветов из image’ и содержит entriesCount’ входы.
GetDownscalePalette(RasterImage)
Получите 256 цветных палетов, состоящих из верхних битов первоначальных цветовых значений изображения.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
Изображение .
Returns
На сайте Aspose.Imaging.ColorPalette.
GetUniformColorPalette(RasterImage)
Получите унифицированную 256 цветную палету.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
Изображение .
Returns
На сайте Aspose.Imaging.ColorPalette.
HasTransparentColors(ICOLORПАЛЕТ)
Определяет, имеет ли указанная палет прозрачные цвета.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
и палеты .
Returns
«Правда», если указанная палетка имеет прозрачные цвета; в противном случае, «фальшивая».
Exceptions
palette’ is null.
