Dépôt subversion

Langue

English

Un dépôt subversion est fourni par SourceForge.net et nous permet de garder un historique des changements faits dans le jeu. Ce dépôt contient tout ce qui a été produit pour le jeu : le code, les dessins, les sons ; mais aussi des éléments annexes comme le site Internet. Il peut être vu à cette adresse.

Les dépôt est scindé en trois parties nommées branch, tag et trunk. Ce dernier dossier contient le projet en cours de modification. Cela signifie qu'il peut ne pas fonctionner, même si nous essayons de le garder dans un état relativement stable (c'est à dire que ça compile et ça s'exécute). Le dossier tag contient le projet dans l'état qu'il était lors des publications effectuées depuis le début du projet. Enfin, le dossier branch contient des versions du projet sur lesquelles sont effectuées de grosses modifications. Il n'est pas rare qu'une versions prise dans ce dossier ne compile pas ou contienne d'énormes bugs.

Cette page décrit la procédure à suivre pour récupérer le jeu depuis le dépôt. La compilation et l'exécution sont décrit sur une page à part.

Prérequis

Le premier logiciel nécessaire est évidemment subversion, pour pouvoir récupérer le jeu depuis le dépôt. Pour pouvoir ensuite le compiler, vous aurez besoin des bibliothèques listées ci-dessous.

• SDL version ≥ 1.2.8 ;
• SDL-mixer version ≥ 1.2.8 ;
• libboost version ≥ 1.33.1 (en particulier boost::filesystem et boost::thread);
• wxWidgets version ≥ 2.8 (uniquement pour les éditeurs de niveaux et de modèles) ;
• libclaw version ≥ 1.6.0 (voir la page dédiée) ;
• gettext ;
• OpenGL.

Pour toutes les bibliothèques, il faut installer les versions de développement, avec les fichiers d'entête. Sous Debian et dérivées, les paquets suivants sont de bons candidats :

libsdl-mixer1.2-dev libboost-filesystem-dev libboost-thread-dev mesa-common-dev libwxgtk2.8-dev libgl1-mesa-dev

Vous aurez aussi besoin d'un compilateur C++, de CMake et d'une carte graphique avec accélération 3D.

Récupération du matériel

Le dossier à récupérer depuis le dépôt est /trunk/game. Il contient le jeu, le moteur du jeu et les éditeurs de niveaux et de modèles. Pour l'obtenir, il suffit de taper la commande suivante dans un terminal

svn co https://plee-the-bear.svn.sourceforge.net/svnroot/plee-the-bear/trunk/game

Inutile de regarder les noms de fichier défiler, il y en a pour au moins 300 Mio. Une fois cette commande terminée, il ne sera plus nécessaire de l'exécuter à nouveau. Pour mettre à jour les fichiers avec la version du dépôt, il suffira de taper, dans le dossier téléchargé, la commande suivante

svn update

Le dossier téléchargé contient trois sous-dossiers nommés bear-engine, bear-factory et plee-the-bear. Le premier contient le code pour le moteur du jeu et est en partie organisé comme suit :

• ./bear-engine
  • ./common : des fichiers partagés avec l'éditeur de niveaux ;
  • ./core : source et documentation du moteur ;
  • ./lib : bibliothèque d'objets génériques (c'est à dire non liés à Plee the Bear) ;
  • ./running-bear : le programme à lancer pour exécuter un jeu fait pour le moteur (voir la ligne de commande).

Le dossier bear-factory contient les éditeurs. Il est en partie organisé comme suit :

• ./bear-factory
  • ./animation-editor : l'éditeur d'animations ;
  • ./bear-editor : une bibliothèque partagée par les différents éditeurs ;
  • ./item-description : les fichiers de description d'objet, qui décrivent les objets du jeu pour être utilisés via l'éditeur de niveaux ;
  • ./level-editor : l'éditeur de niveaux ;
  • ./model-editor : l'éditeur de modèles.

Enfin, le dossier plee-the-bear contient le matériel du jeu en lui même. Il est en partie organisé comme suit :

• ./plee-the-bear
  • ./data : les données du jeu (niveaux, modèles, polices de caractères, images, animations, sons) ;
  • ./game : contient un script qui lance le programme running-bear avec les bons paramètres pour Plee the Bear ;
  • ./item-description : les fichiers de description d'objet, qui décrivent les objets du jeu pour être utilisés via l'éditeur de niveaux ;
  • ./src : le code source du jeu.