ATTENTION : ceci est la documentation d'une version antérieure de SFML ; la documentation de la dernière version officielle est accessible via le menu principal

Tutoriel - Démarrer - SFML et Visual Studio

Sommaire

Introduction

Ce tutoriel est le premier que vous devriez lire si vous utilisez SFML avec le compilateur Visual C++. Il va vous expliquer comme installer SFML, paramétrer votre EDI, et compiler un programme SFML.
La compilation des bibliothèques SFML est également expliquée, pour les utilisateurs plus expérimentés (bien que ce soit relativement simple).

SFML est maintenue sous VC++ 2005 Professionnel, mais les explications suivantes sont valides pour d'autres versions telles que VC++ 2005 Express, VC++ 9, VC++ 7 ou même VC++ 6.

Installer SFML

Premièrement, vous devez télécharger les fichiers de développement de SFML. Vous pouvez télécharger l'archive minimale (bibliothèques + en-têtes), mais il est recommandé de télécharger le SDK complet, qui contient en plus les exemples et la documentation.
Si vous comptez utiliser les modules Graphics ou Audio, vous aurez également besoin de télécharger les bibliothèques externes utilisées par SFML. Cette archive contient les DLLs de ces bibliothèques, qui seront nécessaires pour exécuter vos programmes SFML. Si vous ne souhaitez utiliser que les modules System, Window ou Network, vous n'avez pas besoin de ces bibliothèques.
Toutes les archives mentionnées peuvent être trouvées sur la page de téléchargements.

Une fois que vous avez téléchargé et extrait les fichiers sur votre disque dur, vous devez faire en sorte que Visual C++ connaisse les fichiers en-têtes et bibliothèques de SFML. Il y a deux façons de le faire :

Compiler votre premier programme SFML

Créez un nouveau projet "Win32 console application", et écrivez un programme SFML. Par exemple, vous pouvez essayer la classe sf::Clock du module système : 

#include <SFML/System.hpp>
#include <iostream>

int main()
{
    sf::Clock Clock;
    while (Clock.GetElapsedTime() < 5.f)
    {
        std::cout << Clock.GetElapsedTime() << std::endl;
        sf::Sleep(0.5f);
    }

    return 0;
}

N'oubliez pas que toutes les classes et fonctions SFML se trouvent dans l'espace de nommage sf.

Ouvrez les options de votre projet, puis allez dans le menu Linker / Input. A la ligne Additional dependencies, ajoutez les bibliothèques SFML que vous utilisez. Ici nous n'utilisons que sfml-system.lib. Pour la configuration Debug, vous pouvez lier avec les versions de débogage des bibliothèques, qui sont suffixées par "-d" (sfml-system-d.lib dans ce cas).
Ca c'est pour les bibliothèques dynamiques, celles qui nécessiteront les DLLs correspondantes. Si vous souhaitez plutôt lier avec les versions statiques des bibliothèques SFML, vous pouvez utiliser le préfixe "-s" : sfml-system-s.lib, ou sfml-system-s-d.lib pour la version debug.

Capture d'écran de la boîte de dialogue pour paramétrer les bibliothèques du projet

Votre programme devrait maintenant compiler, lier et s'exécuter sans problème. Si vous avez lié avec la version dynamique des bibliothèques SFML, n'oubliez pas de copier les DLLs correspondantes (sfml-system.dll dans ce cas) dans le répertoire de votre exécutable, ou dans un répertoire contenu dans la variable d'environnement PATH. Si vous utilisez les bibliothèques dynamiques, vous devez également définir la macro SFML_DYNAMIC dans les options de votre projet.

Capture d'écran de la boîte de dialogue pour lier avec les bibliothèques dynamiques

Si vous utilisez le module Audio, vous devez également copier les DLLs des bibliothèques externes qu'il utilise, qui sont libsndfile-1.dll et OpenAL32.dll.
Ces fichiers peuvent être trouvés dans le répertoire extlibs\bin que vous avez téléchargé avec le SDK.

Compiler SFML (pour les utilisateurs avancés)

Si les bibliothèques précompilées de SFML n'existent pas pour votre système, vous pouvez les compilez assez facilement. Dans de tels cas, aucun test n'a été effectué et nous vous encourageons donc à rapporter tout échec ou succès rencontré durant le processus de compilation. Si vous réussissez à compiler SFML pour une nouvelle plateforme, nous vous invitons à contacter l'équipe de développement afin que nous puissions partager les fichiers avec la communauté.

Pour compiler les bibliothèques SFML et les exemples, vous devez tout d'abord télécharger et installer le SDK complet.

Allez dans le répertoire SFML-x.y\build\vc2005, et ouvrez le fichier SFML.sln. Choisissez la configuration que vous souhaitez construire (Debug ou Release, Static ou DLL), et cliquez sur "build". Cela devrait créer les bibliothèques SFML correspondantes dans lib\vc2005, ainsi que les exécutables des exemples. Si Qt et wxWidgets ne sont pas installés sur votre système, vous devriez avoir des erreurs de compilation avec les exemples correspondants ; ignorez les simplement.

Sommaire