Open CASCADE Technology  7.3.1.dev
Building with Code::Blocks

General

This file describes steps to build OCCT libraries from sources using Code::Blocks, a cross-platform IDE, using project files generated by OCCT legacy tool genproj. It can be used as an alternative to CMake build system (see Building with CMake) for all supported platforms.

Third-party libraries

Before building OCCT, make sure to have all the needed third-party libraries installed, see Building OCCT from sources.

Configuration

Before building it is necessary to set up build environment.

The environment is defined in the file custom.sh (on Linux and OS X) or custom.bat (on Windows) which can be edited directly:

  • Add paths to includes of used third-party libraries in variable CSF_OPT_INC.
  • Add paths to their binary libraries in variable CSF_OPT_LIB64.
  • Set variable SHORTCUT_HEADERS to specify a method for population of folder inc by header files. Supported methods are:
    • Copy - headers will be copied from src;
    • ShortCut - short-cut header files will be created, redirecting to same-named header located in src;
    • "HardLink* - hard links to headers located in src will be created.
  • For optional third-party libraries, set corresponding environment variable HAVE_<LIBRARY_NAME> to either false, e.g.:
    export HAVE_FREEIMAGE=false

Alternatively, or when custom.sh or custom.bat does not exist, you can launch genconf tool to configure environment interactively:

genconf_linux.png

Click "Save" to store the specified configuration in custom.sh or custom.bat file.

Projects generation

Launch genproj tool with option cbp to update content of inc folder and generate project files after changes in OCCT code affecting layout or composition of source files:

$ cd /dev/OCCT/opencascade-7.0.0
$ ./genproj cbp

The generated Code::Blocks project are placed into subfolder adm/<OS>/cbp.

Note
To use genproj and genconf tools you need to have Tcl installed and accessible by PATH.

Building

To start Code::Blocks, launch script codeblocks.sh.

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, run the script

./draw.sh cbp [d]

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