Leadtools.ImageProcessing.SpecialEffects Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.12.11
PlaneCommand Class
See Also  Members   Example 
Leadtools.ImageProcessing.SpecialEffects Namespace : PlaneCommand Class




Places the image on parallel planes along the Z-axis. This command is available in the Raster Pro and above toolkits.

Syntax

Visual Basic (Declaration) 
Public Class PlaneCommand 
   Inherits RasterCommand
   Implements IRasterCommand 
Visual Basic (Usage)Copy Code
Dim instance As PlaneCommand
C# 
public class PlaneCommand : RasterCommand, IRasterCommand 
Managed Extensions for C++ 
public __gc class PlaneCommand : public RasterCommand, IRasterCommand 
C++/CLI 
public ref class PlaneCommand : public RasterCommand, IRasterCommand 

Example

Visual BasicCopy Code
ImageProcessing.SpecialEffects.PlaneCommand
   Public Sub PlaneCommandExample()
      RasterCodecs.Startup()
      Dim codecs As New RasterCodecs()
      codecs.ThrowExceptionsOnInvalidImages = True

      Dim leadImage As RasterImage = codecs.Load("C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Master.jpg")

      ' Prepare the command
      Dim command As PlaneCommand = New PlaneCommand
      command.CenterPoint = New Point(leadImage.Width \ 2, leadImage.Height \ 2)
      command.ZValue = 0
      command.Distance = leadImage.Height
      command.PlaneOffset = leadImage.Width \ 2
      command.Repeat = -1
      command.PyramidAngle = 0
      command.Stretch = 25
      command.StartBright = 0
      command.EndBright = 100
      command.BrightLength = 20000
      command.BrightColor = New RasterColor(255, 255, 255)
      command.FillColor = New RasterColor(0, 0, 0)
      command.Flags = PlaneCommandFlags.Right Or PlaneCommandFlags.Left Or PlaneCommandFlags.Color
      command.Run(leadImage)
      codecs.Save(leadImage, "C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Result.jpg", RasterImageFormat.Jpeg, 24)

      RasterCodecs.Shutdown()
   End Sub
C#Copy Code
ImageProcessing.SpecialEffects.PlaneCommand 
      public void PlaneCommandExample() 
      { 
         // Load an image 
         RasterCodecs.Startup(); 
         RasterCodecs codecs = new RasterCodecs(); 
         codecs.ThrowExceptionsOnInvalidImages = true; 
 
         RasterImage image = codecs.Load(@"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Master.jpg"); 
 
         // Prepare the command 
         PlaneCommand command = new PlaneCommand(); 
         command.CenterPoint = new Point(image.Width / 2, image.Height / 2); 
         command.ZValue = 0; 
         command.Distance = image.Height; 
         command.PlaneOffset = image.Width /2; 
         command.Repeat = -1; 
         command.PyramidAngle = 0; 
         command.Stretch = 25; 
         command.StartBright = 0; 
         command.EndBright = 100; 
         command.BrightLength = 20000; 
         command.BrightColor = new RasterColor(255, 255, 255); 
         command.FillColor = new RasterColor(0, 0, 0); 
         command.Flags = PlaneCommandFlags.Right | PlaneCommandFlags.Left | PlaneCommandFlags.Color; 
         command.Run(image); 
         codecs.Save(image, @"C:\Program Files\LEAD Technologies\LEADTOOLS 15\Images\Result.jpg", RasterImageFormat.Jpeg, 24); 
 
         RasterCodecs.Shutdown(); 
      }

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.
  • If the image has a region, the effect will be applied on the region dimensions only.
  • 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.Drawing.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 = new RasterColor(255, 255, 255)
    12. FillColor = new RasterColor(0, 0, 0)
    13. Flags = PlaneCommandFlags.Down | PlaneCommandFlags.Color
    14. This command does not support 32-bit grayscale images.
  • This command supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.
  • This command does not support signed data images.
For more information, refer to Processing an Image.
For more information, refer to Correcting Colors.

Inheritance Hierarchy

System.Object
   Leadtools.ImageProcessing.RasterCommand
      Leadtools.ImageProcessing.SpecialEffects.PlaneCommand

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also