Click or drag to resize
Accord.NET (logo)

StuckiColorDithering Class

Color dithering using Stucki error diffusion.
Inheritance Hierarchy
SystemObject
  Accord.Imaging.ColorReductionErrorDiffusionColorDithering
    Accord.Imaging.ColorReductionColorErrorDiffusionToAdjacentNeighbors
      Accord.Imaging.ColorReductionStuckiColorDithering

Namespace:  Accord.Imaging.ColorReduction
Assembly:  Accord.Imaging (in Accord.Imaging.dll) Version: 3.8.0
Syntax
public sealed class StuckiColorDithering : ColorErrorDiffusionToAdjacentNeighbors
Request Example View Source

The StuckiColorDithering type exposes the following members.

Constructors
  NameDescription
Public methodStuckiColorDithering
Initializes a new instance of the StuckiColorDithering class.
Top
Properties
  NameDescription
Public propertyCoefficients
Diffusion coefficients.
(Inherited from ColorErrorDiffusionToAdjacentNeighbors.)
Public propertyColorTable
Color table to use for image dithering. Must contain 2-256 colors.
(Inherited from ErrorDiffusionColorDithering.)
Public propertyUseCaching
Use color caching during color dithering or not.
(Inherited from ErrorDiffusionColorDithering.)
Top
Methods
  NameDescription
Public methodApply(Bitmap)
Perform color dithering for the specified image.
(Inherited from ErrorDiffusionColorDithering.)
Public methodApply(UnmanagedImage)
Perform color dithering for the specified image.
(Inherited from ErrorDiffusionColorDithering.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Top
Extension Methods
  NameDescription
Public Extension MethodHasMethod
Checks whether an object implements a method with the given name.
(Defined by ExtensionMethods.)
Public Extension MethodIsEqual
Compares two objects for equality, performing an elementwise comparison if the elements are vectors or matrices.
(Defined by Matrix.)
Public Extension MethodTo(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.)
Public Extension MethodToTOverloaded.
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.)
Top
Remarks

The image processing routine represents color dithering algorithm, which is based on error diffusion dithering with Stucki coefficients. Error is diffused on 12 neighbor pixels with next coefficients:

        | * | 8 | 4 |
| 2 | 4 | 8 | 4 | 2 |
| 1 | 2 | 4 | 2 | 1 |

/ 42

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 64 colors table
Color[] colorTable = ciq.CalculatePalette( image, 64 );
// create dithering routine
StuckiColorDithering dithering = new StuckiColorDithering( );
dithering.ColorTable = colorTable;
// apply the dithering routine
Bitmap newImage = dithering.Apply( image );

Initial image:

Result image:

See Also