Under most circumstances, you will want to install ABCocr .NET using the standard installer and register your license using the OCRSettings control panel.

Occasionally, you may wish to install ABCocr manually. To do this, you will need the files listed below.

File Name Notes
ABCocr.dll

The Assembly used by .NET.

The installer places this assembly in the GAC to allow global access from any .NET application. It installs a second reference copy at the following location:

%ProgramFiles%\WebSupergoo\ABCocr3 .NET\Common\

However, if you are installing manually you can just place this file in the bin directory of your application.

Tesseract.dll

The Tesseract core engine.

This DLL contains the core OCR engine, typically placed at:

%windir%\system32 [x86 systems]
%windir%\SysWow64\system32 [x64 systems]

However if you are installing manually you can just place this file in the bin directory of your application.

The fact that the DLL is 32 bit is not important as ABCocr will perform any 64 to 32 bit thunks automatically.

liblept168.dll

The Leptonica core engine.

This DLL contains the core graphics engine, typically placed at:

%windir%\system32 [x86 systems]
%windir%\SysWow64\system32 [x64 systems]

However if you are installing manually you can just place this file in the bin directory of your application.

The fact that the DLL is 32 bit is not important as ABCocr will perform any 64 to 32 bit thunks automatically.

tessdata
(directory)

This directory contains the training data files that Tesseract needs to be able to recognise different scripts.

ABCocr comes with a variety of different data files, designed to cover a wide variety of languages. It is designed to work out of the box. However if you have specific requirements you can generate your own Tesseract 3 compliant files and use these instead or as well. Equally, if you want to redistribute and you don't want the overhead of all the languages that come included with ABCocr you can strip the directory down to basics.

The ABCocr installer creates a tessdata folder at:

%ProgramFiles%\WebSupergoo\ABCocr3 .NET\Common\

If you are installing manually you can just place a copy of this folder in the bin directory of your application.

Typically you will want to locate this folder in the same folder as ABCocr.dll.

 

Most calls to ABCocr will result in a trial license being installed if it is found that no license has yet been installed. At minimum, all that is required is to query the value of the XSettings.License property.

[C#]
using WebSupergoo.ABCocr3;
MessageBox.Show("New License: " + XSettings.License);

[Visual Basic]
Imports WebSupergoo.ABCocr3
MessageBox.Show("New License: " + XSettings.License)

You can use a full license key as provided to you when you purchase, or you can use a trial license key copied from the PDFSettings application. To enter a license key, call XSettings.InstallLicense at application startup before any ABCocr objects have been created.

[C#]
using WebSupergoo.ABCocr3;
// Here we use a trial license key as copied from the OCRSettings application.
if (XSettings.InstallLicense("cd9b5c07db69df2bf57c0a04d9bca58b10c44889c9fb197984e592f49addfce5ec5fe85d7b9205bc"))
  MessageBox.Show("License Installed Successfully: " + XSettings.License);
else
  MessageBox.Show("License Installation Failed");

[Visual Basic]
Imports WebSupergoo.ABCocr3
' Here we use a trial license key as copied from the OCRSettings application.
If XSettings.InstallLicense("cd9b5c07db69df2bf57c0a04d9bca58b10c44889c9fb197984e592f49addfce5ec5fe85d7b9205bc") Then
  MessageBox.Show("License Installed Successfully: " + XSettings.License)
Else
  MessageBox.Show("License Installation Failed")
End If

The ABCocr installer performs checks at installation time in order to ensure that a trial license is installed. However, installing a license at other times can be problematic if your code is operating from a reduced permission account such as that associated with ASP.NET.

If this is the case or if you have purchased a Redistribution license, you need to call XSettings.InstallRedistributionLicense at application startup before any ABCocr objects have been created. You only need to call this method once though calling it additional times will not cause problems. The license will remain available to the process until it unloads.