Class ColorPaletteHelper
ja nimityö: Aspose.Imaging Kokoelma: Aspose.Imaging.dll (25.4.0)
Avustava luokka väripalettien manipulointiin.
public static class ColorPaletteHelperInheritance
Perintöjäsenet
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Methods
Create4Bit()
Luo 4 bitin väripaletti.
public static IColorPalette Create4Bit()Returns
4 bitin väri paletti.
Create4BitGrayscale(Booli)
Luo 4 bitin grayscale paletti.
public static IColorPalette Create4BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Jos asetetaan “todelliseksi”, paletti alkaa valkoisella värillä, muuten se alkaa mustaisella värillä.
Returns
4 bitin grayscale paletti.
Create8Bit()
Luo 8 bitin väripaletti.
public static IColorPalette Create8Bit()Returns
8 bitin väri paletti.
Create8BitGrayscale(Booli)
Luo 8 bitin grayscale paletti.
public static IColorPalette Create8BitGrayscale(bool minIsWhite)Parameters
minIsWhite bool
Jos asetetaan “todelliseksi”, paletti alkaa valkoisella värillä, muuten se alkaa mustaisella värillä.
Returns
8 bitin grayscale paletti.
Examples
Seuraava esimerkki luo palettiitun grayscal BMP-kuvan ja tallentaa sen sitten tiedostoon.
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(Sisältää)
Antaa grayscale paletin määritellyn bittiarvon. sallitut bit-arvot ovat 1, 2, 4, 8.
public static IColorPalette CreateGrayscale(int bits)Parameters
bits int
Pieni lasku on.
Returns
Grayscale paletti.
Exceptions
bits'
CreateMonochrome()
Se luo monokromisen väripaletin, joka sisältää vain kaksi väriä.
public static IColorPalette CreateMonochrome()Returns
Väripaletti monokromisille kuville.
GetCloseImagePalette(Käsikirjoitus, int)
Saat väripaletin raster-kuvasta (palletisoi kuvan) siinä tapauksessa, että kuvalla ei ole yhtä.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
ja rasterin kuvan.
entriesCount int
Halutut tulokset lasketaan.
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
Examples
Seuraava esimerkki lataa BMP-kuvan ja säästää sen takaisin BMP:hen käyttämällä erilaisia tallennusvaihtoehtoja.
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);
}Seuraava esimerkki osoittaa, miten palletisoida BMP-kuva vähentääkseen sen tuotantoa.
// 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, PaletteMiningMetodi)
Paletti on lähellä optimoitua parempaan indeksoituun kuvanlaatuun tai otetaan “AS IS”, kun PaletteMiningMethod.UseCurrentPalette käytetään.
public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount, PaletteMiningMethod paletteMiningMethod)Parameters
image RasterImage
ja rasterin kuvan.
entriesCount int
Halutut tulokset lasketaan.
paletteMiningMethod PaletteMiningMethod
Paletti kaivosmenetelmä.
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
Examples
Seuraava esimerkki näyttää, miten kompressoida PNG-kuva, käyttämällä indeksoitua väriä parhaiten sopivalla paletilla
// 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 ja int)
Saat väripaletin raster-kuvasta (palletisoi kuvan) siinä tapauksessa, että kuvalla ei ole yhtä.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount)Parameters
image RasterImage
ja rasterin kuvan.
destBounds Rectangle
Tavoitteen kuva rajoittuu.
entriesCount int
Halutut tulokset lasketaan.
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
GetCloseImagePalette(RasterImage, Rectangle, int ja bool)
Saat väripaletin raster-kuvasta (palletisoi kuvan) siinä tapauksessa, että kuvalla ei ole yhtä.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette)Parameters
image RasterImage
ja rasterin kuvan.
destBounds Rectangle
Tavoitteen kuva rajoittuu.
entriesCount int
Halutut tulokset lasketaan.
useImagePalette bool
Jos se on asetettu, se käyttää omaa kuvan palettia, jos se on käytettävissä
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, väri)
Saat väripaletin raster-kuvasta (palletisoi kuvan) siinä tapauksessa, että kuvalla ei ole yhtä.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor)Parameters
image RasterImage
ja rasterin kuvan.
destBounds Rectangle
Tavoitteen kuva rajoittuu.
entriesCount int
Halutut tulokset lasketaan.
useImagePalette bool
Jos se on asetettu, se käyttää omaa kuvan palettia, jos se on käytettävissä
alphaBlendInColor Color
Väri, jota tulisi käyttää taustakuvana puoli läpinäkyvään alfa-korvaukseen.
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
GetCloseImagePalette(RasterImage, Rectangle, int, bool, Väri, Bool)
Saat väripaletin raster-kuvasta (palletisoi kuvan) siinä tapauksessa, että kuvalla ei ole yhtä.
public static IColorPalette GetCloseImagePalette(RasterImage image, Rectangle destBounds, int entriesCount, bool useImagePalette, Color alphaBlendInColor, bool keepTransparency)Parameters
image RasterImage
ja rasterin kuvan.
destBounds Rectangle
Tavoitteen kuva rajoittuu.
entriesCount int
Halutut tulokset lasketaan.
useImagePalette bool
Jos se on asetettu, se käyttää omaa kuvan palettia, jos se on käytettävissä
alphaBlendInColor Color
Väri, jota tulisi käyttää taustakuvana puoli läpinäkyvään alfa-korvaukseen.
keepTransparency bool
Jos se asetetaan, se ottaa huomioon alfa-kanavan bitit kuvan värejä.
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
GetCloseTransparentImagePalette(Käsikirjoitus, int)
Saat väripaletin raster-kuvasta (palletisoi kuvan) siinä tapauksessa, että kuvalla ei ole yhtä.
public static IColorPalette GetCloseTransparentImagePalette(RasterImage image, int entriesCount)Parameters
image RasterImage
ja rasterin kuvan.
entriesCount int
Halutut tulokset lasketaan.
Returns
Väripaletti, joka alkaa yleisimmistä väreistä image’ ja sisältää entriesCount’ -tulokset.
GetDownscalePalette(RasterImage)
Saat 256 väripaletta, joka koostuu alkuperäisen kuvan väriarvojen yläkerroksista.
public static ColorPalette GetDownscalePalette(RasterImage image)Parameters
image RasterImage
ja kuvasta .
Returns
Se on Aspose.Imaging.ColorPalette.
GetUniformColorPalette(RasterImage)
Valitse yhtenäinen 256 väriä paletti.
public static ColorPalette GetUniformColorPalette(RasterImage image)Parameters
image RasterImage
ja kuvasta .
Returns
Se on Aspose.Imaging.ColorPalette.
HasTransparentColors(ICOLORPALETTI)
Se määrittää, onko määritellyllä paletilla läpinäkyviä värejä.
public static bool HasTransparentColors(IColorPalette palette)Parameters
palette IColorPalette
ja paletti.
Returns
’todellinen’ jos määritellyllä paletilla on läpinäkyviä värejä; muuten ’väärä’.
Exceptions
palette’ is null.
