Update for building with MS Visual C++ without VTK 3rdparty products
[occt.git] / 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.