windows installation instructions

»Running the precompiled executable
»MS Visual C++ 2003/2005
»Cygwin

Running the precompiled executable

Unzip the package somewhere
Run vcredist_x86.exe.
This installs the libraries required for binaries built by visual C++ 2005. More information...
Run Freestyle.exe

Visual C++ 2003 or 2005

Requirements

don't be affraid...

MS Visual C++ 2003 or 2005 [free]
(Visual 2005 Express Edition is free. Make sure to follow all instructions and to also install the Microsoft Platform SDK as instructed.)
OpenGL
[free] This should be part of the standard VC++ installation.
GLUT [free]
The OpenGL Utility Toolkit (GLUT).
QT 4.2.3
QT is an open source multi-platform GUI and is free for open source projects. The trolltech win32 distribution targets the MinGW compiler but you can patch Qt4 sources to make it work with visual studio, as detailed here.
libQGLViewer 2.2.5-1 [free]
QGLViewer is a trackball-based 3D viewer including many useful features. It is packed as a QT widget and distributed as a free open source library.
lib3ds 1.2 [free]
The free open source library allowing to load and save 3DS files.
swig 1.3.31 [free]
SWIG is an interface compiler that connects programs written in C and C++ with scripting languages such as Perl, Python, Ruby, and Tcl. Freestyle uses it to generate the binding between its C++ API and the style scripting language Python. Precompiled binaries for windows are provided under the name swigwin-X.X.X.
Python 2.5 [free]
Python is an interpreted, interactive, object-oriented programming language. We chose it as our style scripting language. The python distribution also includes precompiled binaries for windows.

Compilation

1) You must set a FREESTYLE_DIR environment variable containing the freestyle directory location.
2) In $FREESTYLE_DIR\src edit the libconfig.pri. This file contains the locations of the various libraries headers and files. Modify the initial values facing the win32 tags to match your own configuration.
3) In $FREESTYLE_DIR\src, run makedsp.vcnet.debug.bat (or makedsp.vcnet.release.bat if you specified release in the src\Config.pri file. This will generate the VC++ vcproj project files from the pro files in each subdirectory of freestyle.
4) In $FREESTYLE_DIR\src, open Freestyle-vc8-debug.sln (or Freestyle-vc8-release.sln if you're working in release mode. For visual c++ 2003, use the files containing vc7 instead of vc8 in their names). This will open the Freestyle working space in VC++.
5) Set the proper active configuration (debug or release) for Freestyle (depending on the config specified in the src\Config.pri file) in the 'Build' > 'Configuration Manager' menu action and compile the whole project using 'Build Solution' in the 'build' menu. This will build Freestyle.exe as well as all its libraries in the $FREESTYLE_DIR\build\win32\debug or release directory depending on your configuration. Only the swig library remains to build as it is currently not integrated in the QT process.
5) In $FREESTYLE_DIR\src\swig, open the FreestyleWrapper.vc8.vcproj (or vc7), set the proper configuration through 'Build' > 'Set Active Configuration' and build the library using 'Build' > 'Build _Freestyle.dll'. (Don't worry about the zillion warnings). The PYTHON_INCLUDE and PYTHON_LIB environment variables must be defined (For instance PYTHON_INCLUDE: C:\Python25\include and PYTHON_LIB: C:\Python24\libs\python25.lib). This step builds _Freestyle.dll and Freestyle.py, i.e. the python API for style description, in the $FREESTYLE_DIR\build\win32\release\python directory (or debug\python).
6) Run Freestyle, open the 'Windows' > 'Options Window', select the 'Directories tab' and add to the 'Python path' the location of the directory where the library of the previous was built (e.g. $FREESTYLE_DIR\build\win32\release\python). Save and close the dialog window (you might need to reset the Python Interpreter through 'Tools' > 'Reset Interpreter').
7) Write great style modules and generate beautiful images. (Start perhaps by the tutorial).

Cygwin

Requirements

gcc 4.0 or 4.1 [included in cygwin]
OpenGL and GLUT [included in cygwin]
QT 4.2.3 [free]
QT is a free open source multi-platform GUI. The distribution provided by trolltech for MinGW should compile fine on cygwin (Opengl must be enabled).
libQGLViewer 2.2.5-1 [free]
QGLViewer is a trackball-based 3D viewer including many useful features. It is packed as a QT widget and distributed as a free open source library.
lib3ds 1.2
The free open source library allowing to load and save 3DS files.
swig 1.3.31 [included in cygwin]
SWIG is an interface compiler that connects programs written in C and C++ with scripting languages such as Perl, Python, Ruby, and Tcl. Freestyle uses it to generate the binding between its C++ API and the style scripting language Python.
Python 2.5 [included in cygwin]
Python is an interpreted, interactive, object-oriented programming language. We chose it as our style scripting language.

Compilation

1) You must set a FREESTYLE_DIR environment variable containing the freestyle directory location.
2) In $FREESTYLE_DIR/src edit the libconfig.pri. This file contains the locations of the various libraries headers and files. Modify the initial values facing the cygwin-g++ tags to match your own configuration.
3) Build Freestyle:
cd $FREESTYLE_DIR/src qmake make This will build Freestyle.exe as well as all its libraries in the $FREESTYLE_DIR\build\cywin-g++\release or debug directory depending on your configuration. Only the swig library remains to build as it is currently not integrated in the QT process.
4) Build the Python API:
cd $FREESTYLE_DIR/src/swig make -f Makefile.cygwin make -f Makefile.cygwin install This step builds _Freestyle.dll and Freestyle.py, i.e. the python API for style description, in the $FREESTYLE_DIR/build/cygwin-g++/release/python directory (or debug/python).
5) Run Freestyle: cd $FREESTYLE_DIR/build/cygwin-g++/release/ ./Freestyle Open the 'Windows' > 'Options Window', select the 'Directories tab' and add to the 'Python path' the location of the directory where the library of the previous was built (e.g. $FREESTYLE_DIR/build/cygwin-g++/release/python). Save and close the dialog window (you might need to reset the Python Interpreter through 'Tools' > 'Reset Interpreter').
7) Write great style modules and generate beautiful images. (Start perhaps by the tutorial).