AdvancedLevelsCommand Class

Corrects the tonal range and color balance by adjusting the shadow, midtone, and highlights of an image.

Inheritance Hierarchy

System.Object
  Atalasoft.Imaging.ImageProcessing.ImageCommand
    Atalasoft.Imaging.ImageProcessing.ImageRegionCommand
      Atalasoft.Imaging.ImageProcessing.Channels.ApplyLutCommandBase
        Atalasoft.Imaging.ImageProcessing.Effects.AdvancedLevelsCommand

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

Syntax

Copy

[SerializableAttribute]
public class AdvancedLevelsCommand : ApplyLutCommandBase

<SerializableAttribute>
Public Class AdvancedLevelsCommand
	Inherits ApplyLutCommandBase

The AdvancedLevelsCommand type exposes the following members.

Constructors

	Name	Description
	AdvancedLevelsCommand()	Initializes a new instance of the AdvancedLevelsCommand class.
	AdvancedLevelsCommand(SerializationInfo, StreamingContext)	Initializes a new instance of the AdvancedLevelsCommand class with serialized data.
	AdvancedLevelsCommand(Color, Color, Color, Color)	Initializes a new instance of the AdvancedLevelsCommand class with specified shadow, highlight, low and high output range colors.
	AdvancedLevelsCommand(Color, Color, Color, Color, GammaColor)	Initializes a new instance of the AdvancedLevelsCommand class with specified shadow, highlight low and high output range colors, and gamma.
	AdvancedLevelsCommand(Color, Color, Color, Color, Color)	Initializes a new instance of the AdvancedLevelsCommand class with specified shadow, midtone, highlight, low and high output range colors.

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.)
	Gamma	Gets or sets the gamma adjustment to apply when running the filter. Default GammaColor.Default.
	HighlightColor	Gets or sets the white point in the image used as an input clipping point. Default Color.White.
	InPlaceProcessing	Indicates whether or not the command will operate on the source image alone. (Overrides ApplyLutCommandBase.InPlaceProcessing.)
	MidtoneColor	Gets or sets the gray point in the image used as a gamma adjustment. Gamma is used by default.
	OutputRangeHigh	Gets or sets the light color value to stretch the histogram to. Default Color.White.
	OutputRangeLow	Gets or sets the dark color value to stretch the histogram to. Default Color.Black.
	Progress	Gets or sets the ProgressEventHandler delegate which can be used to view or cancel the progress of the current process. (Inherited from ImageCommand.)
	RegionOfInterest	Gets or sets a RegionOfInterest which will only process the indicated region of the image. (Inherited from ImageRegionCommand.)
	ShadowColor	Gets or sets the black point in the image used as an input clipping point. Default Color.Black.
	SupportedPixelFormats	Returns an array of PixelFormats supported by this command. (Overrides ApplyLutCommandBase.SupportedPixelFormats.)

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. (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.)
	GetHighThreshold	Calculates the high threshold value.
	GetLowThreshold	Calculates the low threshold value.
	GetObjectData	Populates a SerializationInfo with the data needed to serialize the target object. (Overrides ApplyLutCommandBase.GetObjectData(SerializationInfo, StreamingContext).)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	ImageCommandGetObjectData	Aggregates ImageCommand data into the supplied SerializationInfo object. (Inherited from ImageCommand.)
	ImplementMe	Future use. (Overrides ApplyLutCommandBase.ImplementMe().)
	IsPixelFormatSupported	Returns a value indicating if the specified pixel format is supported. (Inherited from ImageCommand.)
	LLClearChannelLut	Low-level implementation to clear the channel lookup table. (Inherited from ApplyLutCommandBase.)
	LLGetChannelLut	Returns the loop-up-table for a single channel. (Inherited from ApplyLutCommandBase.)
	LLSetChannelLut(ChannelFlags,Byte[])	Sets the loop-up-table for a single channel. (Inherited from ApplyLutCommandBase.)
	LLSetChannelLut(ChannelFlags,Int32[])	Low-level implementation of set channel look up table. (Inherited from ApplyLutCommandBase.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	PerformActualCommand	PerformActualCommand does the actual work of the image processing command. (Overrides ApplyLutCommandBase.PerformActualCommand(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 ApplyLutCommandBase.VerifyProperties(AtalaImage).)

Top

Remarks

The shadow, midtone, and highlights are often manually determined from an "eyedropper" tool.

Reference

Atalasoft.Imaging.ImageProcessing.Effects Namespace