Create an image with reduced number of colors using the specified palette.

Namespace:  AForge.Imaging.ColorReduction
Assembly:  AForge.Imaging (in AForge.Imaging.dll) Version: 2.2.5.0 (2.2.5.0)

Syntax

C#
public Bitmap ReduceColors(
	UnmanagedImage image,
	Color[] palette
)

Parameters

image
Type: AForge.Imaging..::.UnmanagedImage
Source image to process.
palette
Type: array< System.Drawing..::.Color >[]()[]
Target color palette. Must contatin 2-256 colors.

Return Value

Returns image with reduced number of colors.

Remarks

The method creates an image, which looks similar to the specified image, but contains reduced number of colors. Is substitutes every pixel of the source image with the closest matching color in the specified paletter.

Note:The output image has 4 bpp or 8 bpp indexed pixel format depending on the target palette size - 4 bpp for palette size 16 or less; 8 bpp otherwise.

Exceptions

ExceptionCondition
AForge.Imaging..::.UnsupportedImageFormatExceptionUnsupported format of the source image - it must 24 or 32 bpp color image.
System..::.ArgumentExceptionInvalid size of the target color palette.

See Also