GdPicture.NET Reference Guide
ADRGetCloserTemplateForFile Method (GdPictureImaging)
Example 





GdPicture14 Namespace > GdPictureImaging Class : ADRGetCloserTemplateForFile Method
The path of the image to identify. Can be an empty string. If empty, prompts the user to select a file. You can subsequently use the GetLastPath() method to retrieve the path of the selected file.
Performs a Documents Recognition Operation from an image file and returns the Document Identifier Template ID which has the best similar content.
Syntax
'Declaration
 
Public Function ADRGetCloserTemplateForFile( _
   ByVal FilePath As String _
) As Integer
public int ADRGetCloserTemplateForFile( 
   string FilePath
)
public function ADRGetCloserTemplateForFile( 
    FilePath: String
): Integer; 
public function ADRGetCloserTemplateForFile( 
   FilePath : String
) : int;
public: int ADRGetCloserTemplateForFile( 
   string* FilePath
) 
public:
int ADRGetCloserTemplateForFile( 
   String^ FilePath
) 

Parameters

FilePath
The path of the image to identify. Can be an empty string. If empty, prompts the user to select a file. You can subsequently use the GetLastPath() method to retrieve the path of the selected file.

Return Value

The Template ID which has the best similar content to the specified image.
Example
How to create document templates and identify the one which has the closest similar content to an image file.
Dim TemplateID1 As Integer, TemplateID2 As Integer
Dim nCloserTemplate As Integer
'We create the first template from an image
TemplateID1 = oGdPictureImaging.ADRCreateTemplateFromFile("template1.tif")
If TemplateID1 = 0 Then
   MessageBox.Show("Can't create TemplateID1 " + "Error number: " + oGdPictureImaging.GetStat().ToString())
End If
'We create the second template from an other kind of image
TemplateID2 = oGdPictureImaging.ADRCreateTemplateFromFile("template2.tif")
If TemplateID2 = 0 Then
   MessageBox.Show("Can't create TemplateID2 " + "Error number: " + oGdPictureImaging.GetStat().ToString())
End If
'Now, we will try to identify an image.
nCloserTemplate = oGdPictureImaging.ADRGetCloserTemplateForFile("document.tif")
Select Case nCloserTemplate
Case TemplateID1
MessageBox.Show("This image seems to get best similar content as TemplateID1. Confidence is: " + oGdPictureImaging.ADRGetLastConfidence().ToString() + " %")
Case TemplateID2
MessageBox.Show("This image seems to get best similar content as TemplateID2. Confidence is: " + oGdPictureImaging.ADRGetLastConfidence().ToString() + " %")
End Select
'Release created templates from memory
oGdPictureImaging.ADRDeleteTemplate (TemplateID1)
oGdPictureImaging.ADRDeleteTemplate (TemplateID2)
See Also

Reference

GdPictureImaging Class
GdPictureImaging Members