267 lines
8.7 KiB
Plaintext
267 lines
8.7 KiB
Plaintext
|
|
Nuance OmniPage Capture SDK version 19.2
|
|
64-bit version
|
|
|
|
Checking prerequisites
|
|
======================
|
|
Check that a Package Manager is installed on your system. On Redhat-based
|
|
systems check for the Redhat Package Manager (rpm):
|
|
|
|
which rpm
|
|
|
|
On Debian-based systems check the Debian Package Manager (dpkg):
|
|
|
|
which dpkg
|
|
|
|
|
|
Get the binary packages
|
|
=======================
|
|
|
|
Depending on the Package Manager your system uses you need to get one of the
|
|
ZIP files that contain the binary packages. On Redhat-based systems you need
|
|
the rpm-*.zip file while on Debian-based systems download the deb-*.zip file.
|
|
|
|
Unzip the downloaded file to get the rpm or deb package binaries.
|
|
|
|
|
|
Get the Nuance public key
|
|
=========================
|
|
Get the gpg-pubkey-nuance-lnx1.asc file from the Nuance web site. If you have
|
|
wget installed you can do that like this:
|
|
|
|
wget http://www.nuance.com/keys/gpg-pubkey-nuance-lnx1.asc
|
|
|
|
If you use rpm for installation you should import the key into rpm's database.
|
|
First check that it's not already imported (you shouldn't import it twice!!)
|
|
|
|
rpm -q gpg-pubkey
|
|
|
|
The Nuance public key is already imported if the following code is printed:
|
|
gpg-pubkey-38ccaf9d-47ff83a7
|
|
Otherwise import it (root access is necessary):
|
|
|
|
sudo rpm --import gpg-pubkey-nuance-lnx1.asc
|
|
|
|
Note: with newer versions of rpm you may get the following error report:
|
|
'import read failed (0)'
|
|
in this case remove the carriage return codes from the file with
|
|
dos2unix or with the following commands:
|
|
mv gpg-pubkey-nuance-lnx1.asc ori.asc
|
|
tr -d '\r' < ori.asc > gpg-pubkey-nuance-lnx1.asc
|
|
and repeat the import.
|
|
|
|
On Debian systems import it into GnuPG (gpg):
|
|
|
|
gpg --import gpg-pubkey-nuance-lnx1.asc
|
|
|
|
To verify the Nuance Debian packages use the command:
|
|
|
|
gpg --verify-files nuance-*.asc
|
|
|
|
|
|
Installation
|
|
============
|
|
Start the Package Manager guided installation (root access is necessary):
|
|
|
|
sudo rpm -i nuance-omnipage-csdk-lib64-19.2-*.x86_64.rpm
|
|
|
|
On Debian systems you should use
|
|
|
|
sudo dpkg -i nuance-omnipage-csdk-lib64_19.2-*_amd64.deb
|
|
|
|
This will install binaries to as described in the package's description.
|
|
|
|
Now install the development files: header files, sample sources and
|
|
documentation
|
|
|
|
sudo rpm -i nuance-omnipage-csdk-devel-19.2-*.x86_64.rpm
|
|
or
|
|
sudo dpkg -i nuance-omnipage-csdk-devel_19.2-*_amd64.deb
|
|
|
|
The development files are installed to the following locations:
|
|
|
|
Documentation:
|
|
/usr/local/share/doc/nuance-omnipage-csdk-19.2
|
|
Sample application:
|
|
/usr/local/src/nuance-omnipage-csdk-19.2
|
|
Header files:
|
|
/usr/local/include/nuance-omnipage-csdk-19.2
|
|
|
|
License activation application OP License Manager:
|
|
/usr/local/bin/oplicmgr
|
|
|
|
The documentation is presented as a set of html files linked together in a
|
|
hierarchy by the file index.html in the above location, i.e.:
|
|
/usr/local/share/doc/nuance-omnipage-csdk-19.2/index.html
|
|
|
|
|
|
Removing the installation
|
|
=========================
|
|
Start the Package Manager guided uninstallation (root access is necessary):
|
|
|
|
sudo rpm -e nuance-omnipage-csdk-devel
|
|
sudo rpm -e nuance-omnipage-csdk-lib64
|
|
|
|
On Debian system:
|
|
|
|
sudo dpkg -P nuance-omnipage-csdk-devel
|
|
sudo dpkg -P nuance-omnipage-csdk-lib64
|
|
|
|
|
|
Quick start
|
|
===========
|
|
|
|
Activate your license:
|
|
----------------------
|
|
You must have already got a separate e-mail with the License Keys purchased.
|
|
Use the installed OP License Manager (oplicmgr) to activate them.
|
|
Try oplicmgr without any options to get a short on-screen help. For details
|
|
about licenses and their activation see the page Licensing on Linux and
|
|
Mac OS X in the RecAPI documentation.
|
|
|
|
Command line examples:
|
|
|
|
oplicmgr -c 123456789abc -n ~/my.lcxz R605Z-L00-1234-5678-9A
|
|
Downloads the license specified by the above key, activates it, puts it
|
|
into the license pack ~/my.lcxz and creates ~/my.h with the above OEM
|
|
code.
|
|
|
|
oplicmgr -u ~/my.lcxz R605Z-L00-1234-5678-9B
|
|
Downloads the license specified by the above key, activates it, and
|
|
adds it to the license pack ~/my.lcxz.
|
|
|
|
oplicmgr -l ~/my.lcxz
|
|
Lists both the licenses added to the license pack and shows their
|
|
features.
|
|
|
|
Usually you will use a single license pack file containing the Development
|
|
licenses and another one with the Distribution licenses. We suggest you use
|
|
the same OEM code for both packs.
|
|
|
|
Run the sample application:
|
|
---------------------------
|
|
You can test your installation by making and running the sample application:
|
|
(Note that the make below will fail. It is normal, keep on reading)
|
|
|
|
mkdir sample
|
|
cd sample
|
|
cp /usr/local/src/nuance-omnipage-csdk-19.2/* .
|
|
make
|
|
|
|
At this stage the compiler will issue an error message saying that you need
|
|
to change two lines in the sample.h file. Change that file by adding the
|
|
file name of the LCXZ license file you created in the previous license
|
|
activation step and #include the header file defining the OEM Code that is
|
|
also generated.
|
|
(There is no need to specify an absolute path for the LCXZ license file name,
|
|
see the documentation of kRecSetLicense.)
|
|
Don't forget to comment out the '#error' line above the modifications!
|
|
|
|
After these changes re-make and run the sample application:
|
|
|
|
make
|
|
./sample -h
|
|
|
|
this writes a short help on how to use the command line application.
|
|
You may build a GTK-based version as well:
|
|
|
|
make sampledlg
|
|
./sampledlg
|
|
|
|
See the supplied Makefile for the use of OCRLIBPATH and OCRINCPATH
|
|
|
|
|
|
Notes on SELinux systems
|
|
========================
|
|
|
|
On SELinux-enabled systems some of the .so files in Capture SDK could not be
|
|
loaded by the OS and you get an API_MODULELOAD_ERR from kRecRecognize. In this
|
|
case make the following changes:
|
|
|
|
cd /usr/local/lib/nuance-omnipage-csdk-lib64-19.2
|
|
sudo chcon -t textrel_shlib_t libmor.so libpccext.so
|
|
cd
|
|
|
|
Only the above 2 .so files are to be modified this way!
|
|
|
|
|
|
Notes on reading Normal (non-image-only) PDF input
|
|
==================================================
|
|
|
|
The conversion of PDF files depends on the fonts installed on your system.
|
|
The generated image and thus the recognition result may be better if one
|
|
of the following font packages is installed:
|
|
- msttcorefonts (windows essential fonts pack, it may have different name
|
|
on different Linux distributions),
|
|
- liberation-fonts (on Red Hat distributions).
|
|
You may want to read http://en.opensuse.org/Optimal_Use_of_Fonts_on_SuSE for
|
|
SuSE systems.
|
|
|
|
Installing font files is especially important for Asian PDF input. For a
|
|
good starting point see the following article:
|
|
http://en.wikipedia.org/wiki/Help:Multilingual_support_(East_Asian)
|
|
|
|
|
|
System requirements
|
|
===================
|
|
|
|
This version of the OmniPage Captrue SDK is compatible with 64 bit x86_64
|
|
systems.
|
|
32 bit environments and other processor architectures are not supported.
|
|
It is suggested to have a Core 2 Duo or better processor and at least 1 GB
|
|
of RAM.
|
|
|
|
Minimum software versions:
|
|
GNU make version 3.81 (make)
|
|
gcc version 4.4.3 (C compiler)
|
|
g++ version 4.4.3 (C++ compiler)
|
|
|
|
gcc/g++ compiler versions earlier than 4.4.0 are NOT supported.
|
|
|
|
Tested distributions:
|
|
Fedora 20, 21
|
|
Debian 7.5, 7.7 and 8.1
|
|
Oracle Linux 6.5, 7.0
|
|
CentOS 6.3
|
|
|
|
|
|
3rd party license notes
|
|
=======================
|
|
|
|
The JPEG image read and write capability of the Nuance OmniPage Capture
|
|
SDK is based on the work of the Independent JPEG Group.
|
|
|
|
The Portable Network Graphics (PNG) image file read and write capability of
|
|
the Nuance OmniPage Capture SDK is based, in part, on the PNG Reference
|
|
Library (libpng).
|
|
|
|
The Portable Network Graphics (PNG) image and the PDF file read and write
|
|
capability of the Nuance OmniPage Capture SDK is based, in part, on the
|
|
zlib Compression Library.
|
|
|
|
The PDF read capability of the Nuance OmniPage Capture SDK is based, in part,
|
|
on the work of the FreeType team.
|
|
|
|
AES encryption/decryption for PDF (C) 2001, Dr Brian Gladman, Worcester, UK.
|
|
|
|
The JPEG 2000 image read and write capability of the Nuance OmniPage Capture
|
|
SDK was developed using the Kakadu software.
|
|
|
|
The language dictionary support of the Nuance OmniPage Capture SDK is partly
|
|
from Proximity. The Proximity Dictionaries (C) 2000, all rights reserved
|
|
Proximity Technology, Inc.
|
|
|
|
Slovenian Speller Database, Copyright (C) 2002 Amebis d.o.o.
|
|
|
|
Esperanto dictionary based on compilation by Toon Witkam and Stefan MacGill.
|
|
|
|
The language dictionary support of the Nuance OmniPage Capture SDK is partly
|
|
from Vantage Research.
|
|
|
|
Asian OCR capabilities in the Nuance OmniPage Capture SDK are jointly
|
|
developed by the Beijing Wintone Information Technology Corporation Ltd and
|
|
Nuance Communications, Inc. All rights reserved.
|
|
|
|
International Components for Unicode (ICU) project Copyright (c) 1995-2009
|
|
International Business Machines Corporation and others.
|