Open CASCADE Technology
Building with Code::Blocks


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.


Before building it is necessary to set up build environment.

The environment is defined in the file (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 or custom.bat does not exist, you can launch genconf tool to configure environment interactively:


Click "Save" to store the specified configuration in 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.

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


To start Code::Blocks, launch script

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

./ cbp [d]

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