Windows Build Instructions

This document explains how to compile the development version of Stellarium on WinXP.

Building with MinGW32

Installation of the win32 development tools

From http://www.mingw.org/download.shtml download and install MinGW-4.1.1.exe, MSYS-1.0.10.exe and msysDTK-1.0.1.exe

Installation of the libraries

See the list of build dependencies. I first tried to install them by hand without success (but it should be possible). Instead I found a much more convenient way of doing it : from http://www.bloodshed.net/download.html download and install the IDE "DevC++". Then from within the program use the integrated package manager to automatically install the 4 libraries mentioned before. Finally copy all the files (".h", ".a" and don't forget the 2 scripts "sdl-config" and "libpng-config") related to those libraries from your DevC++ include/, libs/ and bin/ directory to the minGW include/ ,libs/ and bin/ directories.

TIP: I personally had quite some troubles before the sdl-config and libpng-config script were properly found by the install script. If I remember well I had to rename the sdl-config script which had a slightly different name in the win32 package.

From version 0.8.0, Stellarium uses C++ wstring which are unfortunately not yet supported by the libstdc++ shipped with MinGW32. It is however possible to compile using the STLPort library. Download version 5.0.2 on sourceforge (http://sourceforge.net/project/showfiles.php?group_id=146814) and follow the instructions for compiling the libstlport.5.0.dll.a and libstlport.5.0.dll libraries.

Compiling

• Step 1) Open an MSYS console, from a tar archive, untar the sourcecode archive

tar -xzf stellarium-0.8.0.tgz  
cd stellarium-0.8.0

or if you start from a fresh CVS tree :

./autogen.sh 

• Step 2) Now because we need to use STLport libstdc++ headers and library instead of the ones shipped with Mingw32, we must tell the compiler where to find the right ones and also to give it the right flags to perform a correct compilation. This can be done by setting the following environment variables (replace "/home/gerard/" with the path where you installed STLport) :

export CFLAGS="-Wall -O3 -s -fexceptions -fident -mthreads -D_STLP_NO_CUSTOM_IO -D_STLP_USE_DYNAMIC_LIB  -I/export/home/ptr/workshop/extern/boost -I/home/gerard/STLport/stlport -L/home/gerard/STLport/lib"
export CPPFLAGS="-Wall -O3 -s -Wsign-promo -fexceptions -fident -mthreads -D_STLP_NO_CUSTOM_IO -D_STLP_USE_DYNAMIC_LIB  -I/export/home/ptr/workshop/extern/boost -I/home/gerard/STLport/stlport -L/home/gerard/STLport/lib -I/include/freetype2"
export LDFLAGS="-Wall -O3 -s -Wsign-promo -fexceptions -fident -mthreads -L/home/gerard/STLport/lib -lstlport.5.0"
export LIBS=" -lstlport.5.0"

• Step 3) You can then run the normal configure script

./configure  

then if everything goes well :

make  

• Step 4) If compilation succeed, try to run stellarium as a local version :

./src/stellarium  

Building with Microsoft Visual Studio 8.0

After couple of weeks work I finally got the stellarium compiled and run using MS VisualStudio 8.0. MS C/C++ compiler is quite strict with the declarations of the variables and there is some differences with the functions that MS has/has not, but finally I got it work. A huge patch is posted to Fabien, waiting it to be approved ...

Use SVN to get the source code

Yes. Just use svn to get the source ...

External Libraries

• boost : from http://www.boost.org/
• libintl: from http://gnuwin32.sourceforge.net/
• zlib: http://www.zlib.net
• SDL: http://www.libsdl.org/
• libpng: http://www.libpng.org/pub/png/libpng.html
• freetype: http://freetype.sourceforge.net/index2.html
• libjpeg: http://freshmeat.net/projects/libjpeg/

Download the libraries and the development files (include the needed header-files), install packages and go on ...

Getting the source code : use 'SVN

Visual Studio settings

before compiling

Adding paths

Adding paths for include files and libary files To add newly added libraries to default search path for compilation and debugging : start Visual Studio and go to Tools->Options Add external Directories to "Microsoft Visual Studio" from Tools->Options, select "Project and Solutions" anf from there "VC++ Directories".

Select "Include files" from "Show directories for:" and add directories :

C:\Zlib\include
C:\SDL\include
C:\freetype\include
C:\libjpeg\include
C:\libpng\include
C:\Boost\include
C:\GnuWin32\include

Next add Library locations of libraries, Select "Library Files" from "Show directories for:" and add directories:

C:\Zlib\lib
C:\SDL\lib
C:\freetype\lib
C:\libjpeg\lib
C:\libpng\lib
C:\Boost\lib
C:\GnuWin32\lib

Create Solution

1) To create solution for stellarium

* Select "New...->Project" from "File"-menu
* From "Visual C++" type select general and from there select "Empty Project"
* Enter name form project "Stellarium"
* Enter name for Solution "Stellarium"
* If You want to change the location of project just do it ;}
* Click "OK"

Now there should be a solution called "stellarium" and under it project called "stellarium". Next step is to set the project properties

2) Project Properties

Select "Project->Properties"
* Select "All Configurations" from "Configuration:", browse and set 
  in "Configuration Properties" and set 

 General : 
  Output Directory as C:\Stellarium
  Configuration Type as Appllication (.exe)
 C/C++
  General
   Additional Include Directories:
    ...\stellarium\src\planetsephems;
    ...\stellarium\src\stelutils;
    ...\stellarium\src\msdirent;
    ..\stellarium\src;
   Preprocessor
    Preprocessor Definitions:
     _USE_MATH_DEFINES;
     _CRT_SECURE_NO_DEPRECATE;
     _ATL_SECURE_NO_DEPRECATE;
     main=SDL_main;
     POSIX;
     WIN32;
     WIN32_LEAN_AND_MEAN
 Linker
  Input
   Additipnal Dependices
    msvcrt.lib 
    Ws2_32.lib 
    freetype221.lib 
    libpng13.lib 
    SDL.lib 
    libjpeg.lib 
    libintl.lib 
    SDLmain.lib 
    zdll.lib 
    Opengl32.lib 
    Glu32.lib 
   Ignore Specific Libraries as LIBCMT.lib
  System
   SubSystem as Console (/SUBSYSTEM:CONSOLE)

* Select "Release" from "Configuration:", browse and set 
  in "Configuration Properties" and set 
 C/C++
  General
   Optimization as Optimization: Maximize Speed (/O2)

* Select "Debug" from "Configuration:", browse and set 
  in "Configuration Properties" and set 
 C/C++
  General			
   Debug Information Format as Program Database for Edit & Continue (/ZI)
   Optimization
    Optimization as Disabled (/Od)
   Preprocessor
     _USE_MATH_DEFINES;
     _CRT_SECURE_NO_DEPRECATE;
     _ATL_SECURE_NO_DEPRECATE;
     main=SDL_main;
     POSIX;
     WIN32;
     WIN32_LEAN_AND_MEAN
     DEBUG
   Output Files
    Program Database File Name as $(TargetDir)\vc80.pdb
  Linker
   Input
    Ignore Specific Libraries as LIBCMT.lib
   Debugging
    Generate Debug Info as Yes(/DEBUG)

2) Add files to "stellarium" project Add existing files to project:

"Header Files"  : Add existing files, select all header files from ...\Stellarium\src
"Source Files"  : Add existing files, select all header files from ...\Stellarium\src

Now we have solution and project for stellarium, next thing is to add projects for "iniparser", "msdirent", "plantetsephms" and "stelutils". The creation of these projects is similar to "stellarium" project except the :

"Project type"s areStatic Library (.lib) 

and the

"C/C++->Preprocessor->Preprocessor Defines"s are 
_CRT_SECURE_NO_DEPRECATE;_USE_MATH_DEFINES 

also the "stelutils"-project should have

"Additional Include Directories" as 
...\stellarium\src\stelutils\iniparser
...\stellarium\src\planetsephems;
...\stellarium\src\stelutils;
...\stellarium\src\msdirent;
...\stellarium\src

Create dependencies

To create dependencies right-click on "Stellarium" solution and select "Properties" 1) check that the "Single startup project" in "Common Properties->Startup Project" is checkd and the project selected is "Stellarium". 2) on "Project Dependencies" Stellarium is depended all other projects and other projects are independed

Build

Yes, that's all folks! Just try to build the solution first on "Debug"-mode

Run

Before actually run the application You must copy the libraries *.dll's into the target directory of build e.g. C:\Stellarium or have the *.dll's in Your path (I prefere the first: copy the dll's)

Also the directory structure of config/data/texture and so on must be present in the target directory e.g. C:\Stellarium

That's all !

Now! Just have fun and don't hesitate to contact me if You have problems and/or suggestions

Lippo (lippo dot huhtala at saunalahti dot fi)