GetRegistrationMarksCenterMass Method

Summary

Finds the center of mass for each of the registration marks specified by markPoints. This method is available in the Document/Medical Toolkits.

Syntax

Objective-C

C++/CLI

Java

Python

public static LeadPoint[] GetRegistrationMarksCenterMass( 
   RasterImage image, 
   LeadPoint[] markPoints 
)

+ (nullable NSArray<NSValue *> * /*LeadPoint*/)getRegistrationMarksCenterMass:(LTRasterImage *)image 
                                                                   markPoints:(nullable NSArray<NSValue *> *)markPoints /*LeadPoint*/ 
                                                                        error:(NSError **)error

public static LeadPoint[] getRegistrationMarksCenterMass( 
   RasterImage image, 
   LeadPoint[] markPoints 
);

public: 
static array<LeadPoint>^ GetRegistrationMarksCenterMass(  
   RasterImage^ image, 
   array<LeadPoint>^ markPoints 
)

def GetRegistrationMarksCenterMass(self,image,] markPoints):

Parameters

image
RasterImage object that references the transformed image.

markPoints
Array of LeadPoint structures containing mark locations.

Return Value

Array of LeadPoint structures to be filled with points which represent the center of mass for each of the supplied registration marks. The first center of mass point corresponds to the first registration mark in the markPoints array and so on_

Remarks

This method is used to determine the center of mass for each supplied registration mark, to be used in detecting image rotation, scaling and translation.
The results (that is, the points representing each center of mass) returned by this method are multiplied by 100 in order to obtain more precision (00.00). To get the actual results, divide by 100.
This methods uses values that are divided internally by 100.
This method can be used in the following manner:
- Use SearchRegistrationMarksCommand to find the registration marks.
- Pass data from MarkDetectedPoints to this method to determine the points representing the center of mass for each registration mark.
- Pass these points to GetTransformationParameters to detect the image rotation, scaling and translation.
If you simply want to automatically straighten the image, use the DeskewCommand.
This method 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 method does not support signed data 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"; 
}

Requirements

Target Platforms

Reference

CoreUtilities Class

CoreUtilities Members

Detecting Registration Marks

Leadtools.ImageProcessing.Effects.CombineCommand

Leadtools.ImageProcessing.RotateCommand

Leadtools.ImageProcessing.SizeCommand

Leadtools.ImageProcessing.ResizeCommand

DeskewCommand Class

SearchRegistrationMarksCommand Class

GetTransformationParameters Method

Download our FREE evaluation

Help Version 22.0.2023.11.1