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.