OpenCascade/occt
1
0
Fork 0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-04 18:06:22 +03:00
Code Packages Releases Activity
occt/dox/dev_guides/building/3rdparty/3rdparty_linux.md
isz 18006a0f10 0025343: Visualization - Update user's guide and DRAW commands description 
Redesign of Visualisation user guide's structure with some changes in the guide.
Update Draw_test_harness user guide. Added dimension commands to DRAW test harness.
Update of prerequisites and building 3rd party tools sections
Move VIS draw tests to Draw Test Harness section.

Additionally, fix bugs 24117 and 25353.
Correct output of new imaged in PDF in modeling algos guide and errors introduced by bug 24699 in the overview.
2014-11-05 17:44:03 +03:00

7.5 KiB
Raw Blame History

Building 3rd-party libraries on 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/Tk 8.5 - 8.6;  
    • FreeType 2.4.10 - 2.5.3;
  • Optional products:
    • TBB 3.x - 4.x;
    • gl2ps 1.3.5 - 1.3.8;
    • FreeImage 3.14.1 - 3.16.0;
    • VTK 6.1.0.

@section dev_guides__building_3rdparty_linux_2 Building Mandatory Third-party Products

@subsection dev_guides__building_3rdparty_linux_2_1 Tcl/Tk

Tcl/Tk is required for DRAW test harness.

@subsubsection dev_guides__building_3rdparty_linux_2_1_2 Installation from sources: Tcl

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 Tcl source files are located (TCL_SRC_DIR).

    cd TCL_SRC_DIR/unix

  2. 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.

  3. If the configure command has finished successfully, start the building process:

    make

  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

    make install

@subsubsection dev_guides__building_3rdparty_linux_2_1_3 Installation from sources: Tk

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 Tk source files are located (TK_SRC_DIR)

    cd TK_SRC_DIR/unix

  2. 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.

  3. If the configure command has finished successfully, start the building process:

    make

  4. 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

@subsection dev_guides__building_3rdparty_linux_2_2 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.

  1. Enter the directory where the source files of FreeType are located (FREETYPE_SRC_DIR).

    cd FREETYPE_SRC_DIR

  2. 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.

  3. If the configure command has finished successfully, start the building process:

    make

  4. 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

@section dev_guides__building_3rdparty_linux_3 Building Optional Third-party Products

@subsection dev_guides__building_3rdparty_linux_3_1 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.

@subsection dev_guides__building_3rdparty_linux_3_2 gl2ps

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

  1. Install or build cmake product from the source file.

  2. 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

  3. Start the building of gl2ps:

    make

  4. Start the installation of gl2ps. Binaries will be installed according to the CMAKE_INSTALL_PREFIX option.

    make install

@subsection dev_guides__building_3rdparty_linux_3_3 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.

  1. Modify FREEIMAGE_SRC_DIR/Source/OpenEXR/Imath/ImathMatrix.h: In line 60 insert the following:

    #include string.h

  2. Enter the directory where the source files of FreeImage are located (FREEIMAGE_SRC_DIR).

    cd FREEIMAGE_SRC_DIR

  3. Run the building process

    make

  4. 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

  5. Clean temporary files

     make clean

@subsection dev_guides__building_3rdparty_linux_3_4 VTK

You can download VTK sources from http://www.vtk.org/VTK/resources/software.html

The building procedure:

Download the necessary archive from http://www.vtk.org/VTK/resources/software.html and unpack it.

  1. Install or build cmake product from the source file.

  2. Start cmake in GUI mode with the directory where the source files of VTK are located:

    ccmake VTK_SRC_DIR
    • Press [c] to make the initial configuration
    • Define the necessary options in VTK_INSTALL_PREFIX
    • Press [c] to make the final configuration
    • Press [g] to generate Makefile and exit

  3. Start the building of VTK:

    make

  4. Start the installation of gl2ps. Binaries will be installed according to the VTK_INSTALL_PREFIX option.

    make install