Introduction

This document presents additional guidelines for building third-party products used by Open CASCADE Technology and samples on Linux platform.

The links for downloading the third-party products are available on the web site of OPEN CASCADE SAS at http://www.opencascade.org/getocc/require/.

There are two types of third-party products, which are necessary to build OCCT:

Mandatory products:
- Tcl/Tk 8.5 - 8.6;
- FreeType 2.4.10 - 2.4.11;
Optional products:
- TBB 3.x - 4.x;
- gl2ps 1.3.5 - 1.3.8;
- FreeImage 3.14.1 - 3.15.4.

Building Mandatory Third-party Products

Tcl/Tk

Tcl/Tk is required for DRAW test harness.

Installation from binaries:

It is possible to download ready-to-install binaries from http://www.activestate.com/activetcl/downloads

Download the binaries archive and unpack them to a directory, which is further referred to as TCL_SRC_DIR.
Enter the directory TCL_SRC_DIR.
```
cd TCL_SRC_DIR
```
Run the install command:
```
install.sh
```
and follow the instructions.

Installation from sources: Tcl

Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it.

Enter the unix sub-directory of the directory where the Tcl source files are located (TCL_SRC_DIR).
```
cd TCL_SRC_DIR/unix   
```
Run the configure command:
```
configure --enable-gcc  --enable-shared --enable-threads --prefix=TCL_INSTALL_DIR   
```
For a 64 bit platform also add –enable-64bit option to the command line.
If the configure command has finished successfully, start the building process:
```
make   
```
If building is finished successfully, start the installation of Tcl. All binary and service files of the product will be copied to the directory defined by TCL_INSTALL_DIR
```
make install   
```

Installation from sources: Tk

Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it.

Enter the unix sub-directory of the directory where the Tk source files are located (TK_SRC_DIR)
```
cd TK_SRC_DIR/unix   
```
Run the configure command, where TCL_LIB_DIR is TCL_INSTALL_DIR/lib.
```
configure --enable-gcc  --enable-shared --enable-threads --with-tcl=TCL_LIB_DIR  --prefix=TK_INSTALL_DIR   
```
For a 64 bit platform also add –enable-64bit option to the command line.
If the configure command has finished successfully, start the building process:
```
make   
```
If the building has finished successfully, start the installation of Tk. All binary and service files of the product will be copied to the directory defined by TK_INSTALL_DIR (usually it is TCL_INSTALL_DIR)
```
make install   
```

FreeType

FreeType is required for text display in the 3D viewer. Download the necessary archive from http://sourceforge.net/projects/freetype/files/ and unpack it.

Enter the directory where the source files of FreeType are located (FREETYPE_SRC_DIR).
```
cd FREETYPE_SRC_DIR   
```
Run the configure command:
```
configure  --prefix=FREETYPE_INSTALL_DIR   
```
For a 64 bit platform also add CFLAGS='-m64 -fPIC' CPPFLAGS='-m64 -fPIC' option to the command line.
If the configure command has finished successfully, start the building process:
```
make   
```
If the building has finished successfully, start the installation of FreeType. All binary and service files of the product will be copied to the directory defined by FREETYPE_INSTALL_DIR
```
make install   
```

Building Optional Third-party Products

TBB

This third-party product is installed with binaries from the archive that can be downloaded from http://threadingbuildingblocks.org. Go to the Download page, find the release version you need and pick the archive for Linux platform. To install, unpack the downloaded archive of TBB product.

gl2ps

Download the necessary archive from http://geuz.org/gl2ps/ and unpack it.

Install or build cmake product from the source file.
Start cmake in GUI mode with the directory where the source files of gl2ps are located:
```
ccmake GL2PS_SRC_DIR   
```
- Press [c] to make the initial configuration;
- Define the necessary options in CMAKE_INSTALL_PREFIX
- Press [c] to make the final configuration
- Press [g] to generate Makefile and exit
or just run the following command:
```
cmake  –DCMAKE_INSTALL_PREFIX=GL2PS_INSTALL_DIR –DCMAKE_BUILD_TYPE=Release   
```
Start the building of gl2ps:
```
make   
```
Start the installation of gl2ps. Binaries will be installed according to the CMAKE_INSTALL_PREFIX option.
```
make install   
```

FreeImage

Download the necessary archive from http://sourceforge.net/projects/freeimage/files/Source%20Distribution/ and unpack it. The directory with unpacked sources is further referred to as FREEIMAGE_SRC_DIR.

Modify FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h: In line 60 insert the following:
```
#include string.h   
```
Enter the directory where the source files of FreeImage are located (FREEIMAGE_SRC_DIR).
```
cd FREEIMAGE_SRC_DIR   
```
Run the building process
```
make   
```

Run the installation process

a. If you have the permission to write into directories /usr/include and /usr/lib, run the following command:

   make install

b. If you do not have this permission, you need to modify file FREEIMAGE_SRC_DIR/Makefile.gnu:

Change lines 7-9 from:

DESTDIR ?= /   
INCDIR  ?= $(DESTDIR)/usr/include   
INSTALLDIR  ?= $(DESTDIR)/usr/lib

to:

DESTDIR  ?= $(DESTDIR)   
INCDIR  ?= $(DESTDIR)/include   
INSTALLDIR  ?= $(DESTDIR)/lib

Change lines 65-67 from:

install  -m 644 -o root -g root $(HEADER) $(INCDIR)   
install  -m 644 -o root -g root $(STATICLIB) $(INSTALLDIR)   
install  -m 755 -o root -g root $(SHAREDLIB) $(INSTALLDIR)

to:

install  -m 755 $(HEADER) $(INCDIR)   
install  -m 755 $(STATICLIB) $(INSTALLDIR)   
install  -m 755 $(SHAREDLIB) $(INSTALLDIR)

Change line 70 from:

ldconfig

to:

\#ldconfig

Then run the installation process by the following command:

 make DESTDIR=FREEIMAGE_INSTALL_DIR  install

Clean temporary files
```
 make clean   
```

OpenCL ICD Loader

If you have OpenCL SDK (one provided by Apple, AMD, NVIDIA, Intel, or other vendor) installed on your system, you should find OpenCL headers and libraries required for building OCCT inside that SDK.

Alternatively, you can use OpenCL ICD (Installable Client Driver) Loader provided by Khronos group. The following describes steps used to build OpenCL ICD Loader version 1.2.11.0.

Download OpenCL ICD Loader sources archive and OpenCL header files from Khronos OpenCL Registry http://www.khronos.org/registry/cl/
Unpack the archive and put headers in inc/CL sub-folder
Print make in the root of the unpacked archive to compile OpenCL libraries.
Create installation folder for OpenCL IDL Loader package and put there:
1. OpenCL header files in include/CL subfolder
2. libOpenCL.so (generated in bin subfolder of source package) in lib subfolder

Installation From Official Repositories

Debian-based distributives

All 3rd-party products required for building of OCCT could be installed from official repositories. You may install them from console using apt-get utility:

sudo apt-get install \   
tcllib tklib tcl-dev tk-dev \   
libfreetype-dev \   
libxt-dev libxmu-dev \   
libgl1-mesa-dev \   
libfreeimage-dev \   
libtbb-dev \   
libgl2ps-dev

To launch binaries built with WOK you need to install C shell and 32-bit libraries on x86_64 distributives:

sudo apt-get install \   
csh \   
libstdc++5:i386 libxt6:i386

Building is possible with any C++ compliant compiler :

sudo apt-get install \   
g++

Building 3rd-party libraries on Linux

Table of Contents