1
0
mirror of https://git.dev.opencascade.org/repos/occt.git synced 2025-04-03 17:56:21 +03:00
occt/dox/dev_guides/building/code_blocks.md
omy ba06f8bbee 0024722: Move functionality of WOK command wgendoc to OCCT tool gendoc
Command gendoc improved to:
- generate Reference Manual documentation (OCCT classes reference) with option -refman; option -overview can be used for generation of overview documentation;
- generate PDF documents for all User Guides automatically (for files listed in FILES_PDF.txt);
- check availability of third-party tools (Doxygen, Inkscape etc.) and properly report warnings and errors.
- use templates of configuration files for third-party tools instead of their generation. These template files are located in dox/resources folder

Tcl scripts are moved from dox folder to adm.
Doxygen warnings are eliminated.
Moved all auxilary functions to occaux.tcl.
Fixed Reference manual generation on *nix platform.
Fixed PDF generation on *nix platforms.
2014-04-10 19:21:16 +04:00

2.1 KiB

Building with Code::Blocks on Mac OS X

This file describes steps to build OCCT libraries from complete source package on Mac OS X with Code::Blocks.

If you are building OCCT from bare sources (as in Git repository), or do some changes affecting CDL files, you need to use WOK to re-generate header files and build scripts / projects. See \ref occt_dev_guides__building_wok for instructions.

Before building OCCT, you need to install required third-party libraries; see paragraph 1 of \ref occt_dev_guides__building for details.

  1. Add paths to the mandatory 3rd-party products (Tcl/Tk and FreeType) in file custom.sh located in <OCCT_ROOT_DIR>. For this:

    1.1. Add paths to the includes in variable "CSF_OPT_INC";

    1.2. Add paths to the binary libraries in variable "CSF_OPT_LIB64";

    All paths should be separated by ":" symbol.

  2. Add paths to the optional 3rd-party libraries (TBB, gl2ps and FreeImage) in the aforementioned environment variables "CSF_OPT_INC" and "CSF_OPT_LIB64" from file custom.sh.

    If you want to build OCCT without the optional libraries perform the following steps:

    2.1 Disable unnecessary library in custom.sh by setting the corresponding variable HAVE_<LIBRARY_NAME> to "false".

    export HAVE_GL2PS=false
    

    2.2 Remove this library from Linker settings in Code::Blocks for each project that uses it: right click on the required project, choose "Build options", go to "Linker settings" tab in the opened window , select unnecessary libraries and click "Delete" button.

  3. Open Terminal application

  4. Enter <OCCT_ROOT_DIR>:

    cd <OCCT_ROOT_DIR>

  5. To start Code::Blocks, run the command /codeblocks.sh

  6. To build all toolkits, click "Build->Build workspace" in the menu bar.

To start DRAWEXE, which has been built with Code::Blocks on Mac OS X, perform the following steps:

  1. Open Terminal application

  2. Enter <OCCT_ROOT_DIR>:

    cd <OCCT_ROOT_DIR>

  3. Run script

    ./draw_cbp.sh cbp [d]

    Option "d" is used if OCCT has been built in Debug mode.