Class ColorPaletteHelper
İsim alanı : Aspose.Imaging Toplantı: Aspose.Imaging.dll (25.4.0)
Renk paletleri manipülasyonu için yardımcı sınıf.
public static class ColorPaletteHelperInheritance
mirasçı üyeleri
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
4 bit renk paleti oluşturur.
public static IColorPalette Create4Bit()Returns
4 bit renk paleti.
Create4BitGrayscale(bool)
4 bit greyscale paleti oluşturur.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Eğer “gerçek” olarak ayarlanırsa, palet beyaz renkle başlar, aksi takdirde siyah renkle başlar.
Returns
4 bit greyscale paleti.
Create8Bit()
8 bit renk paleti oluşturur.
public static IColorPalette Create8Bit()Returns
8 bit renk paleti.
Create8BitGrayscale(bool)
8 bit greyscale paleti oluşturur.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Eğer “gerçek” olarak ayarlanırsa, palet beyaz renkle başlar, aksi takdirde siyah renkle başlar.
Returns
8 bit grayscale paleti.
Examples
Aşağıdaki örnek bir gri ölçekli BMP görüntüsü oluşturur ve daha sonra bir dosyaya kaydeder.
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 ile)
Belirlenmiş bit sayısının gri ölçekli paletini alır. izin verilen bit değerleri 1, 2, 4, 8’dir.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Küçük bir sayım.
Returns
Grayscale çerçeve.
Exceptions
bits'
CreateMonochrome()
Sadece 2 renk içeren monochrome bir renk paleti oluşturur.
public static IColorPalette CreateMonochrome()Returns
Monokrom görüntüleri için renk paleti.
GetCloseImagePalette(Sürücüsüz, int)
Renk paleti raster görüntüsünden alınır (palletizes görüntüsü) eğer görüntü birine sahip değilse. eğer palet varsa, bunun yerine hesaplamaları yaparak kullanılacaktır.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Raster Görüntüleri
entriesCount int
İstediğiniz girişleri sayın.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
Examples
Aşağıdaki örnek bir BMP görüntüsünü yükler ve çeşitli tasarruf seçenekleri kullanarak BMP’ye geri kaydeder.
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);
}Aşağıdaki örnek, çıkış boyutunu azaltmak için bir BMP görüntüsünü nasıl paletize edeceğinizi gösterir.
// 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)
Görüntünün birine sahip olmadığı takdirde raster görüntüsünden renk paleti alır. paleti daha iyi indekslenmiş görüntü kalitesi için optimize edilecek veya PaletteMiningMethod.UseCurrentPalette kullanıldığında “AS IS” alınır.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
Raster Görüntüleri
entriesCount int
İstediğiniz girişleri sayın.
paletteMiningMethod PaletteMiningMethod
Palet madenciliği yöntemi.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
Examples
Aşağıdaki örnek, en uygun palet ile indekslenmiş renk kullanılarak bir PNG görüntüsünü nasıl sıkıştırdığını gösterir.
// 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 , int)
Renk paleti raster görüntüsünden alınır (palletizes görüntüsü) eğer görüntü birine sahip değilse. eğer palet varsa, bunun yerine hesaplamaları yaparak kullanılacaktır.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
Raster Görüntüleri
destBounds Rectangle
Amaç görüntüsü sınırlıdır.
entriesCount int
İstediğiniz girişleri sayın.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
GetCloseImagePalette(RasterImage, Rectangle, int, bool)
Renk paleti raster görüntüsünden alınır (palletizes görüntüsü) eğer görüntü birine sahip değilse. eğer palet varsa, bunun yerine hesaplamaları yaparak kullanılacaktır.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
Raster Görüntüleri
destBounds Rectangle
Amaç görüntüsü sınırlıdır.
entriesCount int
İstediğiniz girişleri sayın.
useImagePalette bool
Eğer ayarlanırsa, mevcutsa kendi görüntü paleti kullanır.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Renk)
Renk paleti raster görüntüsünden alınır (palletizes görüntüsü) eğer görüntü birine sahip değilse. eğer palet varsa, bunun yerine hesaplamaları yaparak kullanılacaktır.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
Raster Görüntüleri
destBounds Rectangle
Amaç görüntüsü sınırlıdır.
entriesCount int
İstediğiniz girişleri sayın.
useImagePalette bool
Eğer ayarlanırsa, mevcutsa kendi görüntü paleti kullanır.
alphaBlendInColor Color
Yarım şeffaf alfa değiştirme için bir arka plan rengi olarak kullanılması gereken renk.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Renk, bool)
Renk paleti raster görüntüsünden alınır (palletizes görüntüsü) eğer görüntü birine sahip değilse. eğer palet varsa, bunun yerine hesaplamaları yaparak kullanılacaktır.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
Raster Görüntüleri
destBounds Rectangle
Amaç görüntüsü sınırlıdır.
entriesCount int
İstediğiniz girişleri sayın.
useImagePalette bool
Eğer ayarlanırsa, mevcutsa kendi görüntü paleti kullanır.
alphaBlendInColor Color
Yarım şeffaf alfa değiştirme için bir arka plan rengi olarak kullanılması gereken renk.
keepTransparency bool
Eğer ayarlanırsa, görüntü renklerinin alfa kanal bitlerini göz önünde bulunduracaktır.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
GetCloseTransparentImagePalette(Sürücüsüz, int)
Renk paleti raster görüntüsünden alınır (palletizes görüntüsü) eğer görüntü birine sahip değilse. eğer palet varsa, bunun yerine hesaplamaları yaparak kullanılacaktır.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
Raster Görüntüleri
entriesCount int
İstediğiniz girişleri sayın.
Returns
image’den en yaygın renklerle başlayan renk paleti ve entriesCount’ girişleri içerir.
GetDownscalePalette(RasterImage)
256 renk paleti, başlangıç görüntü renk değerlerinin üst bitlerinden oluşur.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
Bu görüntü.
Returns
Renkler - Renkler - Renkler
GetUniformColorPalette(RasterImage)
Birleşik 256 renk paleti alın.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
Bu görüntü.
Returns
Renkler - Renkler - Renkler
HasTransparentColors(İKOLORPALETİ)
Belirlenen paletin şeffaf renkler olup olmadığını belirler.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
Palet için.
Returns
“gerçek” eğer belirtilen palet şeffaf renkler varsa; aksi takdirde, “sahte”.
Exceptions
palette’ is null.
