dox/dev_guides/building/automake.md

   1 Building with Automake {#occt_dev_guides__building_automake}
   2 ======================
   3
   4 This file describes steps to build OCCT libraries from a complete source
   5 archive on Linux with **Autotools** GNU build system.
   6
   7 If you build OCCT from bare sources (as in Git repository), or do some
   8 changes affecting CDL files, you need to use WOK to re-generate header files
   9 and build scripts / projects. See paragraph 1 \ref occt_dev_guides__building_wok for instructions.
  10
  11 Before building OCCT, you need to install the required third-party libraries; see paragraph 1 of
  12 \ref occt_dev_guides__building for instructions.
  13
  14 Note that during compilation by makefiles on Linux station with
  15 NVIDIA video card you may experience problems because the installation
  16 procedure of NVIDIA video driver removes library *libGL.so* included in package
  17 *libMesaGL* from directory <i>/usr/X11R6/lib</i> and places this library *libGL.so* in
  18 directory <i>/usr/lib</i>. However, *libtool* expects to find the library in directory
  19 <i>/usr/X11R6/lib</i>, which causes compilation crash (See <i>/usr/X11R6/lib/libGLU.la </i>).
  20
  21 To prevent this, it is suggested to make links:
  22
  23
  24         ln -s /usr/lib/libGL.so /usr/X11R6/lib/libGL.so
  25         ln -s /usr/lib/libGL.la /usr/X11R6/lib/libGL.la
  26
  27
  28   1.In OCCT root folder, launch *build_configure* script to generate files *configure* and *Makefile.in* for your system.
  29
  30   2.Go to the directory, where OCCT will be built, and run *configure* to generate makefiles.
  31
  32
  33         $CASROOT/configure \<FLAGS\>
  34
  35    Where <i> \<FLAGS\> </i> is a set of options.
  36    The following flags are mandatory:
  37
  38    * <i> --with-tcl= </i> defines the location of *tclConfig.sh*;
  39    * <i> --with-tk= </i> defines location of *tkConfig.sh*;
  40    * <i> --with-freetype= </i> defines location of installed **FreeType** product
  41    * <i> --prefix= </i> defines the location for installation of OCCT binaries
  42
  43    Additional flags:
  44
  45    * <i> --with-gl2ps= </i> defines the location of installed **gl2ps** product;
  46    * <i> --with-freeimage= </i> defines the location of installed **FreeImage** product;
  47    * <i> --with-tbb-include= </i> defines the location of *tbb.h*;
  48    * <i> --with-tbb-library= </i> defines the location of *libtbb.so*;
  49    * <i> --with-vtk-include= </i> defines the location of VTK includes;
  50    * <i> --with-vtk-library= </i> defines the location of VTK libraries;
  51    * <i> --enable-debug=   yes: </i>  includes debug information, no: does not include debug information;
  52    * <i> --enable-production=   yes: </i> switches code optimization, no: switches off code optimization;
  53    * <i> --disable-draw </i> allows OCCT building without Draw.
  54
  55    If location of **FreeImage, TBB, gl2ps** or **VTK** is not specified, OCCT will be built without these optional libraries.
  56
  57
  58   Attention: 64-bit platforms are detected automatically.
  59
  60   Example:
  61
  62
  63   \>  ./configure -prefix=/PRODUCTS/occt-6.5.5 --with-tcl=/PRODUCTS/tcltk-8.5.8/lib --with-tk=/PRODUCTS/tcltk-8.5.8/lib --with-freetype=/PRODUCTS/freetype-2.4.10 --with-gl2ps=/PRODUCTS/gl2ps-1.3.5 --with-freeimage=/PRODUCTS/freeimage-3.14.1 --with-tbb-include=/PRODUCTS/tbb30_018oss/include --with-tbb-library=/PRODUCTS/tbb30_018oss/lib/ia32/cc4.1.0_libc2.4_kernel2.6.16.21 --with-vtk-include=/PRODUCTS/VTK-6.1.0/include/vtk-6.1 -with-vtk-library=/PRODUCTS/ /VTK-6.1.0//lib
  64
  65
  66   3.If configure exits successfully, you can build OCCT with *make* command.
  67
  68   \> make -j8 install
  69
  70   4.To start *DRAW*, launch
  71
  72   \> draw.sh