Nous décrivons la procédure pour compiler une application avec FreeSG sous Microsoft Visual Studio 2008. Les étapes nécessaires pour compiler FreeSG comme tel sous Visual Studio sont aussi décrites. Vous devez avoir le Microsoft Windows SDK (ou «Platform SDK») déjà installé sur votre système.

Note: Il existe des bogues dans le <math.h> de Visual Studio 2005 qui peuvent causer des problèmes de compilation si vous utilisez l'arithmétique à précision simple. Il suffit de compiler FreeSG pour la double précision pour éviter le problème.

Installer FreeSG

Téléchargez le dernier paquet binaire de FreeSG pour Windows sur notre page de téléchargement, et décompressez l'archive dans un répertoire tel que C:\Program Files\FreeSG.

Démarrez Visual Studio et allez sur Tools / Options. Sélectionnez Projects and Solutions / VC++ Directories. Dans le champs Show directories for, sélectionnez l'option Include files. Si vous avez installé le SDK de FreeSG dans C:\Program Files\FreeSG, par exemple, ajoutez: 

  C:\Program Files\FreeSG\include

Maintenant sélectionnez Show directories for / Library files et ajoutez: 

  C:\Program Files\FreeSG\lib
Installer Agar

FreeSG requiert la librairie Agar. Des paquets binaires précompilés sont disponibles à partir d'ici et d'installent de la même façon que FreeSG. Voyez le guide d'installation d'Agar.

Il est fortement recommandé d'installer Agar avec le support multithread.

Créer une application FreeSG dans Visual Studio

Vous pouvez maintenant créez un nouveau projet. Dans l'Application Wizard, utilisez Console application dans le champs Application type, cochez Empty project et cliquez sur Finish.

Dans le Solution Explorer, allez dans Properties à partir du menu-popup de votre projet. Cliquez sur Configuration Properties / Linker / System et attribuez au paramètre SubSystem la valeur: Windows (/SUBSYSTEM:WINDOWS). Cliquez sur Configuration Properties / Linker / Input et dans le champ Additional Dependencies, saisissez: 

  freesg.lib
  ag_gui.lib
  ag_core.lib
  SDL.lib
  SDLmain.lib
  opengl32.lib
  freetype.lib

Si vous utilisez une version nofreetype du Agar SDK, enlevez freetype.lib.

Ajoutez un nouveau fichier C++ dans Source Files sous Solution Explorer, tel que main.cpp. Votre application devrait maintenant compiler et exécuter. Voyez le répertoire ./demos dans les sources de FreeSG pour quelques exemples.

Note: Si vous voulez que votre application soit portable à d'autres systèmes d'exploitations et d'autres environnements de développement, considérez l'utilitaire BSDBuild. Il peut même générer les fichiers de projet à votre place.

Compiler FreeSG comme tel avec Visual Studio

Si vous n'utilisez pas le SDK précompilé et que vous préférer compiler FreeSG vous-même, localisez les « fichiers de projet » situés dans le répertoire .\ProjectFiles\ de la distribution source de FreeSG. Choisissez le .zip qui correspond à votre version de Visual C++, par exemple vs2005-windows.zip fonctionnera avec toutes les éditions de Visual C++ 2005.

Décompressez l'archive sur la racine du répertoire source de FreeSG (FreeSG.sln devrait se trouver dans le même répertoire que le fichier README).

Vous pouvez maintenant ouvrir FreeSG.sln avec Visual Studio et compiler FreeSG. Une fois FreeSG compilé, exécutez INSTALL-SDK.EXE dans le répertoire raçine de la source pour installer les librairies sur votre système. Par défault, elles sont installées sur C:\Program Files\FreeSG.