Leadtools.ImageProcessing.SpecialEffects Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
PlaneCommand Constructor(Point,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,RasterColor,RasterColor,PlaneCommandFlags)
See Also  Example
Leadtools.ImageProcessing.SpecialEffects Namespace > PlaneCommand Class > PlaneCommand Constructor : PlaneCommand Constructor(Point,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,Int32,RasterColor,RasterColor,PlaneCommandFlags)



centerPoint
Contains the point at which the camera or viewer is looking. This is also the point toward which the images will be bent. It may be outside the image borders.
zValue
Viewing screen offset on the Z-axis, in pixels.
distance
Camera distance from the viewing screen, in pixels.
planeOffset
Distance between the parallel planes. This property only accepts positive values.
repeat
Number of times the image repeats along the Z-axis. If repeat equals -1 the image will be infinitely repeated. Its range starts from -1.
pyramidAngle
The view angle, off the Z-axis. This value is given in hundredths of a degree (+/-). This can be a number from 0 to 36,000.
stretch
Value that indicates whether to expand or compress the image, and by how much. If Stretch < 100 image will be expanded. If Stretch > 100 the image will be compressed. Use 100 to maintain the image's dimensions. The value of this parameter is internally divided by 100. This parameter only accepts positive values.
startBright
Value that indicates the brightness of an external light source on the first image displayed. Possible values range from 0 to 100. A value of 0 indicates no external light displayed on the image. A value of 100 indicates an external light source with full brightness is displayed on the image.
endBright
Value that indicates the brightness of an external light source on the last image displayed. Possible values range from 0 to 100. A value of 0 indicates no external light displayed on the image. A value of 100 indicates an external light source with full brightness is displayed on the image.
brightLength
Value that indicates how much the brightness changes as you move along the Z axis. This property is internally multiplied by 50.
brightColor
Specifies the color of an external light source that shines on the displayed images.
fillColor
Specifies the background color.
flags
Flags that indicate the background color and the planes to be shown. You can use a bit wise OR (|) to specify one flag from each group.
Initializes a new PlaneCommand class object with explicit parameters.

Syntax

Visual Basic (Declaration)  
Public Function New( _
   ByVal centerPoint As Point, _
   ByVal zValue As Integer, _
   ByVal distance As Integer, _
   ByVal planeOffset As Integer, _
   ByVal repeat As Integer, _
   ByVal pyramidAngle As Integer, _
   ByVal stretch As Integer, _
   ByVal startBright As Integer, _
   ByVal endBright As Integer, _
   ByVal brightLength As Integer, _
   ByVal brightColor As RasterColor, _
   ByVal fillColor As RasterColor, _
   ByVal flags As PlaneCommandFlags _
)
Visual Basic (Usage) Copy Code
Dim centerPoint As Point
Dim zValue As Integer
Dim distance As Integer
Dim planeOffset As Integer
Dim repeat As Integer
Dim pyramidAngle As Integer
Dim stretch As Integer
Dim startBright As Integer
Dim endBright As Integer
Dim brightLength As Integer
Dim brightColor As RasterColor
Dim fillColor As RasterColor
Dim flags As PlaneCommandFlags
 
Dim instance As PlaneCommand(centerPoint, zValue, distance, planeOffset, repeat, pyramidAngle, stretch, startBright, endBright, brightLength, brightColor, fillColor, flags)
C#  
public PlaneCommand( 
   Point centerPoint,
   int zValue,
   int distance,
   int planeOffset,
   int repeat,
   int pyramidAngle,
   int stretch,
   int startBright,
   int endBright,
   int brightLength,
   RasterColor brightColor,
   RasterColor fillColor,
   PlaneCommandFlags flags
)
C++/CLI  
public:
PlaneCommand( 
   Point centerPoint,
   int zValue,
   int distance,
   int planeOffset,
   int repeat,
   int pyramidAngle,
   int stretch,
   int startBright,
   int endBright,
   int brightLength,
   RasterColor brightColor,
   RasterColor fillColor,
   PlaneCommandFlags flags
)

Parameters

centerPoint
Contains the point at which the camera or viewer is looking. This is also the point toward which the images will be bent. It may be outside the image borders.
zValue
Viewing screen offset on the Z-axis, in pixels.
distance
Camera distance from the viewing screen, in pixels.
planeOffset
Distance between the parallel planes. This property only accepts positive values.
repeat
Number of times the image repeats along the Z-axis. If repeat equals -1 the image will be infinitely repeated. Its range starts from -1.
pyramidAngle
The view angle, off the Z-axis. This value is given in hundredths of a degree (+/-). This can be a number from 0 to 36,000.
stretch
Value that indicates whether to expand or compress the image, and by how much. If Stretch < 100 image will be expanded. If Stretch > 100 the image will be compressed. Use 100 to maintain the image's dimensions. The value of this parameter is internally divided by 100. This parameter only accepts positive values.
startBright
Value that indicates the brightness of an external light source on the first image displayed. Possible values range from 0 to 100. A value of 0 indicates no external light displayed on the image. A value of 100 indicates an external light source with full brightness is displayed on the image.
endBright
Value that indicates the brightness of an external light source on the last image displayed. Possible values range from 0 to 100. A value of 0 indicates no external light displayed on the image. A value of 100 indicates an external light source with full brightness is displayed on the image.
brightLength
Value that indicates how much the brightness changes as you move along the Z axis. This property is internally multiplied by 50.
brightColor
Specifies the color of an external light source that shines on the displayed images.
fillColor
Specifies the background color.
flags
Flags that indicate the background color and the planes to be shown. You can use a bit wise OR (|) to specify one flag from each group.

Example

Run the PlaneCommand on an image.

Visual Basic Copy Code
Public Sub PlaneConstructorExample()
   RasterCodecs.Startup()
   Dim codecs As New RasterCodecs()
   codecs.ThrowExceptionsOnInvalidImages = True

   Dim leadImage As RasterImage = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg")

   ' Prepare the command
   Dim command As PlaneCommand = New PlaneCommand(New Point(CType((leadImage.Width / 2), Integer), CType((leadImage.Height / 2), Integer)), 0, leadImage.Height, CType((leadImage.Width / 2), Integer), -1, 0, 25, 0, 100, 20000, New RasterColor(255, 255, 255), New RasterColor(0, 0, 0), PlaneCommandFlags.Right Or PlaneCommandFlags.Left Or PlaneCommandFlags.Color)
   command.Run(leadImage)
   codecs.Save(leadImage, LeadtoolsExamples.Common.ImagesPath.Path + "Result.jpg", RasterImageFormat.Jpeg, 24)

   RasterCodecs.Shutdown()
End Sub
C# Copy Code
public void PlaneConstructorExample() 

   // Load an image 
   RasterCodecs.Startup(); 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "Master.jpg"); 
 
   // Prepare the command 
   PlaneCommand command = new PlaneCommand(new Point(image.Width / 2, image.Height / 2), 0, image.Height, image.Width /2, -1, 0, 25, 0, 100, 20000, new RasterColor(255, 255, 255), new RasterColor(0, 0, 0), PlaneCommandFlags.Right | PlaneCommandFlags.Left | PlaneCommandFlags.Color); 
   command.Run(image); 
   codecs.Save(image, LeadtoolsExamples.Common.ImagesPath.Path + "Result.jpg", RasterImageFormat.Jpeg, 24); 
 
   RasterCodecs.Shutdown(); 
}

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