Create an image with reduced number of colors.

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,
	int paletteSize
)

Parameters

image
Type: AForge.Imaging..::.UnmanagedImage
Source image to process.
paletteSize
Type: System..::.Int32
Number of colors to get in the output image, [2, 256].

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. First, target color palette is calculated using CalculatePalette(UnmanagedImage, Int32) method and then a new image is created, where pixels from the given source image are substituted by best matching colors from calculated color table.

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