IsRegistrationMark Method

Summary

Determines if the object inside the image is a registration mark or not. This method is available in the Document/Medical Toolkits.

Syntax

Objective-C

C++

Java

public static bool IsRegistrationMark( 
   RasterImage image, 
   RegistrationMarkCommandType type, 
   int minScale, 
   int maxScale, 
   int width, 
   int height 
)

Public Shared Function IsRegistrationMark( _ 
   ByVal image As RasterImage, _ 
   ByVal type As RegistrationMarkCommandType, _ 
   ByVal minScale As Integer, _ 
   ByVal maxScale As Integer, _ 
   ByVal width As Integer, _ 
   ByVal height As Integer _ 
) As Boolean

+ (BOOL)isRegistrationMark:(LTRasterImage *)image\ 
                      type:(LTRegistrationMarkCommandType)type 
                  minScale:(NSInteger)minScale 
                  maxScale:(NSInteger)maxScale 
                     width:(NSInteger)width 
                    height:(NSInteger)height 
                     error:(NSError **)error

public static boolean isRegistrationMark( 
   RasterImage image,  
   RegistrationMarkCommandType type,  
   int minScale,  
   int maxScale,  
   int width,  
   int height 
)

public: 
static bool IsRegistrationMark(  
   RasterImage^ image, 
   RegistrationMarkCommandType type, 
   int minScale, 
   int maxScale, 
   int width, 
   int height 
)

Parameters

image
RasterImage object that references the image to be searched for registration mark.

type
Value that specifies the type of registration mark for which to look. Currently, only one registration mark is defined (T-shape). See the Comments for more information. More shapes will be added in the future.

minScale
Minimum scaling factor of mark to be detected. This is a percentage. It must not exceed maxScale, or an error will be returned. This parameter accepts only positive values.

maxScale
Maximum scaling factor of mark to be detected. This is a percentage. It must not be lower than minScale, or an error will be returned. This parameter accepts only positive values.

width
The width of the registration mark (in pixels). This parameter accepts only positive values.

height
The height of the registration mark (in pixels). This parameter accepts only positive values.

Return Value

Boolean value indicating weather that specific object is registration mark or not.

Remarks

This method verifies whether the object inside the image is a registration mark. The object must be white and the background be black. Objects that are not white will not be detected. The image must have only one object inside it in order to work properly.
Currently, there is only one type defined, a T-shaped figure as shown in the following figure. This type is a "T" rotated by 90 degrees counter clockwise. The P4 point must be on the center point of Line P1P2 (that is, the distance from P1 to P4 equals the distance from P2 to P4). The line width should be greater than 2 pixels(preferably 3 pixels). There are no conditions on line lengths since you provide the values for width, height, maxScale, and minScale.
Do not use this command to search for registration marks inside the image. Use SearchRegistrationMarksCommand instead.
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

This example determines if the object is a registration mark.

using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using LeadtoolsExamples.Common; 
 
public void IsRegistrationMarkExample() 
{ 
   // Load an image 
   RasterCodecs codecs = new RasterCodecs(); 
   codecs.ThrowExceptionsOnInvalidImages = true; 
 
   RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "RGSRef.cmp")); 
 
   // Prepare the command 
   bool IsRegMark = CoreUtilities.IsRegistrationMark(image, RegistrationMarkCommandType.TShape, 90, 110, 31, 29); 
   MessageBox.Show(IsRegMark ? "It's Registration Mark" : "Not a Registration Mark"); 
 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS21\Resources\Images"; 
}

Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.ImageProcessing.Core 
 
Public Sub IsRegistrationMarkExample() 
   Dim codecs As New RasterCodecs() 
   codecs.ThrowExceptionsOnInvalidImages = True 
 
   Dim leadImage As RasterImage = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "RGSRef.cmp")) 
 
   ' Prepare the command 
   Dim IsRegMark As Boolean 
   IsRegMark = CoreUtilities.IsRegistrationMark(leadImage, RegistrationMarkCommandType.TShape, 90, 110, 31, 29) 
   If (IsRegMark) Then 
      MessageBox.Show("It's Registration Mark", "IsRegistrationMarkTest") 
   Else 
      MessageBox.Show("Not a Registration Mark", "IsRegistrationMarkTest") 
   End If 
 
End Sub 
 
Public NotInheritable Class LEAD_VARS 
   Public Const ImagesDir As String = "C:\LEADTOOLS21\Resources\Images" 
End Class

Requirements

Target Platforms

Reference

CoreUtilities Class

CoreUtilities Members

Detecting Registration Marks

Leadtools.ImageProcessing.Effects.CombineCommand

Leadtools.ImageProcessing.RotateCommand

Leadtools.ImageProcessing.SizeCommand

Leadtools.ImageProcessing.ResizeCommand

GetTransformationParameters Method

SearchRegistrationMarksCommand Class

GetRegistrationMarksCenterMass Method

Download our FREE evaluation

Help Version 21.0.2021.7.2