Getting Started with the LEADTOOLS Linux Libraries and Demo Projects

Native Dependencies

The following table shows all the third-party native dependencies used by LEADTOOLS. To determine which libraries require these dependencies, refer to the list at the end of this document. A table showing which LEADTOOLS library supports which features can be found here.

Notes

The LEADTOOLS OCR, Documents format readers, and Documents format writers modules will try to create fonts during their operation. If a needed font, such as "Arial" or "Times New Roman" is not found on the system, the module will substitute a different font. If an exact match for the module output between Windows and Linux is required, then the Microsoft Core Fonts component must be installed.

Ubuntu

Issue the following command to install the dependencies in Ubuntu:

sudo apt-get install uuid-dev uuid-runtime gcc g++ libc-dev-bin linux-libc-dev libx11-6 libx11-dev libxt6 libxt-dev sqlite3 libsqlite3-dev libfreetype6 fontconfig ttf-mscorefonts-installer 

Fedora

Issue the following command to install the dependencies in Fedora:

sudo dnf install uuid-devel uuidd gcc gcc-c++ glibc-devel kernel-devel kernel-headers libX11 libX11-devel libXt libXt-devel sqlite sqlite-devel freetype fontconfig  

Installing Microsoft True Type Core Fonts

Issue the following commands to install Microsoft TrueType Core Fonts:

sudo dnf install rpm-build cabextract ttmkfdir wget  
cd ~ && mkdir tmp && cd tmp  
wget http://corefonts.sourceforge.net/msttcorefonts-2.5-1.spec 
sudo rpmbuild -bb msttcorefonts-2.5-1.spec  
sudo dnf install /root/rpmbuild/RPMS/noarch/msttcorefonts-2.5-1.noarch.rpm  

CentOS

Installing Microsoft True Type Core Fonts

Issue the following command to install the dependencies in CentOS:

sudo yum install libmspack rpm-build ttmkfdir wget 

Download/install cabextract: https://centos.pkgs.org/7/epel-x86_64/cabextract-1.5-1.el7.x86_64.rpm.html

cd ~ && mkdir tmp && cd tmp 
wget "http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/c/cabextract-1.5-1.el7.x86_64.rpm" 
sudo rpm -i cabextract-1.5-1.el7.x86_64.rpm 

Download/install core fonts: https://corefonts.sourceforge.net/

wget "http://corefonts.sourceforge.net/msttcorefonts-2.5-1.spec" 
sudo rpmbuild -bb msttcorefonts-2.5-1.spec 
sudo rpm -ivh /root/rpmbuild/RPMS/noarch/msttcorefonts-2.5-1.noarch.rpm 

Java Dependencies

Install the Java Development Kit (JDK) and Java Runtimes (JRE). A table of LEADTOOLS JAR files and their native dependencies can be found here.

Ubuntu

Issue the following command to install the Java Development Kit and Java Runtimes in Ubuntu:

sudo apt-get install openjdk-8-jre openjdk-8-jdk 

Fedora

Issue the following command to install the Java Development Kit and Java Runtimes in Fedora:

sudo dnf install java-1.8.0-openjdk java-1.8.0-openjdk-devel 

Building and Running LEADTOOLS Demos

Setting a Runtime License

LEADTOOLS requires a runtime license file and developer key.
For more information see Setting a Runtime License

Eclipse (Java & C/C++)

1. In Eclipse, go to the File menu and select Import. From the Import dialog, select General and then select Existing Projects into Workspace. Click Next.

   

2. In the Import Projects dialog box, select Select root directory and then click Browse. Go to the location where the toolkit is installed (/home/user/LEADTOOLS21), and browse for the demo to be used, click OK, and then click Finish.

   

3. Go to Project Explorer, select the imported project, right-click the project, and select Properties, then click Run/Debug Settings -> New -> OK.

   

4. This demo is a console application: as a result, you need to pass the parameters into the Arguments tab from the Run Configuration dialog.

   

5. For the C demos, set a path for the executable to search for the LEADTOOLS libraries at runtime. There are two ways to do this (use either one).

   • Set the LD_LIBRARY_PATH variable.
     

     
     
     

   • Set the rpath of the executable as follows: Go to Project > Properties > C/C++ Build > Settings > Miscellaneous > Other options and add

   -rpath “/home/user/LEADTOOLS21/Bin/Lib/<platform>”
   

6. Build the project and run it.

Make (C/C++)

As an alternative to using Eclipse for the C demos, LEAD also ships standalone make files. Perform the following steps to use make files

1. Navigate to the “LEADTOOLS21/Examples/Linux/C” directory on a terminal. This will build all demos.

   NOTE: The make file sets the rpath for each demo executable to the absolute path of the /home/user/LEADTOOLS21/Bin/Lib/<arch>. See /home/user/LEADTOOLS21/Examples/Linux/C/common.mk

   cd ~/LEADTOOLS21/Examples/Linux/C  
   make 

2. The excutable will be built to /home/user/LEADTOOLS21/Bin/Lib/<arch>.

3. For example, to run the barcode demo use the following command:

   ~/LEADTOOLS21/Examples/Linux/C$ ../../../Bin/Lib/x86/Barcode -i /home/test/LEADTOOLS21/Images/barcode1.tif 

Library Dependencies