Places the image on parallel planes along the Z-axis.

Syntax

Visual Basic (Declaration)
Public Class PlaneCommandBitmapEffect Inherits RasterCommandBitmapEffect

Visual Basic (Usage)	Copy Code
`Dim instance As PlaneCommandBitmapEffect`

C#
public class PlaneCommandBitmapEffect : RasterCommandBitmapEffect

Managed Extensions for C++
public __gc class PlaneCommandBitmapEffect : public RasterCommandBitmapEffect

C++/CLI
public ref class PlaneCommandBitmapEffect : public RasterCommandBitmapEffect

XAML Property Element Usage
PlaneCommandBitmapEffect ...

Example

Visual Basic Copy Code

Visual Basic	Copy Code
Public Sub PlaneCommandBitmapEffectExample(ByVal element As FrameworkElement) Dim effect As PlaneCommandBitmapEffect = New PlaneCommandBitmapEffect() effect.Distance = 300 effect.CenterPoint = New System.Windows.Point(140, 95) effect.StartBright = 0 effect.EndBright = 100 effect.FillColor = Color.FromRgb(255, 255, 255) effect.Flags = PlaneCommandBitmapEffectsFlags.Right Or PlaneCommandBitmapEffectsFlags.Left Or PlaneCommandBitmapEffectsFlags.Color effect.PlaneOffset = 200 effect.PyramidAngle = 0 effect.Repeat = 5 effect.Stretch = 25 effect.ZValue = 0 effect.BrightColor = Color.FromRgb(255, 255, 255) effect.BrightLength = 2000 element.BitmapEffect = effect Dim storyboard As Storyboard = New Storyboard() Dim animation1 As Int32Animation = New Int32Animation() animation1.From = 300 animation1.To = 900 animation1.Duration = New Duration(TimeSpan.Parse("0:0:5")) animation1.RepeatBehavior = RepeatBehavior.Forever animation1.AutoReverse = True storyboard.SetTargetName(animation1, "AnimatedBitmapEffect") storyboard.SetTargetProperty(animation1, New PropertyPath(PlaneCommandBitmapEffect.DistanceProperty)) element.RegisterName("AnimatedBitmapEffect", effect) storyboard.Children.Add(animation1) storyboard.Begin(element) End Sub

Public Sub PlaneCommandBitmapEffectExample(ByVal element As FrameworkElement)

   Dim effect As PlaneCommandBitmapEffect = New PlaneCommandBitmapEffect()

   effect.Distance = 300

   effect.CenterPoint = New System.Windows.Point(140, 95)

   effect.StartBright = 0

   effect.EndBright = 100

   effect.FillColor = Color.FromRgb(255, 255, 255)

   effect.Flags = PlaneCommandBitmapEffectsFlags.Right Or PlaneCommandBitmapEffectsFlags.Left Or PlaneCommandBitmapEffectsFlags.Color

   effect.PlaneOffset = 200

   effect.PyramidAngle = 0

   effect.Repeat = 5

   effect.Stretch = 25

   effect.ZValue = 0

   effect.BrightColor = Color.FromRgb(255, 255, 255)

   effect.BrightLength = 2000

   element.BitmapEffect = effect



   Dim storyboard As Storyboard = New Storyboard()



   Dim animation1 As Int32Animation = New Int32Animation()

   animation1.From = 300

   animation1.To = 900

   animation1.Duration = New Duration(TimeSpan.Parse("0:0:5"))

   animation1.RepeatBehavior = RepeatBehavior.Forever

   animation1.AutoReverse = True



   storyboard.SetTargetName(animation1, "AnimatedBitmapEffect")

   storyboard.SetTargetProperty(animation1, New PropertyPath(PlaneCommandBitmapEffect.DistanceProperty))

   element.RegisterName("AnimatedBitmapEffect", effect)

   storyboard.Children.Add(animation1)



   storyboard.Begin(element)

End Sub

C# Copy Code

C#	Copy Code
public void PlaneCommandBitmapEffectExample(FrameworkElement element) { PlaneCommandBitmapEffect effect = new PlaneCommandBitmapEffect(); effect.Distance = 300; effect.CenterPoint = new Point(140, 95); effect.StartBright = 0; effect.EndBright = 100; effect.FillColor = Color.FromRgb(255, 255, 255); effect.Flags = PlaneCommandBitmapEffectsFlags.Right \| PlaneCommandBitmapEffectsFlags.Left \| PlaneCommandBitmapEffectsFlags.Color; effect.PlaneOffset = 200; effect.PyramidAngle = 0; effect.Repeat = 5; effect.Stretch = 25; effect.ZValue = 0; effect.BrightColor = Color.FromRgb(255, 255, 255); effect.BrightLength = 2000; element.BitmapEffect = effect; Storyboard storyboard = new Storyboard(); Int32Animation animation1 = new Int32Animation(); animation1.From = 300; animation1.To = 900; animation1.Duration = new Duration(TimeSpan.Parse("0:0:5")); animation1.RepeatBehavior = RepeatBehavior.Forever; animation1.AutoReverse = true; Storyboard.SetTargetName(animation1, "AnimatedBitmapEffect"); Storyboard.SetTargetProperty(animation1, new PropertyPath(PlaneCommandBitmapEffect.DistanceProperty)); element.RegisterName("AnimatedBitmapEffect", effect); storyboard.Children.Add(animation1); storyboard.Begin(element); }

public void PlaneCommandBitmapEffectExample(FrameworkElement element) 
{ 
   PlaneCommandBitmapEffect effect = new PlaneCommandBitmapEffect(); 
   effect.Distance = 300; 
   effect.CenterPoint = new Point(140, 95); 
   effect.StartBright = 0; 
   effect.EndBright = 100; 
   effect.FillColor = Color.FromRgb(255, 255, 255); 
   effect.Flags = PlaneCommandBitmapEffectsFlags.Right | PlaneCommandBitmapEffectsFlags.Left | PlaneCommandBitmapEffectsFlags.Color; 
   effect.PlaneOffset = 200; 
   effect.PyramidAngle = 0; 
   effect.Repeat = 5; 
   effect.Stretch = 25; 
   effect.ZValue = 0; 
   effect.BrightColor = Color.FromRgb(255, 255, 255); 
   effect.BrightLength = 2000; 
   element.BitmapEffect = effect; 
 
   Storyboard storyboard = new Storyboard(); 
 
   Int32Animation animation1 = new Int32Animation(); 
   animation1.From = 300; 
   animation1.To = 900; 
   animation1.Duration = new Duration(TimeSpan.Parse("0:0:5")); 
   animation1.RepeatBehavior = RepeatBehavior.Forever; 
   animation1.AutoReverse = true; 
 
   Storyboard.SetTargetName(animation1, "AnimatedBitmapEffect"); 
   Storyboard.SetTargetProperty(animation1, new PropertyPath(PlaneCommandBitmapEffect.DistanceProperty)); 
   element.RegisterName("AnimatedBitmapEffect", effect); 
   storyboard.Children.Add(animation1); 
 
   storyboard.Begin(element); 
}

XAML Copy Code

XAML	Copy 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.SpecialEffects;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:PlaneCommandBitmapEffect x:Name="AnimatedBitmapEffect" BrightColor="White" FillColor="White" Distance="50" CenterPoint="140, 95" StartBright="0" EndBright="100" Flags="Right, Left, Color" PlaneOffset="200" PyramidAngle="0" Repeat="5" Stretch="25" ZValue="0" BrightLength="2000" /> </Image.BitmapEffect> <Image.Triggers> <EventTrigger RoutedEvent="Image.Loaded"> <BeginStoryboard> <Storyboard> <Int32Animation Storyboard.TargetName="AnimatedBitmapEffect" Storyboard.TargetProperty="Distance" From="300" To="900" Duration="0:0:5" RepeatBehavior="Forever" AutoReverse="true" /> </Storyboard> </BeginStoryboard> </EventTrigger> </Image.Triggers> </Image> </Grid> </Page>

<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.SpecialEffects;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:PlaneCommandBitmapEffect x:Name="AnimatedBitmapEffect" BrightColor="White" FillColor="White" Distance="50" CenterPoint="140, 95" StartBright="0" EndBright="100" Flags="Right, Left, Color" PlaneOffset="200" PyramidAngle="0" Repeat="5" Stretch="25" ZValue="0" BrightLength="2000" /> 
      </Image.BitmapEffect> 
      <Image.Triggers> 
        <EventTrigger RoutedEvent="Image.Loaded"> 
          <BeginStoryboard> 
            <Storyboard> 
              <Int32Animation Storyboard.TargetName="AnimatedBitmapEffect" Storyboard.TargetProperty="Distance" From="300" To="900" Duration="0:0:5" RepeatBehavior="Forever" AutoReverse="true" /> 
            </Storyboard> 
          </BeginStoryboard> 
        </EventTrigger> 
      </Image.Triggers> 
    </Image> 
  </Grid> 
</Page>

Remarks

This command shows the effect of placing images on planes along the Z-axis and bending them toward a specific point. These images may be placed above, below, to the left or to the right of the Z-axis. An external light source of the specified color and brightness may be shined on the images. The brightness may vary along the z-axis according to the BrightLength value.
By changing CenterPoint and the viewing screen Z-offset, you can simulate moving along the axis.
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 command:
1. CenterPoint = new System.Windows.Point(320, 256)
2. ZValue = 0
3. Distance = 256
4. PlaneOffset = 256
5. Repeat = -1
6. PyramidAngle = 0
7. Stretch = 100
8. StartBright = 0
9. EndBright = 0
10. BrightLength = 50
11. BrightColor = FromRgb(255, 255, 255)
12. FillColor = FromRgb(0, 0, 0)
13. Flags = PlaneCommandBitmapEffectsFlags.Down | PlaneCommandBitmapEffectsFlags.Color
This command does not support signed data images.

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.SpecialEffects.PlaneCommandBitmapEffect

Requirements

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

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

Syntax

Example

Remarks

Inheritance Hierarchy

Requirements

See Also

Reference