Windows build instructions

Use these instructions to build the FiberNavigator on Windows (7 and later).

If you want to be able to build and run the Fibernavigator from any user account on your computer (for example, if it is a shared lab computer), create a "libraries" directory on the main drive (for example, c:) and use this directory as the top directory for all the following steps. If you want it to be accessible only for one user account, take any directory you like.

CMake

You will need to install CMake, which is a cross-platform open-source build system.

Configuring, compiling and using the Fibernavigator

GLEW

1. Download GLEW.

• With CMake 2.8.6 and later
  1. The GLEW directory structure doesn't need remodeling, and there is no environment variable to set. Just unzip the file to a common location. You will need to configure it once running CMake.

Configure and build wxWidgets

1. Download wxWidgets ver. 3.0.2.
2. Unzip it to a common location.
3. Go to your root wxWidgets directory and open the file "setup.h" located in folder : /include/wx/msw/
4. Find the preprocessor definition "USE_GLCANVAS". It should be set to 0 by default. Set it to 1 to enable OpenGL support in wxWidgets.
5. Open wxWidget's Visual Studio workspace (wx_dll.dsw) located in directory : build/msw. Visual Studio might ask to convert or update it to a newer version, proceed to the conversion.
6. Select the "DLL Unicode Debug" build configuration and press the build button (ctrl+shif+b). If there is an error when trying to link with the file "wxbase28ud_odbc.lib", disregard it. It will not cause any problem later on.
7. Do the preceding step again, this time selecting the "DLL Unicode Release" build configuration.
8. If it wasn't already created, create the "WXWIN" environment variable. Make sure it points to your current wxWidgets installation directory.
9. Add the complete wxWidgets library path (%WXWIN%;%WXWIN%\lib\vc_dll;) to the environment variable named "PATH".

Configure and build the Fibernavigator

• Clone the source repo (see the Code page).
• Generate the Visual Studio solution using CMake. The source directory should be set to the "src" subdirectory of your code, and the build directory should be set to a "build" subdirectory that you created in your cloned repo.
• If you run CMake 2.8.6 or later, you will need to correct the value of the 3 following variables:
  • GLEW_DLL_FOUND should point to the "glew32.dll" file in the "bin" subdirectory of the GLEW directory.
  • GLEW_INCLUDE_PATH should point to the "include" subdirectory of the GLEW directory.
  • GLEW_LIBRARY should point to the "glew32.lib" file in the "lib" subdirectory of the GLEW directory.
• If needed, change the build-type configuration to DEBUG;release.
• Once your solution is ready, open it with Visual Studio and compile.
• It should be automatically done, but if there is an error when launching the Fibernavigator about missing GLSL files, you could need to copy the "src/icons" and "src/GLSL" directories to your build directories (release, DEBUG).