TransformChainCommand Class

This command allows you to combine multiple transforms into a single command call.

Inheritance Hierarchy

SystemObject
Atalasoft.Imaging.ImageProcessingImageCommand
Atalasoft.Imaging.ImageProcessing.TransformsTransformChainCommand

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

Syntax

Copy

[SerializableAttribute]
public class TransformChainCommand : ImageCommand, 
	ICollection, IEnumerable, ISerializable

<SerializableAttribute>
Public Class TransformChainCommand
	Inherits ImageCommand
	Implements ICollection, IEnumerable, ISerializable

The TransformChainCommand type exposes the following members.

Constructors

	Name	Description
	TransformChainCommand	Creates a new instance of TransformChainCommand.
	TransformChainCommand(Color)	Creates a new instance of TransformChainCommand specifying the background color of the resulting image.
	TransformChainCommand(Transform)	Creates a new instance of TransformChainCommand specifying the transforms.
	TransformChainCommand(Color, InterpolationMode)	Creates a new instance of TransformChainCommand specifying the background color and transform mode.
	TransformChainCommand(SerializationInfo, StreamingContext)	Creates a new instance of TransformChainCommand from serialization information
	TransformChainCommand(Color, InterpolationMode, Transform)	Creates a new instance of TransformChainCommand specifying the background color, transform mode and a collection of transforms to apply.

Top

Properties

	Name	Description
	ApplyToAnyPixelFormat	Reports whether or not this command will be applied to any supplied PixelFormat image (Inherited from ImageCommand.)
	BackColor	Gets or sets the background color to use on newly uncovered areas of the image.
	CanApplyToAnyPixelFormat	Returns true if the command can be applied to any PixelFormat. (Inherited from ImageCommand.)
	Count	Returns the number of transforms in the collection.
	InPlaceProcessing	Gets a value indicating if the source image data is processed in-place as opposed to returning a new image. (Inherited from ImageCommand.)
	IsSynchronized	Gets a value indicating whether access to the transforms collection is synchronized.
	Progress	Gets or sets the ProgressEventHandler delegate which can be used to view or cancel the progress of the current process. (Inherited from ImageCommand.)
	SupportedPixelFormats	Returns an array of PixelFormats supported by this command. (Overrides ImageCommandSupportedPixelFormats.)
	SyncRoot	Gets an object that can be used to synchronize access to the transforms collection.
	TransformMode	Gets or sets the InterpolationMode of this transform.

Top

Methods

	Name	Description
	Add	Adds a transform to the collection.
	Apply	Apply the command to the given image. (Inherited from ImageCommand.)
	ApplyToImage	Obsolete. Applies the command to the source AtalaImage. (Inherited from ImageCommand.)
	Clear	Removes all of the transforms from the collection.
	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. (Inherited from ImageCommand.)
	ConstructImageResults	Constructs the results object for this command. (Inherited from ImageCommand.)
	CopyTo(Array, Int32)	Copies transforms from the internal collection to an array.
	CopyTo(Transform, Int32)	Copies transforms from the internal collection to an array.
	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.)
	GetEnumerator	This allows the use of foreach statements on the transforms collection.
	GetHashCode	Serves as the default hash function. (Inherited from Object.)
	GetObjectData	Fills a SerializationInfo object with information about this command.
	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. (Overrides ImageCommandSelectPreferredPixelFormat(AtalaImage, PixelFormat, PixelFormat).)
	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

Remarks

This method requires a continuous tone image. If the source image is not continuous, it will attempt to convert the image into one.

Examples

Using TransformChain (C#)

Copy

// Load a 24-bit image.
AtalaImage image = new AtalaImage(@"D:\Test Images\1.jpg");

// Create the TransformChainCommand and add a couple transforms to it.
TransformChainCommand cmd = new TransformChainCommand();
cmd.Add(new MarbleTransform(0.4, new Size(10, 10)));
cmd.Add(new LensTransform(100, Point.Empty));

// Apply the transform.
AtalaImage result = cmd.Apply(image).Image;
image.Dispose();

Using TransformChain (Visual Basic)

Copy

' Load a 24-bit image.
Dim image As AtalaImage =  New AtalaImage("D:\Test Images\1.jpg") 

' Create the TransformChainCommand and add a couple transforms to it.
Dim cmd As TransformChainCommand =  New TransformChainCommand() 
cmd.Add(New MarbleTransform(0.4, New Size(10, 10)))
cmd.Add(New LensTransform(100,PoInteger.Empty))

' Apply the transform.
Dim result As AtalaImage =  cmd.Apply(image).Image
image.Dispose()

Reference

Atalasoft.Imaging.ImageProcessing.Transforms Namespace