PhotoColorMagicCommand Class |
Namespace: Atalasoft.Imaging.ImageProcessing.Effects
The PhotoColorMagicCommand type exposes the following members.
Name | Description | |
---|---|---|
PhotoColorMagicCommand |
Initializes a new instance of the PhotoColorMagicCommand class.
| |
PhotoColorMagicCommand(SerializationInfo, StreamingContext) |
Initializes a new instance of the PhotoColorMagicCommand class with serialized data.
|
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.) | |
ConstantColor |
Gets or sets a value indicating whether to keep color balance constant.
| |
InPlaceProcessing | Gets a value indicating if the source image data is processed in-place as opposed to returning a new
image. (Overrides ImageCommandInPlaceProcessing.) | |
Progress | Gets or sets the ProgressEventHandler delegate which can be used to view or cancel the
progress of the current process. (Inherited from ImageCommand.) | |
RemoveGray |
Gets or sets a value indicating whether to remove gray by setting Black Point in the image.
| |
Strength |
Gets or sets the strength of filter.
| |
SupportedPixelFormats | Gets an array of supported pixel formats. (Overrides ImageCommandSupportedPixelFormats.) |
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. (Inherited from ImageCommand.) | |
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 | Populates a SerializationInfo with the data needed to serialize the target object. | |
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).) |
Because it preserves the overall color balance and tonal distribution of the original image, Color Magic can normally be used with the default parameters, making it simple to apply in a batch or even un-attended mode.
You can increase or decrease the amount of the effect using the Strength parameter.
Color Magic can also remove the "gray" from an image by automatically adjusting the shadow point in an image. This is similar to the shadow adjustment made by AutoLevels and is provide as an option in this filter primarily as a convenience and optimization. This feature is controlled using the RemoveGray parameter.
For a more complete correction of an image it is assumed that Color Magic would be run with an automated Tone correction command, such as AutoLevels or another Automatic Tone Correction from PhotoEffects.
In some cases users may desire a greater or even slightly un-natural coloring effect. Interesting effects can be achieved by turning off the ConstantColor property of Color Magic. Turning off ConstantColor allows Color Magic to enhance each color separately which provide dramatic effects but does not preserve the overall color balance of the image. In particular when combined with higher strength values this can be quite dramatic.