|
OrderedColorDithering Class |
Inheritance HierarchyAccord.Imaging.ColorReductionOrderedColorDithering
Namespace: Accord.Imaging.ColorReduction
Assembly: Accord.Imaging (in Accord.Imaging.dll) Version: 3.8.0
SyntaxThe OrderedColorDithering type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | OrderedColorDithering |
Initializes a new instance of the OrderedColorDithering class.
|
| OrderedColorDithering(Byte) |
Initializes a new instance of the OrderedColorDithering class.
|
Properties| Name | Description | |
|---|---|---|
 | ColorTable |
Color table to use for image dithering. Must contain 2-256 colors.
|
| ThresholdMatrix |
Threshold matrix - values to add source image's values.
|
| UseCaching |
Use color caching during color dithering or not.
|
Methods| Name | Description | |
|---|---|---|
| Apply(Bitmap) |
Perform color dithering for the specified image.
|
| Apply(UnmanagedImage) |
Perform color dithering for the specified image.
|
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as the default hash function. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
Extension Methods| Name | Description | |
|---|---|---|
 | HasMethod |
Checks whether an object implements a method with the given name.
(Defined by ExtensionMethods.) |
| IsEqual |
Compares two objects for equality, performing an elementwise
comparison if the elements are vectors or matrices.
(Defined by Matrix.) |
| To(Type) | Overloaded.
Converts an object into another type, irrespective of whether
the conversion can be done at compile time or not. This can be
used to convert generic types to numeric types during runtime.
(Defined by ExtensionMethods.) |
| ToT | Overloaded.
Converts an object into another type, irrespective of whether
the conversion can be done at compile time or not. This can be
used to convert generic types to numeric types during runtime.
(Defined by ExtensionMethods.) |
RemarksThe class implements ordered color dithering as described on Wikipedia. The algorithm achieves dithering by applying a threshold map on the pixels displayed, causing some of the pixels to be rendered at a different color, depending on how far in between the color is of available color entries.
The image processing routine accepts 24/32 bpp color images for processing. As a result this routine produces 4 bpp or 8 bpp indexed image, which depends on size of the specified color table - 4 bpp result for color tables with 16 colors or less; 8 bpp result for larger color tables.
Sample usage:
// create color image quantization routine ColorImageQuantizer ciq = new ColorImageQuantizer( new MedianCutQuantizer( ) ); // create 256 colors table Color[] colorTable = ciq.CalculatePalette( image, 256 ); // create dithering routine OrderedColorDithering dithering = new OrderedColorDithering( ); dithering.ColorTable = colorTable; // apply the dithering routine Bitmap newImage = dithering.Apply( image );
Initial image:
Result image:
See Also