FreeHandWaveCommand Class

Summary

Distorts the image by the wave specified in the amplitudes array and the rotation angle. This command is available in the Imaging and above toolkits.

Syntax

C++/CLI

Python

public class FreeHandWaveCommand : RasterCommand

public ref class FreeHandWaveCommand : public RasterCommand

class FreeHandWaveCommand(RasterCommand):

Remarks

The command applies the wave in the amplitudes array. You can repeat and rotate the wave in any direction. The amplitudes data can be obtained from the Leadtools.ImageProcessing.Effects.EffectsUtilities.GetCurvePoints(System.Int32[],Leadtools.LeadPoint[],Leadtools.ImageProcessing.Effects.CurvePointsType) utility method.
If the image has a region, the effect will be applied on the region only.
This command supports 12-bit and 16-bit grayscale and 48-bit and 64-bit color images. Support for 12-bit and 16-bit grayscale and 48-bit and 64-bit color images is available only in the Document/Medical toolkits.
This command does not support signed data images.
This command does not support 32-bit grayscale images.

For more information, refer to Applying Artistic Effects.

Free Hand Wave Function - Before

Free Hand Wave Function - After

View additional platform support for this Free Hand Wave function.

Example

Run the FreeHandWaveCommand on an image and apply triangular wave on the loaded image.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing.SpecialEffects; 
using Leadtools.ImageProcessing.Effects; 
 
 
public void FreeHandWaveCommandExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "sample5.cmp")); 
 
   // Prepare the command 
   LeadPoint[] UserPoint = new LeadPoint[4]; 
   int[] Amplitudes = new int[13]; 
 
   FreeHandWaveCommand command = new FreeHandWaveCommand(); 
 
   // Fill UserPoint array with points that define a triangular wave 
   UserPoint[0].X = 0; 
   UserPoint[0].Y = 0; 
   UserPoint[1].X = 3; 
   UserPoint[1].Y = 10; 
   UserPoint[2].X = 9; 
   UserPoint[2].Y = -10; 
   UserPoint[3].X = 12; 
   UserPoint[3].Y = 0; 
 
   //Draw a triangular wave according to UserPoint points and store the Amplitudes values in the Amplitudes array. 
   EffectsUtilities.GetCurvePoints(Amplitudes, UserPoint, CurvePointsType.Linear); 
 
   command.Amplitudes = Amplitudes; 
   command.Scale = 100; 
   command.WaveLength = 10; 
   command.Angle = 0; 
   command.FillColor = new RasterColor(0, 0, 0); 
   command.Flags = FreeHandWaveCommandFlags.Repeat | FreeHandWaveCommandFlags.Frequency; 
   command.Run(image); 
   codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "Result.jpg"), RasterImageFormat.Jpeg, 24); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}