dox/dev_guides/building/code_blocks.md

   1 Building with Code::Blocks on Mac OS X {#occt_dev_guides__building_code_blocks}
   2 ======================================
   3
   4 This file describes steps to build OCCT libraries from a complete source package
   5 on Mac OS X with **Code::Blocks**.
   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 \ref occt_dev_guides__building_wok for instructions.
  10
  11 Before building OCCT, you need to install the required third-party libraries; see
  12 paragraph 1 of \ref occt_dev_guides__building for details.
  13
  14 1. Add paths to the mandatory 3rd-party products (**Tcl/Tk** and **FreeType**) in file
  15    *custom.sh* located in <i>\<OCCT_ROOT_DIR\></i>. For this:
  16
  17    1.1. Add paths to the includes in variable *CSF_OPT_INC*;
  18
  19    1.2. Add paths to the binary libraries in variable  *CSF_OPT_LIB64*;
  20
  21    All paths should be separated by ":" symbol.
  22
  23 2. Add paths to the optional 3rd-party libraries (**TBB, gl2ps** and **FreeImage**)
  24    in the aforementioned environment variables *CSF_OPT_INC* and
  25    *CSF_OPT_LIB64* from file *custom.sh*.
  26
  27    If you want to build OCCT without the optional libraries perform the
  28    following steps:
  29
  30    2.1 Disable unnecessary library in custom.sh by setting the corresponding
  31        variable <i>HAVE_\<LIBRARY_NAME\></i> to *false*.
  32
  33 ~~~~~
  34 export HAVE_GL2PS=false
  35 ~~~~~
  36
  37    2.2 Remove this library from Linker settings in **Code::Blocks** for each project
  38        that uses it: right click on the required project, choose **Build options**,
  39        go to **Linker settings** tab in the opened window , select unnecessary
  40        libraries and click **Delete** button.
  41
  42 3. Open Terminal application
  43
  44 4. Enter <i> \<OCCT_ROOT_DIR\></i>:
  45
  46 ~~~~~
  47    cd \<OCCT_ROOT_DIR\>
  48 ~~~~~
  49
  50 5. To start **Code::Blocks**, run the command <i>/codeblocks.sh</i>
  51
  52 6. To build all toolkits, click **Build->Build workspace** in the menu bar.
  53
  54
  55 To start *DRAWEXE*, which has been built with **Code::Blocks** on Mac OS X, perform
  56 the following steps:
  57
  58 1.Open Terminal application
  59
  60 2.Enter <i>\<OCCT_ROOT_DIR\></i>:
  61
  62 ~~~~~
  63    cd \<OCCT_ROOT_DIR\>
  64 ~~~~~
  65
  66 3.Run the script
  67 ~~~~~
  68    ./draw_cbp.sh cbp [d]
  69 ~~~~~
  70    Option *d* is used if OCCT has been built in **Debug** mode.