ManualBuild

Latest revision as of 07:31, 23 September 2014

For conformity purposes, save the FARSIGHT source code, QT, VXL, ITK, and VTK to C:\Lab (if possible). The following instructions will assume that the source codes will be saved in C:\Lab.

Build or install Qt

1. Build Qt from source. Download it from here: Windows Qt source code. Linux/Mac Qt source code.
2. Extract the zip file to C:\Lab (or the directory of your choosing).

For Visual Studio 2008/2010:

1. Go to Start->All Programs->Microsoft Visual Studio 2008->Visual Studio Tools->Visual Studio 2008 x64 Win64 Command Prompt
2. cd to the directory where you unzipped the QT source (Auto-complete key: tab)
   

   Go to the QT root directory in the Visual Studio 2008 x64 Win64 command prompt. This image shows how to change drives.
3. Run "configure -mp" (see figure below) (This should take about 5 minutes or more. Reading material as you wait.)
4. Run "nmake" Take a coffee break. This step will take at least 30 minutes.
   • If you made a mistake somewhere, you can start from scratch by typing "nmake confclean"

Download Boost

1. Download the Boost C++ libraries from the Boost download page.
   • Make sure you download the actual source file and not the documentation (The documentation will have pdf in its name.)
     

     Boost download page
2. Unzip it to C:\Lab (or a directory of your choosing).

You do not need to compile it.

Source Libraries Configuration

Build VXL

Download VXL by going to: (Start -> Git Bash in search box). Then type the following lines:

cd /c/Lab/VXL/source

git clone git://git.code.sf.net/p/vxl/git vxl-git .
git checkout d8aee93ce8bfc88765fff8ffe5c364d636be8a97

1. Run CMake.
2. Specify the source folder and binary folder.
3. Configure
4. Specify the generator for this project: Visual Studio 9 2008 Win64
5. (optional) For speed optimization in Visual Studio, append /MP to CMAKE_C_FLAGS and CMAKE_CXX_FLAGS as shown in the figure to the right.
   

   

   Multicore building VXL
6. Turn the following options OFF:
   • BUILD_BRL
   • BUILD_CONVERSIONS
   • BUILD_EXAMPLES
   • BUILD_GEL
   • BUILD_OUL
   • BUILD_OXL
   • BUILD_PRIP
   • BUILD_TBL
   • BUILD_TESTING
     

     

     CMake VXL
7. Turn the following options ON:
   • BUILD_RPL_RGTL
   • VNL_CONFIG_LEGACY_METHODS
   • VXL_FORCE_V3P_PNG (Mac ONLY)
8. Click configure and then turn the following option ON:
   • BUILD_RPL_RTVL (will show up in pink)
9. Configure again and then Generate
10. Go to the VXL binary folder and open the solution file (vxl.sln).
11. Go to the main menu bar: Build->Batch Build
12. Turn ON the following options under ALL_BUILD:
    • Debug|x64
    • Release|x64
      

      Batch Build VXL
13. Build
14. As you wait, play some Starcraft 2.

Build VTK

Download VTK by going to: (Start -> Git Bash in search box). Then type the following lines:

cd /c/Lab/VTK
git clone git://vtk.org/VTK.git Source
cd Source
git checkout v5.10.1

1. Run CMake.
2. Specify the source folder and the binary folder.
3. Configure
4. Specify the generator for this project: Visual Studio 9 2008 Win64
5. (optional) For speed optimization in Visual Studio, append /MP to CMAKE_C_FLAGS and CMAKE_CXX_FLAGS as shown in the figure to the right. The git version may have a CMAKE_CXX_MP_FLAG, in which case just check that and add your number of processors to CMAKE_CXX_MP_NUM_PROCESSORS.
   

   

   Multicore building VTK
6. Turn OFF the following options:
   • BUILD_DOCUMENTATION
   • BUILD_EXAMPLES
   • BUILD_SHARED_LIBS
   • BUILD_TESTING
7. Turn ON the following options:
   • VTK_USE_BOOST
   • VTK_USE_GUISUPPORT
   • VTK_USE_QT
8. Configure
9. Turn ON the following option:
   • VTK_USE_QTCHARTS
   • Set Boost_INCLUDE_DIR to the root of the Boost source tree.
10. Turn OFF the following option:
    • VTK_QT_USE_WEBKIT
11. Configure
    • An error may appear about QT_QMAKE_EXECUTABLE not being found. Simply provide the path to qmake.exe (should be <QT root directory>/bin/qmake.exe)
12. Generate
13. Go to the VTK binary folder and open the solution file (VTK.sln).
14. Go to the file toolbar: Build->Batch Build
    

    

    Batch Build VTK
15. Turn ON the following options under ALL_BUILD:
    • Debug|x64
    • Release|x64
16. Build
17. As you wait, take a nice long shower.

Build ITKv4

Download ITKv4 by going to: (Start -> Git Bash in search box). Then type the following lines:

cd /c/Lab/ITK

git clone git://itk.org/ITK.git Source
cd Source
git checkout v4.3.2

1. Run CMake.
2. Specify the source folder and binary folder.
3. Configure
4. Specify the generator for this project: Visual Studio 9 2008 Win64
5. An error will show up in the CMake log complaining about BUILD_TESTING being on.
6. (optional) For speed optimization in Visual Studio, append /MP to CMAKE_C_FLAGS and CMAKE_CXX_FLAGS as shown in the figure to the right.
   

   

   Multicore building ITKv4. Make sure you change the number according to the number of processors you have! (ie. /MP8)
7. Turn OFF the following:
   • BUILD_TESTING
   • BUILD_EXAMPLES
8. Configure again.
9. Turn ON the following:
   • ITKGroup_* or ITK_BUILD_ALL_MODULES
   • ITK_USE_64BITS_IDS
   • ITK_USE_REVIEW
   • ITK_USE_SYSTEM_VXL
   • Module_ITKVtkGlue
     • On the next Configure you will have to specify VTK_DIR and VXL_DIR.
10. Configure again and then Generate
11. Go to the ITK binary folder and open the solution file (ITK.sln).
12. Go to the file toolbar: Build->Batch Build
    

    

    Batch Build ITK
13. Turn ON the following options under ALL_BUILD:
    • Debug|x64
    • Release|x64
14. Build
15. As you wait, poke your neighbor.

CMakeList files may need to be edited to use ${ITK_LIBRARIES} instead of ITKCommon, ITKIO, ITKBasicFilter.... etc, otherwise you will get errors like "Cannot open file: ITKCommon.lib"

See FARSIGHT_Tutorials/Building_Software if you'd like to enable Python wrapping for ITK.

1. As you wait, take a nice long shower.

Build FARSIGHT

1. Run CMake.
2. Specify the source folder and the binary folder.
3. Configure
4. Set your desired modules to ON. CMake will then tell you if you are missing any libraries.
   • Some modules need glut. Therefore, set the desired locations properly for:
     • GLUT_INCLUDE_DIR, (ex: C:/Program Files/Microsoft Visual Studio 8/VC/PlatformSDK/Include/gl)
     • and GLUT_glut_LIBRARY (ex: C:/Program Files/Microsoft Visual Studio 8/VC/PlatformSDK/Include/gl/glut32.lib)
   • If FTKImage fails to build, go to:
     • properties
       • configuration properties
         • C/C++ and under 'Additional options:' add "/bigobj:
   • THE PACKAGE project does not build automatically, but can be selected and build.
     • It requires some type of platform specific program for creating install packages.
       • Build PACKAGE to create an install file of Farsight.

Note: If running the executable results in the following error: 
"QtGui4.dll was not found"
you may need to add the QT bin directory to the system path on your OS.