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 біт кольорової палички.
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(Різдво, ІТ)
Отримає кольорову палету з растерного зображення (палетізує зображення), якщо зображення не має одного.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Створення Raster Image.
entriesCount int
Розрахунок бажаних входів.
Returns
Палет кольорів, який починається з найчастіших кольорів з image’ і містить входи entriesCount'.
Examples
Наступний приклад завантажує зображення BMP і зберігає його назад до BMPs за допомогою різних варіантів збереження.
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, PaletteMiningMethod)
Палет наближається до оптимізації для кращого індексування якості зображення або приймається “AS IS” при використанні PaletteMiningMethod.UseCurrentPalette.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Створення Raster Image.
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(Створення RasterImage, Rectangle)
Отримає кольорову палету з растерного зображення (палетізує зображення), якщо зображення не має одного.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Створення Raster Image.
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
Створення Raster Image.
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
Створення Raster Image.
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
Створення Raster Image.
destBounds Rectangle
Мета зображення обмежується.
entriesCount int
Розрахунок бажаних входів.
useImagePalette bool
Якщо встановлено, вона буде використовувати свою власну палету зображень, якщо вона доступна
alphaBlendInColor Color
Колір, який повинен бути використаний в якості кольору фону для напівпрозорої альфа заміни.
keepTransparency bool
Якщо встановлено, він розгляне альфа-канал бітів кольорів зображення.
Returns
Палет кольорів, який починається з найчастіших кольорів з image’ і містить входи entriesCount'.
GetCloseTransparentImagePalette(Різдво, ІТ)
Отримає кольорову палету з растерного зображення (палетізує зображення), якщо зображення не має одного.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Створення Raster Image.
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(Ікольорпалет)
Визначити, чи є в зазначеній палеті прозорі кольори.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
Про палету .
Returns
«правда», якщо зазначена палетка має прозорі кольори; в іншому випадку «фальсифікована».
Exceptions
palette’ is null.
