Leadtools.Windows.Media.Effects Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.02.15
LightControlCommandBitmapEffect Class
See Also  Members   Example 
Leadtools.Windows.Media.Effects.Color Namespace : LightControlCommandBitmapEffect Class





Lightens or darkens all or part of an image by remapping the pixel values.

Syntax

Visual Basic (Declaration) 
Public Class LightControlCommandBitmapEffect 
   Inherits RasterCommandBitmapEffect
Visual Basic (Usage)Copy Code
Dim instance As LightControlCommandBitmapEffect
C# 
public class LightControlCommandBitmapEffect : RasterCommandBitmapEffect 
Managed Extensions for C++ 
public __gc class LightControlCommandBitmapEffect : public RasterCommandBitmapEffect 
C++/CLI 
public ref class LightControlCommandBitmapEffect : public RasterCommandBitmapEffect 
XAML Property Element Usage 

LightControlCommandBitmapEffect ...

Example

Run the LightControlCommandBitmapEffect on an image.

Visual BasicCopy Code
Public Sub LightControlCommandBitmapEffectExample(ByVal element As FrameworkElement)
   ' Initialize Effect
   Dim effect As LightControlCommandBitmapEffect = New LightControlCommandBitmapEffect()
   Dim LowerAverage As Integer() = New Integer(2) {}
   Dim Average As Integer() = New Integer(2) {}
   Dim UpperAverage As Integer() = New Integer(2) {}
   LowerAverage(0) = 100 'for blue, gray or yuv
   LowerAverage(1) = 120 'for green
   LowerAverage(2) = 80 'for red
   Average(0) = 150 'for blue, gray or yuv
   Average(1) = 140 'for green
   Average(2) = 128 'for red
   UpperAverage(0) = 190 'for blue, gray or yuv
   UpperAverage(1) = 200 'for green
   UpperAverage(2) = 220 'for red

   effect.Average = Average
   effect.LowerAverage = LowerAverage
   effect.UpperAverage = UpperAverage
   effect.Type = LightControlCommandBitmapEffectsType.Rgb
   element.BitmapEffect = effect
End Sub
C#Copy Code
public void LightControlCommandBitmapEffectExample(FrameworkElement element) 

   // Initialize Effect 
   LightControlCommandBitmapEffect effect = new LightControlCommandBitmapEffect(); 
   int[] LowerAverage = new int[3]; 
   int[] Average = new int[3]; 
   int[] UpperAverage = new int[3]; 
   LowerAverage[0] = 100; //for blue, gray or yuv  
   LowerAverage[1] = 120; //for green  
   LowerAverage[2] = 80;  //for red  
   Average[0] = 150; //for blue, gray or yuv  
   Average[1] = 140; //for green  
   Average[2] = 128; //for red  
   UpperAverage[0] = 190; //for blue, gray or yuv  
   UpperAverage[1] = 200; //for green  
   UpperAverage[2] = 220; //for red   
 
   effect.Average = Average; 
   effect.LowerAverage = LowerAverage; 
   effect.UpperAverage = UpperAverage; 
   effect.Type = LightControlCommandBitmapEffectsType.Rgb; 
 
   element.BitmapEffect = effect; 
}
XAMLCopy Code
<Page Title="CSAnimateEffect" Height="391" Width="300" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:lteffects="clr-namespace:Leadtools.Windows.Media.Effects.Color;assembly=Leadtools.Windows.Media.Effects"> 
  <Grid> 
    <Image Margin="10,10,10,10" HorizontalAlignment="Center" VerticalAlignment="Center" Source="C:\Program Files\LEAD Technologies, Inc\LEADTOOLS 15\Images\slave.jpg"> 
      <Image.BitmapEffect> 
        <lteffects:LightControlCommandBitmapEffect x:Name="MyBitmapEffect" /> 
      </Image.BitmapEffect> 
    </Image> 
  </Grid> 
</Page>

Remarks

  • This class remaps the pixel values of the image across the full range of available pixel values, in order to achieve the values passed in LowerAverage, Average and UpperAverage. For example, call this method for a grayscale image, with Average containing 150, LowerAverage containing 100 and UpperAverage containing 190. The pixels of the image will be remapped so that the new average pixel value for the entire image will be 150, the new average value for those pixels with a value between 0 and the average value for the entire image will be 100, and the new average value for those pixels with a value between the average value for the entire image and the maximum pixel value in the image will be 190.
  • This command does not support signed data images.
  • For an example, see the following figure:

  • The following figure shows the same image, after the effect has been applied:

  • To obtain this effect, the following settings were used with the method: LowerAverage = 100
    Average = 255
    UpperAverage = 255
    Type = LightControlCommandBitmapEffectsType.Yuv

Inheritance Hierarchy

System.Object
   System.Windows.Threading.DispatcherObject
      System.Windows.DependencyObject
         System.Windows.Freezable
            System.Windows.Media.Animation.Animatable
               System.Windows.Media.Effects.BitmapEffect
                  Leadtools.Windows.Media.Effects.RasterCommandBitmapEffect
                     Leadtools.Windows.Media.Effects.Color.LightControlCommandBitmapEffect

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Vista, and Windows Server 2003

See Also