dox/dev_guides/building/automake.md

   1 Building with Automake {#dev_guides__building__automake}
   2 ======================
   3
   4 This file describes steps to build OCCT libraries from complete source
   5 archive on Linux with GNU build system (Autotools).
   6
   7 If you are building 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 dev_guides__building__wok for instructions.
  10
  11 Before building OCCT, you need to install required third-party libraries; see paragraph 1 of
  12 \ref dev_guides__building for instructions.
  13
  14 Note that during compilation by makefiles on some Linux OS on a 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 /usr/X11R6/lib and places this library libGL.so in
  18 directory /usr/lib. However, libtool expects to find the library in directory
  19 /usr/X11R6/lib, which causes compilation crash (See /usr/X11R6/lib/libGLU.la).
  20
  21 To prevent this, suggest making links:
  22
  23  ln -s /usr/lib/libGL.so /usr/X11R6/lib/libGL.so
  24  ln -s /usr/lib/libGL.la /usr/X11R6/lib/libGL.la
  25
  26   1.In OCCT root folder, launch build_configure script
  27
  28    This will 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
  31    makefiles.
  32
  33    $CASROOT/configure \<FLAGS\>
  34
  35    Where \<FLAGS\> is a set of options.
  36    The following flags are mandatory:
  37
  38    * --with-tcl=  defines location of tclConfig.sh
  39    * --with-tk=  defines location of tkConfig.sh
  40    * --with-freetype=  defines location of installed FreeType product
  41    * --prefix= defines location for the installation of OCCT binaries
  42
  43    Additional flags:
  44
  45    * --with-gl2ps=  defines location of installed gl2ps product
  46    * --with-freeimage=  defines location of installed FreeImage product
  47    * --with-tbb-include= defines location of tbb.h
  48    * --with-tbb-library=  defines location of libtbb.so
  49    * --with-opencl-include= defines location of cl.h
  50    * --with-opencl-library= defines location of libOpenCL.so
  51    * --enable-debug=       yes: includes debug information, no: does not include debug information
  52    * --enable-production=   yes: switches code optimization, no: switches off code optimization
  53    * --disable-draw - allows OCCT building without Draw.
  54
  55    If location of FreeImage, TBB, gl2ps or OpenCL is not specified, OCCT will be
  56    built without these optional libraries.
  57
  58
  59    Attention: 64-bit platforms are detected automatically.
  60
  61    Example:
  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-opencl-include=/PRODUCTS/opencl-icd-1.2.11.0/include --with-opencl-library=/PRODUCTS/opencl-icd-1.2.11.0/lib
  64
  65   3.If configure exits successfully, you can build OCCT with make command.
  66
  67    > make -j8 install
  68
  69 To start DRAW, launch
  70
  71    > draw.sh