ApplyTransformationParametersCommand Class

Summary

Corrects the image by removing the translation, rotation, and scaling deformations that have been applied to the image.

Syntax

Objective-C

C++/CLI

Java

Python

public class ApplyTransformationParametersCommand : RasterCommand

@interface LTApplyTransformationParametersCommand : LTRasterCommand

public class ApplyTransformationParametersCommand 
    extends RasterCommand

public ref class ApplyTransformationParametersCommand : public RasterCommand

class ApplyTransformationParametersCommand(RasterCommand):

Remarks

This command is available in the Document/Medical Toolkits.

This command corrects the image by removing the translation, rotation, and scaling deformations that have been applied to the image. These transformations make this image match a reference image.
This command is designed to work with GetTransformationParameters.
Get the values for the translation, rotation, and scaling parameters by calling GetTransformationParameters: the returned values must be passed exactly as they are to the ApplyTransformationParametersCommand method.
The shift operation is performed first, followed by the rotation and resize operations.
If you simply want to automatically straighten the image, use the DeskewCommand.
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.
This command does not support 32-bit grayscale images.

For more information, refer to Detecting Registration Marks.

Example

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
 
 
public void GetTransformationParametersExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "RGSRef.cmp")); 
 
   // Prepare the command 
   SearchRegistrationMarksCommandData[] rmData = new SearchRegistrationMarksCommandData[3]; 
 
   //Mark1 
   rmData[0] = new SearchRegistrationMarksCommandData(); 
   rmData[0].Rectangle = new LeadRect(680, 20, 941 - 680, 218 - 20); 
   rmData[0].MarkDetectedPoints = new LeadPoint[1]; 
   rmData[0].Width = 31; 
   rmData[0].Height = 29; 
   rmData[0].Type = RegistrationMarkCommandType.TShape; 
   rmData[0].MinimumScale = 90; 
   rmData[0].MaximumScale = 110; 
   rmData[0].SearchMarkCount = 1; 
 
   //Mark2 
   rmData[1] = new SearchRegistrationMarksCommandData(); 
   rmData[1].Rectangle = new LeadRect(665, 790, 899 - 665, 961 - 790); 
   rmData[1].MarkDetectedPoints = new LeadPoint[1]; 
   rmData[1].Width = 31; 
   rmData[1].Height = 29; 
   rmData[1].Type = RegistrationMarkCommandType.TShape; 
   rmData[1].MinimumScale = 90; 
   rmData[1].MaximumScale = 110; 
   rmData[1].SearchMarkCount = 1; 
 
   //Mark3 
   rmData[2] = new SearchRegistrationMarksCommandData(); 
   rmData[2].Rectangle = new LeadRect(7, 1073, 298 - 7, 1246 - 1073); 
   rmData[2].MarkDetectedPoints = new LeadPoint[1]; 
   rmData[2].Width = 31; 
   rmData[2].Height = 29; 
   rmData[2].Type = RegistrationMarkCommandType.TShape; 
   rmData[2].MinimumScale = 90; 
   rmData[2].MaximumScale = 110; 
   rmData[2].SearchMarkCount = 1; 
   SearchRegistrationMarksCommand command1 = new SearchRegistrationMarksCommand(rmData); 
   command1.Run(image); 
   if ((rmData[2].MarkDetectedCount != 1) || (rmData[1].MarkDetectedCount != 1) || (rmData[0].MarkDetectedCount != 1)) 
      return; 
 
   LeadPoint[] original = 
   { 
      new LeadPoint(81400, 11300), 
      new LeadPoint(78600, 87400), 
      new LeadPoint(14300, 115400) 
   }; 
 
   LeadPoint[] detected = 
   { 
      rmData[0].MarkDetectedPoints[0], 
      rmData[1].MarkDetectedPoints[0], 
      rmData[2].MarkDetectedPoints[0] 
   }; 
 
   //Find center of mass for detected registration marks in the transformed image 
   LeadPoint[] transformed = CoreUtilities.GetRegistrationMarksCenterMass(image, detected); 
   //Find transformation parameters 
   TransformationParameters parameters = CoreUtilities.GetTransformationParameters(image, original, transformed); 
   //Apply transformation parameters to correct the image 
   ApplyTransformationParametersCommand applyCommand = new ApplyTransformationParametersCommand(parameters.XTranslation, parameters.YTranslation, parameters.Angle, parameters.XScale, parameters.YScale, 
         ApplyTransformationParametersCommandFlags.Normal); 
   applyCommand.Run(image); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
}