DitherCommand Class

This command is used for converting color or gray images to black and white using halftoning techniques to simulate gray in the final image. This command operates best on photographic images.

Dithering is done using either Ordered Dithering or Floyd-Steinberg Error Diffusion dithering.

With Ordered Dithering, the dithering matrix is fully replaceable and can be made to simulate custom halftone screens.

Inheritance Hierarchy

SystemObject
Atalasoft.Imaging.ImageProcessingImageCommand
Atalasoft.Imaging.ImageProcessing.DocumentDitherCommand

Namespace: Atalasoft.Imaging.ImageProcessing.Document
Assembly: Atalasoft.dotImage (in Atalasoft.dotImage.dll) Version: 11.4.0.9.0.377 (.NET 4.5.2, x86)

Syntax

Copy

[SerializableAttribute]
public class DitherCommand : ImageCommand, 
	ISerializable

<SerializableAttribute>
Public Class DitherCommand
	Inherits ImageCommand
	Implements ISerializable

The DitherCommand type exposes the following members.

Constructors

	Name	Description
	DitherCommand	Constructs a new DitherCommand to convert multi-bit images to 1 bit per pixel images using ordered dithering as the method.
	DitherCommand(DitheringMethod)	Constructs a new DitherCommand to convert multi-bit images to 1 bit per pixel images using the supplied method.
	DitherCommand(SerializationInfo, StreamingContext)	Creates a new instance of DitherCommand from serialization information.

Top

Properties

	Name	Description
	ApplyToAnyPixelFormat	Reports whether or not this command will be applied to any supplied PixelFormat image (Inherited from ImageCommand.)
	CanApplyToAnyPixelFormat	Returns true if the command can be applied to any PixelFormat. (Inherited from ImageCommand.)
	InPlaceProcessing	Gets a value indicating if the source image data is processed in-place as opposed to returning a new image. (Inherited from ImageCommand.)
	Matrix	Gets or sets the matrix to use for ordered dithering. The matrix must have either 4, 16, 64, or 256 elements in it representing 2x2, 4x4, 8x8 or 16x16 matrices, respectively.
	Method	Set or get the method to be used for dithering.
	Progress	Gets or sets the ProgressEventHandler delegate which can be used to view or cancel the progress of the current process. (Inherited from ImageCommand.)
	Serpentine	Set or get whether or not Floyd Steinberg dithering will operate in alternating left to right/right to left patterns or simply left to right.
	Standard16x16	Returns a standard 16x16 ordered dithering matrix.
	Standard2x2	Returns a standard 2x2 ordered dithering matrix.
	Standard4x4	Returns a standard 4x4 ordered dithering matrix.
	Standard8x8	Returns a standard 8x8 ordered dithering matrix.
	SupportedPixelFormats	Returns the set of PixelFormats that are supported by this image command. (Overrides ImageCommandSupportedPixelFormats.)

Top

Methods

	Name	Description
	Apply	Apply the command to the given image. (Inherited from ImageCommand.)
	ApplyToImage	Obsolete. Applies the command to the source AtalaImage. (Inherited from ImageCommand.)
	ConstructChangedSourceImage	The method is called by the default implementation of Apply. It determines if it is necessary to create a copy of the source image in a different pixel format and if so, determines the best new pixel format and allocates that image. (Inherited from ImageCommand.)
	ConstructFinalImage	Called by the default implementation of Apply, ConstructFinalImage constructs the image that will be used as the destination image for the command. (Overrides ImageCommandConstructFinalImage(AtalaImage).)
	ConstructImageResults	Constructs the results object for this command. (Inherited from ImageCommand.)
	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.)
	GetChangedPixelFormat	This method is called to change the pixel format of the source image. (Inherited from ImageCommand.)
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetObjectData
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	ImageCommandGetObjectData	Aggregates ImageCommand data into the supplied SerializationInfo object. (Inherited from ImageCommand.)
	IsPixelFormatSupported	Returns a value indicating if the specified pixel format is supported. (Inherited from ImageCommand.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	PerformActualCommand	PerformActualCommand does the actual work of the image processing command. (Overrides ImageCommandPerformActualCommand(AtalaImage, AtalaImage, Rectangle, ImageResults).)
	SelectBestAlternatePixelFormat	Choose the best pixel format to use for this command when the supplied source image's pixel format is unacceptable. (Inherited from ImageCommand.)
	SelectPreferredPixelFormat	Chooses a pixel format that is preferred for this command. (Inherited from ImageCommand.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	VerifyImage	Verify the integrity of an AtalaImage. (Inherited from ImageCommand.)
	VerifyProperties	Verify the integrity of properties in the command before processing an image. (Overrides ImageCommandVerifyProperties(AtalaImage).)

Top

Reference

Atalasoft.Imaging.ImageProcessing.Document Namespace