Building vtkContainers

Procedure (POSIX environments)

Setup
1. Get your kit together. You'll need the following.
  - CMake >= 2.0, Cross-platform build tool
  - VTK >= 4.5.0, The Visualization Toolkit
2. Acquire the latest vtkContainers source release
  $ mozilla http://sourceforge.net/projects/vtkcontainers/
3. Unpack the vtkContainers source archive
  $ gzip -dc vtkContainers-0.1.0.tgz | tar -xvf -
4. Create the build directory (out-of-source builds are preferred)
  $ mkdir vtkContainers-build $ cd vtkContainers-build
Prepare
- using Installed CMake and VTK
  Simply ensure installation of a cmake executable and the VTK libraries.
- using Built, but not installed, CMake and VTK (example code illustrates both csh and bash usage)
  
  Locate the CMake executable.
  
  csh $ setenv CMAKE_EXE ../kitware/cmake-2.0.6-build/bin/cmake
  
  bash$ export CMAKE_EXE=../kitware/cmake-2.0.6-build/bin/cmake
  
  Locate the VTK (build) directory.
  
  csh $ setenv VTK_DIR /usr/local/src/VTK-build
  
  bash$ export VTK_DIR=/usr/local/src/VTK-build
  
  Locate the vtkContainers (source) directory.
  
  csh $ setenv vtkContainers_SOURCE_DIR ../vtkContainers-0.1.0
  
  bash$ export vtkContainers_SOURCE_DIR=../vtkContainers-0.1.0
  
  Optionally, toggle generation of developer documentation.
  
  csh $ setenv BUILD_DOCUMENTATION ON
  
  bash$ export BUILD_DOCUMENTATION=ON
  
  Optionally, specify the build type (Debug | DebWithRelInfo | Release | ...).
  
  csh $ setenv CMAKE_BUILD_TYPE Debug
  
  bash$ export CMAKE_BUILD_TYPE=Debug
Configure
- using Installed CMake and VTK
  $ cmake ../vtkContainers-0.1.0
- using Built, but not installed, CMake and VTK
  $ ${CMAKE_EXE} \ -DVTK_DIR:PATH=${VTK_DIR} \ -DBUILD_DOCUMENTATION:BOOL=${BUILD_DOCUMENTATION} \ -DCMAKE_BUILD_TYPE:STRING=${CMAKE_BUILD_TYPE} \ ${vtkContainers_SOURCE_DIR}
Build
1. Calculate dependencies and currency.
  $ make depend
2. Create the binaries.
  $ make
3. Optionally, generate the developer documentation.
  $ cd ./Utilities/Doxygen
  $ make DoxygenDoc
Install (optional)
1. Install the binaries and header files.
  $ make install
2. Optionally, install the developer documentation.
  $ cd ./Utilities/Doxygen
  $ make InstallDoxygenDoc

Summary (POSIX environments)

using Installed CMake and VTK

tar -xzvf vtkContainers-0.1.0.tgz
mkdir vtkContainers-build
cd vtkContainers-build
cmake ../vtkContainers-0.1.0
make depend
make
make install

using Built, but not installed, CMake and VTK

tar -xzvf vtkContainers-0.1.0.tgz
mkdir vtkContainers-build
cd vtkContainers-build
.../bin/cmake -DVTK_DIR:PATH=/.../VTK-build .../vtkContainers-0.1.0
make depend
make
make install

Procedure (Windows environments)

Get your kit together. You'll need the following.
- CMake >= 2.0, Cross-platform build tool
- VTK >= 4.5.0, The Visualization Toolkit
Acquire the latest vtkContainers source release from http://sourceforge.net/projects/vtkcontainers/
Unpack the vtkContainers source archive
vtkContainers-0.1.0.zip
Create the build folder (out-of-source builds are preferred)
vtkContainers-build
Build (and optionally install) the VTK libraries.
Execute CMakeSetup. This will pop-up a little GUI that allows you to tailor the build. It then starts building .dsw and/or .sln files for Microsoft, or makefiles for Borland. You'll have to tell CMakeSetup where to find the VTK build (or install) sources via the VTK_DIR variable. Additionally, you'll have to tell CMakeSetup where you've placed your vtkContainers source code (e.g. vtkContainers-0.1.0), and where to build the object code and dll's (e.g. vtkContainers-0.1.0-build).
When CMakeSetup completes, start up msdev or devenv and load vtkContainers.dsw or vtkContainers.sln (in the vtkContainers build folder). Select ALL_BUILD project, and build it.

Building vtkContainers (release 0.1.0)

$Id: Building.html,v 1.1.1.1 2005/06/17 03:24:08 xpxqx Exp $