BBTK 0.9.0 (15/10/2008) build instructions
  1. Linux
    1. Requirements
    2. Known working configurations
    3. Install from sources
  2. Windows
    1. Requirements
    2. Known working configurations
    3. Steps
  3. CMake build options

Linux

Requirements

Known working configurations

  - gcc:
        4.3.0 (Fedora Core 9)
        4.2.0 (OpenSuse 10.3)
        4.1.2 20070925 (Red Hat 4.1.2-33)
        4.1.2 20070626 (Red Hat 4.1.2-13)
        4.1.1 20070105 (Red Hat 4.1.1-51)
        4.0.2 20051125 (Red Hat 4.0.2-8)
    - cmake:
        2.4-patch 6
   - wxGTK-devel:
        2.8.6
        2.6.3
   - InsightToolkit:
        3.4
        3.2
        2.8.1-5
   - vtk:
        5.0.3-1

Install from sources

    Uncompress the archive or checkout the source from the cvs repository
    In the parent folder of the bbtk sources type :
    > mkdir bbtkbin; cd bbtkbin
    > ccmake ../bbtk
    Check the desired options. See CMake build options for a description.

==> IMPORTANT NOTE :

    Type 'c' many times until no area is flagged with a '*' and three times more then type 'g', to generate.
    > make
    > sudo make install
   Enjoy !

Uninstall

    You can run bbtk-uninstall.sh as root.
    WARNING :
       This is a brute force **UNSAFE** uninstaller which removes all files and folders starting with 'bb' in :
        INSTALL-PREFIX/bin
        INSTALL-PREFIX/lib
        INSTALL-PREFIX/include
        INSTALL-PREFIX/share/bbtk
    However it lists the files found and prompts you before proceeding...



Windows

Requirements

Mandatory

Optional

Known working configurations

Steps

Enjoy !

CMake build options

The options in grey only appear if the last non grey option is set to ON (e.g. itk_IMAGE_DIM_2 and the following ones in grey only appear if BUILD_BBTK_PACKAGE_itk is ON).
The variables in dark grey and italics are NOT options but are automatically set by cmake according to the options selected. In particular the variables 'USE_something' indicate the dependencies on external libraries or utilities.
Advanced options are not shown here...

Option
Explaination
Default
--BUILD_ALL
Set to ON to build all the components of the toolkit
OFF
BBTK_COMPILE_DEBUG_MESSAGES Compile debug messages in bbtk ?
OFF
BBTK_COMPILE_ERROR_MESSAGES Compile error messages in bbtk ?
ON
BBTK_COMPILE_MESSAGES Compile normal messages in bbtk ?
ON
BBTK_COMPILE_WARNING_MESSAGES Compile warning messages in bbtk ?
ON
BBTK_USE_SHIPPED_BOOST
Use the boost C++ library provided with bbtk ?
If not set you need to have boost installed
ON
BBTK_USE_WXWIDGETS
Build with the wxWidgets library ?
ON
BUILD_APPLICATIONS
Build bbtk applications : development studio (bbStudio), interpreter (bbi), xml to C++ code (bbfy), etc. ?
ON
BUILD_BBS_APPLI_BINARIES
Build executables for all bbs applications of all packages ?
If set will compile all bbs of folder appli of all packages, using bbc
OFF
BUILD_BBTK_DOC
Build bbtk documentations ?
OFF
BUILD_BBTK_DOC_DOXYGEN
Build doxygen documentation for bbtk kernel?
Requires doxygen
ON
BUILD_BBTK_DOC_GUIDES_HTML
Build html versions of the guides ?
Requires latex, pdftex, tth
ON
BUILD_BBTK_DOC_GUIDES_PDF
Build pdf versions of the guides ?
Requires latex, pdftex
ON
BUILD_BBTK_DOC_PACKAGE
Build packages html documentations ?
ON
BUILD_BBTK_PACKAGE_demo
Build the package 'demo' ?
Requires : itk, vtk
OFF
BUILD_BBTK_PACKAGE_itk
Build the package 'itk' ?
Requires : itk
OFF
 BUILD_BBTK_PACKAGE_itkvtk
Build the package 'itkvtk ?
Requires : itk, vtk
OFF
BUILD_BBTK_PACKAGE_std
Build the package 'std' ? ON
BUILD_BBTK_PACKAGE_toolsbbtk
Build the package 'toolsbbtk' ? ON
BUILD_BBTK_PACKAGE_vtk
Build the package 'vtk' ?
Requires : vtk
ON
BUILD_BBTK_PACKAGE_wx
Build the package 'wx' ?
Requires : wxWidgets
ON
BUILD_BBTK_PACKAGE_wxvtk
Build the package 'wxvtk' ?
Requires : wxWidgets, vtk
ON
   itk_IMAGE_DIM_2
Compile itk images of dimension 2 ?
ON
   itk_IMAGE_DIM_3 Compile itk images of dimension 3 ?
ON
   itk_IMAGE_DIM_4 Compile itk images of dimension 4 ?
ON
   itk_IMAGE_TYPE_CHAR
Compile itk images of type char ?
ON
   itk_IMAGE_TYPE_DOUBLE Compile itk images of type double ?
ON
   itk_IMAGE_TYPE_FLOAT
Compile itk images of type float ?
ON
   itk_IMAGE_TYPE_INT
Compile itk images of type int ?
ON
   itk_IMAGE_TYPE_SHORT
Compile itk images of type short ?
ON
   itk_IMAGE_TYPE_UCHAR
Compile itk images of type unsigned char ?
ON
   itk_IMAGE_TYPE_UINT
Compile itk images of type unsigned int ?
ON
   itk_IMAGE_TYPE_USHORT
Compile itk images of type unsigned  short ?
ON
BUILD_BBTK_PACKAGE_demo Build the package 'demo' ?
Requires : ALL the other packages
OFF
BUILD_BBTK_PACKAGE_itkvtk
Build the package 'itkvtk' ?
Requires : itk, vtk
OFF
BUILD_BBTK_PACKAGE_std
Build the package 'std ? OFF
BUILD_BBTK_PACKAGE_toolsbbtk Build the package 'toolsbbtk' ? OFF
BUILD_BBTK_PACKAGE_vtk
Build the package 'vtk' ?
Requires : vtk
OFF
BUILD_BBTK_PACKAGE_wx
Build the package 'wx' ?
Requires : wxWidgets
OFF
BUILD_BBTK_PACKAGE_wxvtk
Build the package 'wxvtk' ?
Requires : wxWidgets, vtk
OFF
CMAKE_BUILD_TYPE
Set to "Debug" or "Release"
-
CMAKE_INSTALL_PREFIX
Set the install folder
/usr/local
EXECUTABLE_OUTPUT_PATH
Single output directory for building all the executables
-
LIBRARY_OUTPUT_PATH Single output directory for building all the libraries -
USE_BOOST
Automatically set to ON when boost C++ library is needed with the choices made
-
USE_DOXYGEN
Automatically set to ON when doxygen is needed with the choices made -
USE_ITK
Automatically set to ON when ITK library is needed with the choices made -
USE_LATEX
Automatically set to ON when LaTeX is needed with the choices made -
USE_TTH
Automatically set to ON when tth is needed with the choices made -
USE_VTK
Automatically set to ON when VTK library is needed with the choices made -
USE_WXWIDGETS
Automatically set to ON when wxWidgets library is needed with the choices made -