GdPictureImaging.ADRCreateTemplateFromFileICM Method

Creates a new document identifier template from an image file. This function uses embedded color management (ICM).

public int ADRCreateTemplateFromFileICM(
    String FilePath
);

Visual Basic

Public Function ADRCreateTemplateFromFileICM(
    ByVal FilePath As String
) As Integer

Parameters

Parameters	Description
FilePath	The path of the image from which the new template will be created. If this parameter is empty, prompts the user to select a file.

Returns

The created template ID if success else, -1 if fail. check the GetStat() function to get the reason on this result.

Example

How to create document templates and identify the one which has the closer similar content than an image file.

Copy Code

Dim TemplateID1 As Integer, TemplateID2 As Integer
Dim nCloserTemplate As Integer
 
'We create the first template from an image
TemplateID1 = oGdPictureImaging.ADRCreateTemplateFromFileICM("template1.tif")
If TemplateID1 = 0 Then
   MsgBox "Can't create TemplateID1 " + "Error number: " + str(oGdPictureImaging.GetStat)
End If
 
'We create the second template from an other kind of image
TemplateID2 = oGdPictureImaging.ADRCreateTemplateFromFileICM("template2.tif")
If TemplateID2 = 0 Then
   MsgBox "Can't create TemplateID2 " + "Error number: " + str(oGdPictureImaging.GetStat)
End If
 
 
'Now, we will try to identify an image.
nCloserTemplate = oGdPictureImaging.ADRGetCloserTemplateForFileICM("document.tif")
 
Select Case nCloserTemplate
       Case TemplateID1
            MsgBox "This image seems to get best similar content as TemplateID1. Confidence is: " + str(oGdPictureImaging.ADRGetLastConfidence) + " %"
       Case TemplateID2
            MsgBox "This image seems to get best similar content as TemplateID2. Confidence is: " + str(oGdPictureImaging.ADRGetLastConfidence) + " %"
End Select
 
 
'Release created templates from memory
oGdPictureImaging.ADRDeleteTemplate (TemplateID1)
oGdPictureImaging.ADRDeleteTemplate (TemplateID2)