The application is a C++ Qt application. The library "OpenSceneGraph" is used for 3D graphics. So the main dependencies are Qt (http://qt.nokia.com) (C++ desktop version) and OpenSceneGraph (http://www.openscenegraph.org/projects/osg). The goal is to have the code platform-independent, it should be able to compile it on Linux or Windows (or other?).

Setup on Windows

This describes what to do to install and build the source code with all dependencies on a Windows system. It was tested only on a single computer running Windows Vista Home Basic SP2.
The setup using Microsoft Visual Studio 2010 Express Edition is described here. It should work with MinGW compiler too.
Information is got (partially) from http://developer.qt.nokia.com/forums/viewthread/1374/.
  1. Install Visual C++ 2010 Express (including the compiler).
  2. Download Qt sources (ftp://ftp.qt.nokia.com/qt/source, file qt-everywhere-opensource-src-4.7.4.zip for version 4.7.4. Unzip it into a folder <qtdir>.
  3. Add '<qtdir>\bin' to PATH.
  4. Start a "Visual Studio Command Prompt (2010)" (should be in the Start Menu). Change into <qtdir> and execute 'configure.exe'. There are some options available (--help or http://doc.qt.nokia.com/4.7/configure-options.html), I used all default. Executing this takes a time...
  5. Qt is now "configured" but not built. To build it execute 'nmake'. This will take the real big amount of time (for me it was approx. 3h 30min). After this Qt should be usable.
  6. Proceed with installation of OpenSceneGraph (http://www.openscenegraph.org/projects/osg, the website is "often" down???).
  7. Install CMake (http://www.cmake.org). It is needed to compile OpenSceneGraph.
  8. Download OpenSceneGraph source code (http://www.openscenegraph.org/projects/osg/wiki/Downloads). Unzip it into <osgdir>.
  9. Download prebuilt dependencies (http://openscenegraph.alphapixel.com/osg/downloads/openscenegraph-third-party-library-downloads) for Visual Studio 10. Unzip it into (new folder) '<osgdir>/VS10/3rdparty_alphapixel' (or other location). It may work with only the release version but binaries (at least 'zlib1d.dll') may be needed from debug.
  10. Execute CMake, select <osgdir> as source folder and '<osgdir>/VS10' as build folder. Do "Configure" (for Visual Studio 10), correct ACTUAL_3RDPARTY_DIR to '<osgdir>/VS10/3rdparty_alphapixel' (or the correct location) (USE_3RDPARTY_BIN should be turned on). Possibly change other options. Do "Configure" again until no "red" values appear. Then press "Generate".
  11. Open the generated solution file in Visual Studio 2010. Select project "ALL_BUILD" and build it (or build other projects only).
  12. '<osgdir>/VS10/bin' (or 'bin' folder where OSG is built) should be added to PATH. Now OSG should be usable.

And from now on comes the real fwc

  1. Place source code into directory <fwcdir>. (<fwcdir> should contain the directories 'src' and '.hg' and other files.)
  2. Open file '<fwcdir>/project_files/fwc.pro' in a text editor, read the comments in it and edit the file as needed. Create a new directory <fwcbuild> at the same level as <fwcdir> (not inside it) and save the file here.
  3. Execute 'qmake' in directory <fwcbuild>.
  4. Open the generated Visual Studio project file in Visual Studio. Build the project. If everything is OK it should work.
  5. Start or debug the application. Possibly DLL files need to be copied into the directory where the .exe file resides (zlib1d.dll, even if only release versions were used ??).
  6. A main window named "FireworksCreator", another "Display Window" and a "Form" window should open. The application is started!

An old text, shows how does it not work using the Qt binaries

  1. Install Visual C++ 2010 Express (if not already present).
  2. Install Qt SDK C++ Windows VS 2008 version. (There is no Qt for Visual C++ 2010.)
  3. Install CMake (http://www.cmake.org). It is needed to compile OpenSceneGraph.
  4. Download OpenSceneGraph source code package. Use CMake to generate project files for Visual C++. During this step it might be realized that some other dependencies are needed for OpenSceneGraph, most likely jpeg and tiff and zlib libraries and such. These should be installed in some way too. Some CMake variables (options) can be set as you like it.
  5. Open the generated project in Visual C++ and compile it. Possible some settings about include paths and used libraries must be changed to contain the OpenSceneGraph dependencies installed at the previous step. After this step if you have to choose compile the osg examples (this can be set at CMake variables at the previous step) some example apps can be started to see if it works. Possibly PATH variable should be set to contain the path to osg binaries and a variable called {OSG_FILE_PATH} that contains path to the osg data files (these must be downloaded separately from osg download site).
  6. And ... After this step I can not go any further. Osg apps work but there is a problem with the Qt installation. I want to have a Qt Creator project for the fwc application but Qt creator does not work. Qt finds automatically the installed Qt version (Tools - Options menu, Qt4 tab) but a message "qmake does not exist or is not executable" is displayed. Adding custom path does not work. qmake is contained in PATH. What is the problem here? Possibly Qt for VS 2008 does not work with Visual C++ 2010? Next step is to try qmake to get a Visual C++ project file (but there is no Qt integration in Visual C++ in this setup). Or to try eclipse with Qt (but Microsoft compiler).

(Previously I have developed using MinGW compiler and NetBeans or eclipse IDE, the setup and installation is somewhat more difficult but I have managed to get it work. But the debugging works not perfectly so I decided to switch to Microsoft compiler and debugger.)

Last edited Nov 16, 2011 at 3:09 PM by fruitfruit, version 4

Comments

No comments yet.