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.
|