mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-09 18:50:54 +03:00
e5bd0d984c
unrelated changes: Unused unit OpenCL removed from UDLIST All articles revised README revised comments are allowed in FILES.txt Add gendoc.sh for Linux Added option -s to set search engine of the HTML documents Added 3rdparty_building docs for different platforms help message removed from bat&sh scripts (left within tcl script) tableofcontents added for all huge articles; gendoc.bat doesn't change PATH variable jpgs converted to pngs and unused pngs removed logo displaying of pdf files fixed Automatic detection of OCCT version number added to occtdoc.tcl OCCT version within pdfs is got from Standard_Version.hxx; copyright changed pdf generation process removes latex dir now GIF images converted to PNG in technical_overview; references fixed (incorrect reference to wok and cdl didn't touch; redundant latex option removed Tutorial moved from Overview and made top level page LICENSE.md moved from dox/overview to dox folder Section related to OCCT building refactored and simplified. WOK and CDL explicitly declared as deprecated.
304 lines
8.9 KiB
Markdown
304 lines
8.9 KiB
Markdown
Building 3rd-party libraries on Linux {#dev_guides__building_3rdparty_linux}
|
||
============================================
|
||
@tableofcontents
|
||
|
||
@section dev_guides__building_3rdparty_linux_1 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 8.5, Tk 8.5, FreeType 2.4.10
|
||
* Optional products: TBB 3.x or 4.x, gl2ps 1.3.5, FreeImage 3.14.1
|
||
|
||
@section dev_guides__building_3rdparty_linux_2 Building Mandatory Third-party Products
|
||
|
||
@subsection dev_guides__building_3rdparty_linux_2_1 Tcl/Tk 8.5
|
||
|
||
Tcl/Tk is required for DRAW test harness. Version 8.5 or 8.6 can be used with OCCT.
|
||
|
||
@subsubsection dev_guides__building_3rdparty_linux_2_1_1 Installation from binaries
|
||
|
||
It is possible to download ready-to-install binaries from
|
||
http://www.activestate.com/activetcl/downloads
|
||
|
||
* 1. Download the binaries archive and unpack them to some TCL_SRC_DIR.
|
||
* 2. Enter the directory TCL_SRC_DIR.
|
||
|
||
@verbatim
|
||
cd TCL_SRC_DIR
|
||
@endverbatim
|
||
|
||
* 3. Run the install command
|
||
|
||
@verbatim
|
||
install.sh
|
||
@endverbatim
|
||
|
||
and follow instructions.
|
||
|
||
@subsubsection dev_guides__building_3rdparty_linux_2_1_2 Installation from sources: Tcl 8.5
|
||
|
||
Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it.
|
||
|
||
* 1. Enter the unix sub-directory of the directory where the source files of Tcl are located (TCL_SRC_DIR).
|
||
|
||
@verbatim
|
||
cd TCL_SRC_DIR/unix
|
||
@endverbatim
|
||
|
||
* 2. Run the configure command
|
||
|
||
@verbatim
|
||
configure --enable-gcc --enable-shared --enable-threads --prefix=TCL_INSTALL_DIR
|
||
@endverbatim
|
||
|
||
For a 64 bit platform also add --enable-64bit option to the command line.
|
||
|
||
* 3. If the configure command has finished successfully, start the building process
|
||
|
||
@verbatim
|
||
make
|
||
@endverbatim
|
||
|
||
* 4. 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
|
||
|
||
@verbatim
|
||
make install
|
||
@endverbatim
|
||
|
||
@subsubsection dev_guides__building_3rdparty_linux_2_1_3 Installation from sources: Tk 8.5
|
||
|
||
Download the necessary archive from http://www.tcl.tk/software/tcltk/download.html and unpack it.
|
||
|
||
* 1. Enter the unix sub-directory of the directory where the source files of Tk are located (TK_SRC_DIR).
|
||
|
||
@verbatim
|
||
cd TK_SRC_DIR/unix
|
||
@endverbatim
|
||
|
||
* 2. Run the configure command, where TCL_LIB_DIR is TCL_INSTALL_DIR/lib
|
||
|
||
@verbatim
|
||
configure --enable-gcc --enable-shared --enable-threads --with-tcl=TCL_LIB_DIR --prefix=TK_INSTALL_DIR
|
||
@endverbatim
|
||
|
||
where TCL_LIB_DIR is TCL_INSTALL_DIR/lib
|
||
|
||
For a 64 bit platform also add --enable-64bit option to the command line.
|
||
|
||
* 3. If the configure command has finished successfully, start the building process
|
||
|
||
@verbatim
|
||
make
|
||
@endverbatim
|
||
|
||
* 4. If 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 TK_INSTALL_DIR is TCL_INSTALL_DIR)
|
||
|
||
@verbatim
|
||
make install
|
||
@endverbatim
|
||
|
||
@subsection dev_guides__building_3rdparty_linux_2_2 FreeType 2.4.10
|
||
|
||
FreeType is required for display of text in 3D viewer.
|
||
Download the necessary archive from http://sourceforge.net/projects/freetype/files/ and unpack it.
|
||
|
||
* 1. Enter the directory where the source files of FreeType are located (FREETYPE_SRC_DIR).
|
||
|
||
@verbatim
|
||
cd FREETYPE_SRC_DIR
|
||
@endverbatim
|
||
|
||
* 2. Run the configure command
|
||
|
||
@verbatim
|
||
configure --prefix=FREETYPE_INSTALL_DIR
|
||
@endverbatim
|
||
|
||
For a 64 bit platform also add CFLAGS='-m64 -fPIC' CPPFLAGS='-m64 -fPIC' option to the command line.
|
||
|
||
* 3. If the configure command has finished successfully, start the building process
|
||
|
||
@verbatim
|
||
make
|
||
@endverbatim
|
||
|
||
* 4. If 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
|
||
|
||
@verbatim
|
||
make install
|
||
@endverbatim
|
||
|
||
@section dev_guides__building_3rdparty_linux_3 Building Optional Third-party Products
|
||
|
||
@subsection dev_guides__building_3rdparty_linux_3_1 TBB 3.x or 4.x
|
||
|
||
This third-party product is installed with binaries from the archive that can be downloaded from http://threadingbuildingblocks.org.
|
||
Go to \"Downloads page\", find the release version you need (e.g. tbb30_018oss) and pick the archive for Linux platform.
|
||
To install, unpack the downloaded archive of TBB 3.0 product (*tbb30_018oss_lin.tgz*).
|
||
|
||
@subsection dev_guides__building_3rdparty_linux_3_2 gl2ps 1.3.5
|
||
|
||
Download the necessary archive from http://geuz.org/gl2ps/ and unpack it.
|
||
|
||
* 1. Install or build cmake product from source file.
|
||
* 2. Start cmake in GUI mode with the directory where the source files of gl2ps are located:
|
||
@verbatim
|
||
ccmake GL2PS_SRC_DIR
|
||
@endverbatim
|
||
* 2.1. Press [c] to make the initial configuration
|
||
* 2.2. Define the necessary options CMAKE_INSTALL_PREFIX
|
||
* 2.3. Press [c] to make the final configuration
|
||
* 2.4. Press [g] to generate Makefile and exit
|
||
|
||
or just run the following command:
|
||
|
||
@verbatim
|
||
cmake –DCMAKE_INSTALL_PREFIX=GL2PS_INSTALL_DIR –DCMAKE_BUILD_TYPE=Release
|
||
@endverbatim
|
||
|
||
* 3. Start building of gl2ps
|
||
|
||
@verbatim
|
||
make
|
||
@endverbatim
|
||
|
||
* 4. Start the installation of gl2ps. Binaries will be installed according to the CMAKE_INSTALL_PREFIX option
|
||
|
||
@verbatim
|
||
make install
|
||
@endverbatim
|
||
|
||
@subsection dev_guides__building_3rdparty_linux_3_3 FreeImage 3.14.1
|
||
|
||
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.
|
||
|
||
* 1. Modify FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h:
|
||
In line 60 insert the following:
|
||
|
||
@verbatim
|
||
#include string.h
|
||
@endverbatim
|
||
|
||
* 2. Enter the directory where the source files of FreeImage are located (FREEIMAGE_SRC_DIR).
|
||
|
||
@verbatim
|
||
cd FREEIMAGE_SRC_DIR
|
||
@endverbatim
|
||
|
||
* 3. Run the building process
|
||
|
||
@verbatim
|
||
make
|
||
@endverbatim
|
||
|
||
* 4. Run the installation process
|
||
* 4.1. If you have permissions to write to /usr/include and /usr/lib directories then run the following command:
|
||
@verbatim
|
||
make install
|
||
@endverbatim
|
||
* 4.2. If you don’t have permissions to write to /usr/include and
|
||
/usr/lib directories then you need to modify the file FREEIMAGE_SRC_DIR/Makefile.gnu:
|
||
|
||
Change lines 7-9 from:
|
||
|
||
@verbatim
|
||
DESTDIR ?= /
|
||
INCDIR ?= $(DESTDIR)/usr/include
|
||
INSTALLDIR ?= $(DESTDIR)/usr/lib
|
||
@endverbatim
|
||
|
||
to:
|
||
|
||
@verbatim
|
||
DESTDIR ?= $(DESTDIR)
|
||
INCDIR ?= $(DESTDIR)/include
|
||
INSTALLDIR ?= $(DESTDIR)/lib
|
||
@endverbatim
|
||
|
||
Change lines 65-67 from:
|
||
|
||
@verbatim
|
||
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)
|
||
@endverbatim
|
||
|
||
to:
|
||
|
||
@verbatim
|
||
install -m 755 $(HEADER) $(INCDIR)
|
||
install -m 755 $(STATICLIB) $(INSTALLDIR)
|
||
install -m 755 $(SHAREDLIB) $(INSTALLDIR)
|
||
@endverbatim
|
||
|
||
Change line 70 from:
|
||
|
||
@verbatim
|
||
ldconfig
|
||
@endverbatim
|
||
|
||
to:
|
||
|
||
@verbatim
|
||
\#ldconfig
|
||
@endverbatim
|
||
|
||
Then run the installation process by the following command:
|
||
|
||
@verbatim
|
||
make DESTDIR=FREEIMAGE_INSTALL_DIR install
|
||
@endverbatim
|
||
|
||
* 5. Clean the temporary files
|
||
|
||
@verbatim
|
||
make clean
|
||
@endverbatim
|
||
|
||
@section dev_guides__building_3rdparty_linux_4 Installation From Official Repositories
|
||
|
||
@subsection dev_guides__building_3rdparty_linux_4_1 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:
|
||
|
||
@verbatim
|
||
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
|
||
@endverbatim
|
||
|
||
To launch WOK-prebuilt binaries you need install C shell and 32-bit libraries on x86_64 distributives:
|
||
|
||
@verbatim
|
||
sudo apt-get install \
|
||
csh \
|
||
libstdc++5:i386 libxt6:i386
|
||
@endverbatim
|
||
|
||
Any compliant C++ compiler is required for building anyway:
|
||
|
||
@verbatim
|
||
sudo apt-get install \
|
||
g++ \
|
||
@endverbatim
|
||
|
||
@see http://www.opencascade.org for details
|