SearchRegistrationMarksCommand Class

Summary

Searches the image for the registration marks according to the information in SearchMarks. This command is available in the Document/Medical toolkits.

Syntax

Objective-C

C++/CLI

Java

Python

public class SearchRegistrationMarksCommand : RasterCommand

@interface LTSearchRegistrationMarksCommand : LTRasterCommand

public class SearchRegistrationMarksCommand 
    extends RasterCommand

public ref class SearchRegistrationMarksCommand : public RasterCommand

class SearchRegistrationMarksCommand(RasterCommand):

Remarks

This command searches the image for registration marks. The SearchMarks array contains the information about the registration marks. Declare the array and fill in the information about the registration marks for which to search before calling the command.
The command will update each member of the SearchMarks array with information about the detected registration marks:
- The MarkDetectedCount property will be updated with number of detected marks in that area.
- The MarkDetectedPoints property (and the markDetectedPoints parameter if you are using the appropriate SearchRegistrationMarksCommand Constructor, will be updated with the position of the detected marks.
You can call GetTransformationParameters to get the transformation parameters, which can be applied to this image to make it match the reference image.
If you simply want to automatically straighten the image, use the DeskewCommand.
This commend 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

Java

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:\LEADTOOLS23\Resources\Images"; 
}

 
import static org.junit.Assert.assertTrue; 
 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.imageprocessing.core.*; 
 
 
public void getTransformationParametersExample() { 
 
      final String LEAD_VARS_IMAGES_DIR = "C:\\LEADTOOLS23\\Resources\\Images"; 
 
      // Load an image 
      RasterCodecs codecs = new RasterCodecs(); 
      codecs.setThrowExceptionsOnInvalidImages(true); 
      RasterImage image = codecs.load(combine(LEAD_VARS_IMAGES_DIR, "rgsref.cmp")); 
 
      // Prepare the command 
      SearchRegistrationMarksCommandData[] rmData = new SearchRegistrationMarksCommandData[3]; 
 
      // Mark1 
      rmData[0] = new SearchRegistrationMarksCommandData(); 
      rmData[0].setRectangle(new LeadRect(680, 20, 941 - 680, 218 - 20)); 
      rmData[0].setMarkDetectedPoints(new LeadPoint[1]); 
      rmData[0].setWidth(31); 
      rmData[0].setHeight(29); 
      rmData[0].setType(RegistrationMarkCommandType.T_SHAPE); 
      rmData[0].setMinimumScale(90); 
      rmData[0].setMaximumScale(110); 
      rmData[0].setSearchMarkCount(1); 
 
      // Mark2 
      rmData[1] = new SearchRegistrationMarksCommandData(); 
      rmData[1].setRectangle(new LeadRect(665, 790, 899 - 665, 961 - 790)); 
      rmData[1].setMarkDetectedPoints(new LeadPoint[1]); 
      rmData[1].setWidth(31); 
      rmData[1].setHeight(29); 
      rmData[1].setType(RegistrationMarkCommandType.T_SHAPE); 
      rmData[1].setMinimumScale(90); 
      rmData[1].setMaximumScale(110); 
      rmData[1].setSearchMarkCount(1); 
 
      // Mark3 
      rmData[2] = new SearchRegistrationMarksCommandData(); 
      rmData[2].setRectangle(new LeadRect(7, 1073, 298 - 7, 1246 - 1073)); 
      rmData[2].setMarkDetectedPoints(new LeadPoint[1]); 
      rmData[2].setWidth(31); 
      rmData[2].setHeight(29); 
      rmData[2].setType(RegistrationMarkCommandType.T_SHAPE); 
      rmData[2].setMinimumScale(90); 
      rmData[2].setMaximumScale(110); 
      rmData[2].setSearchMarkCount(1); 
      SearchRegistrationMarksCommand command1 = new SearchRegistrationMarksCommand(rmData); 
      command1.run(image); 
 
      if ((rmData[2].getMarkDetectedCount() != 1) || (rmData[1].getMarkDetectedCount() != 1) 
                  || (rmData[0].getMarkDetectedCount() != 1)) 
            return; 
 
      LeadPoint[] original = { 
                  new LeadPoint(81400, 11300), 
                  new LeadPoint(78600, 87400), 
                  new LeadPoint(14300, 115400) 
      }; 
 
      LeadPoint[] detected = { 
                  rmData[0].getMarkDetectedPoints()[0], 
                  rmData[1].getMarkDetectedPoints()[0], 
                  rmData[2].getMarkDetectedPoints()[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.getXTranslation(), parameters.getYTranslation(), parameters.getAngle(), 
                  parameters.getXScale(), 
                  parameters.getYScale(), 
                  ApplyTransformationParametersCommandFlags.NORMAL.getValue()); 
      applyCommand.run(image); 
 
      codecs.save(image, combine(LEAD_VARS_IMAGES_DIR, "Result.jpg"), RasterImageFormat.JPEG, 0); 
 
      assertTrue(new File(combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")).exists()); 
      System.out.println("Image successfully ran and saved to " + combine(LEAD_VARS_IMAGES_DIR, "Result.jpg")); 
 
}