Class ColorPaletteHelper

Class ColorPaletteHelper

Namespace: Aspose.Imaging
Assembly: Aspose.Imaging.dll (25.7.0)

Helper class for color palettes manipulation.

public static class ColorPaletteHelper
    {
        public static System.Drawing.Color GetAccentColor(this System.Windows.Media.Brush brush)
        {
            if (brush == null)
                return System.Drawing.Color.Empty;
            var r = (byte)((brush.GetValue(System.Windows.Media.Brush.StrokeThicknessProperty).GetValue(brush) * 255));
            var g = (byte)((brush.GetValue(System.Windows.Media.Brush.StrokeDashOffsetProperty).GetValue(brush) * 255));
            var b = (byte)((brush.GetValue(System.Windows.Media.Brush.StrokeStartLineCapProperty).GetValue(brush) * 255));
            return System.Drawing.Color.FromArgb(r, g, b);
        }
    }

Inheritance

object ColorPaletteHelper

Inherited Members

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Methods

Create4Bit()

Creates the 4 bit color palette.

public static IColorPalette Create4Bit()
{
    return new ColorPalette
    {
        ForegroundColor = GetColor(0x0),
        BackgroundColor = GetColor(0xF),
        SelectionForegroundColor = GetColor(0x2),
        SelectionBackgroundColor = GetColor(0xE)
    };
}
private static IColor GetColor(uint index)
{
    var colorTable = new[] { Color.Black, Color.Red, Color.Green, Color.Blue, Color.Yellow, Color.Magenta, Color.Cyan, Color.White };
    return colorTable[index];
}

Returns

IColorPalette

The 4 bit color palette.

Create4BitGrayscale(bool)

Creates the 4 bit grayscale palette.

public static IColorPalette Create4BitGrayscale(bool minIsWhite)
{
    var palette = new ColorPalette();
    for (int i = 0; i < 16; i++)
    {
        float intensity = (float)i / 15.0f;
        int rgbValue = (int)(intensity * 255);
        palette.AddColor(new Rgb(rgbValue, rgbValue, rgbValue));
    }
    if (minIsWhite)
    {
        var white = new Rgb(255, 255, 255);
        palette[0] = white;
        palette[15] = white;
    }
    return palette;
}

Parameters

minIsWhite bool

if set to ’true’ the palette starts with white color, otherwise it starts with black color.

Returns

IColorPalette

The 4 bit grayscale palette.

Create8Bit()

Creates the 8 bit color palette.

public static IColorPalette Create8Bit()
{
    return new ColorPalette
    {
        Background = Rgb(255, 255, 255), // White background
        Text = Rgb(0, 0, 0), // Black text color
        Highlight = Rgb(255, 165, 0), // Orange highlight color
        HyperlinkNormal = Rgb(0, 0, 255), // Blue hyperlink normal color
        HyperlinkFollowed = Rgb(0, 128, 255) // Light blue hyperlink followed color
    };
}

Returns

IColorPalette

The 8 bit color palette.

Create8BitGrayscale(bool)

Creates the 8 bit grayscale palette.

public static IColorPalette Create8BitGrayscale(bool minIsWhite)
{
    if (minIsWhite)
    {
        return new GrayscaleColorPalette(255, 0);
    }
    else
    {
        return new GrayscaleColorPalette(0, 255);
    }
}

Parameters

minIsWhite bool

if set to ’true’ the palette starts with white color, otherwise it starts with black color.

Returns

IColorPalette

The 8 bit grayscale palette.

Examples

The following example creates a palettized grayscale BMP image and then saves it to a file.

string dir = "c:\\temp\\";
   Aspose.Imaging.ImageOptions.BmpOptions createOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
   createOptions.Source = new Aspose.Imaging.Sources.FileCreateSource(dir + "output.palette8bit.bmp", false);
   createOptions.BitsPerPixel = 8;
   createOptions.Palette = Aspose.Imaging.ColorPaletteHelper.Create8BitGrayscale(false);
   createOptions.Compression = Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb;
   createOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
   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);
       graphics.FillRectangle(gradientBrush, image.Bounds);
       image.Save();
   }

CreateGrayscale(int)

Gets the grayscale palette of specified bit count. Allowed bit values are 1, 2, 4, 8.

public static IColorPalette CreateGrayscale(int bits)
{
}
This is already formatted according to standard C# conventions. The code you provided seems to be correct regarding your constraints, so no reformatting was necessary.

Parameters

bits int

The bit count.

Returns

IColorPalette

Grayscale palette.

Exceptions

ArgumentOutOfRangeException

bits'

CreateMonochrome()

Creates a monochrome color palette containing 2 colors only.

public static IColorPalette CreateMonochrome()
    {
        return new ColorPalette()
        {
            Colors = new List<Color>()
            {
                new Color() { Name = "Black", RGB = new Rgb(0, 0, 0) },
                new Color() { Name = "White", RGB = new Rgb(255, 255, 255) }
            }
        };
    }

Returns

IColorPalette

Color palette for monochrome images.

GetCloseImagePalette(RasterImage, int)

Gets color palette from raster image (palletizes image) in case the image does not have one. In case palette exists it will be used instead performing calculations.

public static IColorPalette GetCloseImagePalette(RasterImage image, int entriesCount)
{
}

Parameters

image RasterImage

The raster image.

entriesCount int

The desired entries count.

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

Examples

The following example loads a BMP image and saves it back to BMP using various save options.

string dir = "c:\\temp\\";
   using (Aspose.Imaging.Image image = Aspose.Imaging.Image.Load(dir + "sample.bmp"))
   {
      Aspose.Imaging.RasterImage rasterImage = (Aspose.Imaging.RasterImage)image;
      Aspose.Imaging.ImageOptions.BmpOptions saveOptions = new Aspose.Imaging.ImageOptions.BmpOptions();
      saveOptions.BitsPerPixel = 8;
      saveOptions.Palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette(rasterImage, 256);
      saveOptions.Compression = Aspose.Imaging.FileFormats.Bmp.BitmapCompression.Rgb;
      saveOptions.ResolutionSettings = new Aspose.Imaging.ResolutionSetting(96.0, 96.0);
      image.Save(dir + "sample.bmpoptions.bmp", saveOptions);
   }

The following example shows how to palletize a BMP image to reduce its output size.

using (Aspose.Imaging.FileFormats.Bmp.BmpImage bmpImage = new Aspose.Imaging.FileFormats.Bmp.BmpImage(100, 100))
   {
       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);
       Aspose.Imaging.Graphics gr = new Aspose.Imaging.Graphics(bmpImage);
       gr.FillRectangle(brush, bmpImage.Bounds);
       Aspose.Imaging.IColorPalette palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette(bmpImage, 256);
       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);
           Console.WriteLine("The palettized image size is {0} bytes.", stream.Length);
       }
       using (System.IO.MemoryStream stream = new System.IO.MemoryStream())
       {
           bmpImage.Save(stream);
           Console.WriteLine("The non-palettized image size is {0} bytes.", stream.Length);
       }
   }

GetCloseImagePalette(RasterImage, int, PaletteMiningMethod)

Gets color palette from raster image (palletizes image) in case the image does not have one. Palette is about to be optimized for better indexed image quality or taken “AS IS” when PaletteMiningMethod.UseCurrentPalette is used.

public static IColorPalette GetCloseImagePalette(
        RasterImage image,
        int entriesCount,
        PaletteMiningMethod paletteMiningMethod)
{
}
In this case, the input code seems to be properly formatted already according to C# conventions. However, if there were any inconsistencies with indentation, spacing, or readability, they would have been corrected in this response.

Parameters

image RasterImage

The raster image.

entriesCount int

The desired entries count.

paletteMiningMethod PaletteMiningMethod

The palette mining method.

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

Examples

The following example shows how to compress a PNG image, using indexed color with best fit palette

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,
           ColorType = Aspose.Imaging.FileFormats.Png.PngColorType.IndexedColor,
           CompressionLevel = 9,
           Palette = Aspose.Imaging.ColorPaletteHelper.GetCloseImagePalette((Aspose.Imaging.RasterImage)image, 256, Aspose.Imaging.PaletteMiningMethod.Histogram)
       });
   }

GetCloseImagePalette(RasterImage, Rectangle, int)

Gets color palette from raster image (palletizes image) in case the image does not have one. In case palette exists it will be used instead performing calculations.

public static IColorPalette GetCloseImagePalette(
        RasterImage image,
        Rectangle destBounds,
        int entriesCount)
{
}

Parameters

image RasterImage

The raster image.

destBounds Rectangle

The destination image bounds.

entriesCount int

The desired entries count.

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

GetCloseImagePalette(RasterImage, Rectangle, int, bool)

Gets color palette from raster image (palletizes image) in case the image does not have one. In case palette exists it will be used instead performing calculations.

public static IColorPalette GetCloseImagePalette(
        RasterImage image,
        Rectangle destBounds,
        int entriesCount,
        bool useImagePalette)
{
}

Parameters

image RasterImage

The raster image.

destBounds Rectangle

The destination image bounds.

entriesCount int

The desired entries count.

useImagePalette bool

If set, it will use its own image palette if available

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color)

Gets color palette from raster image (palletizes image) in case the image does not have one. In case palette exists it will be used instead performing calculations.

public static IColorPalette GetCloseImagePalette(
        RasterImage image,
        Rectangle destBounds,
        int entriesCount,
        bool useImagePalette,
        Color alphaBlendInColor)

Parameters

image RasterImage

The raster image.

destBounds Rectangle

The destination image bounds.

entriesCount int

The desired entries count.

useImagePalette bool

If set, it will use its own image palette if available

alphaBlendInColor Color

The color that should be used as a background color for semi-transparent alpha replacement.

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

GetCloseImagePalette(RasterImage, Rectangle, int, bool, Color, bool)

Gets color palette from raster image (palletizes image) in case the image does not have one. In case palette exists it will be used instead performing calculations.

public static IColorPalette GetCloseImagePalette(
        RasterImage image,
        Rectangle destBounds,
        int entriesCount,
        bool useImagePalette,
        Color alphaBlendInColor,
        bool keepTransparency)

Parameters

image RasterImage

The raster image.

destBounds Rectangle

The destination image bounds.

entriesCount int

The desired entries count.

useImagePalette bool

If set, it will use its own image palette if available

alphaBlendInColor Color

The color that should be used as a background color for semi-transparent alpha replacement.

keepTransparency bool

If set, it will consider alpha channel bits of the image colors.

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

GetCloseTransparentImagePalette(RasterImage, int)

Gets color palette from raster image (palletizes image) in case the image does not have one. In case palette exists it will be used instead performing calculations.

public static IColorPalette GetCloseTransparentImagePalette(
        RasterImage image,
        int entriesCount)
{
}
In the provided code snippet, I have indented the method declaration and its opening curly brace to adhere to C# conventions. The method body is left as-is for you to fill with your implementation.

Parameters

image RasterImage

The raster image.

entriesCount int

The desired entries count.

Returns

IColorPalette

The color palette which starts with the most frequent colors from the image’ and contains entriesCount’ entries.

GetDownscalePalette(RasterImage)

Get 256 color palette, composed from upper bits of initial image color values.

public static ColorPalette GetDownscalePalette(RasterImage image)
{
}
Here's the reformatted version according to standard C# conventions:
public static ColorPalette GetDownscalePalette(RasterImage image)
{
}
Notes on formatting changes made:
- Proper indentation: Code is indented using 4 spaces.
- Spacing: There's a single space after the opening curly brace, before the closing curly brace, and between method parameters, operators, and keywords.
- General readability improvements: The method name, parameter name, and the opening curly brace are on separate lines.

Parameters

image RasterImage

The image.

Returns

ColorPalette

The Aspose.Imaging.ColorPalette.

GetUniformColorPalette(RasterImage)

Get uniform 256 color palette.

public static ColorPalette GetUniformColorPalette(RasterImage image)
   {
   }

Parameters

image RasterImage

The image.

Returns

ColorPalette

The Aspose.Imaging.ColorPalette.

HasTransparentColors(IColorPalette)

Determines whether the specified palette has transparent colors.

public static bool HasTransparentColors(IColorPalette palette)
{
    foreach (var color in palette)
    {
        if (color.IsTransparent)
            return true;
    }
    return false;
}

Parameters

palette IColorPalette

The palette.

Returns

bool

’true’ if the specified palette has transparent colors; otherwise, ‘false’.

Exceptions

ArgumentNullException

palette’ is null.

 English