Changes the value of a pixel by an amount determined by the input Red, Green and Blue channel RGB values individually, or as an averaged value.

The change is graduated starting from LoLimit, with a maximum change applied to the midpoint between LoLimit and HiLimit, then reduced again to HiLimit.

Typically this method can be used to effectively progressively brighten or darken any range of colors as requested without affecting colors outside the range.

RGB values in the range of 0 to 127 are considered as darker, and 128 to 255 as lighter.

Namespace: HiComponents.IEvolution
Assembly: IEvolution2 (in IEvolution2.dll) Version: 10.0.0.0

Syntax

         
 C#  Visual Basic  Visual C++ 
public void Intensity(
	int loLimit,
	int hiLimit,
	int change,
	bool useAverageRGB,
	bool doRed,
	bool doGreen,
	bool doBlue
)
Public Sub Intensity ( _
	loLimit As Integer, _
	hiLimit As Integer, _
	change As Integer, _
	useAverageRGB As Boolean, _
	doRed As Boolean, _
	doGreen As Boolean, _
	doBlue As Boolean _
)
public:
void Intensity(
	int loLimit, 
	int hiLimit, 
	int change, 
	bool useAverageRGB, 
	bool doRed, 
	bool doGreen, 
	bool doBlue
)

Parameters

loLimit
Int32
An integer between 0 and 255 that indicates the start point of the range.
hiLimit
Int32
An integer between 0 and 255 that indicates the end point of the range.
change
Int32
An integer between -255 and 255 that indicates the maximum or minimum value to be applied to the midpoint, and used to determine the slope of the increment/decrement used over the range.
useAverageRGB
Boolean
If True, uses the average value of the input Red, Green and Blue channels to determine the amount to change all RGB channels in the pixel.
doRed
Boolean
If True, applies the change to this RGB channel.
doGreen
Boolean
If True, applies the change to this RGB channel.
doBlue
Boolean
If True, applies the change to this RGB channel.

Examples

CopyC#
// Apply an Intensity gradient peaking at +40 to all RGB values between 80 and 255
ieViewer1.Image.Intensity( 80, 255, 40, false, true, true, true );

// Apply an Intensity gradient dropping to -24, to the Red RGB channel only, when Red values are between 20 and 127
ieViewer1.Image.Intensity( 20, 127, -24, false, true, false, false );

See Also