Space shooter : Aron & The Aliens

Chapitre 20 : Mise en place d'un menu – la classe «Scripts»

Tutoriel présenté par : Robert Gillard (Gondulzak)
Publication : 3 septembre 2014
Dernière mise à jour : 22 novembre 2015

 Loin, très loin dans les profondeurs de l'Espace
l'Alliance doit faire face à une nouvelle menace.
Des sorcières aliens, dotées de puissants missiles
ont envahi toute la Galaxie.
Et maintenant, rassemblées près de la Ceinture d'Astéroïdes
se dirigent vers la Terre où la défense se prépare.
Aron,un valeureux astronaute, décide d'engager le combat
en tant que leader de la Meruvia Space Force
et rejoint aussitôt la base militaire où l'attend son astronef.

      Préliminaires

   Lors de notre précédent chapitre, nous avons intégré des power-ups dans la fenêtre de combat et je vous ai rappelé combien ceux-ci allaient se révéler très importants pour la survie de notre astronaute. 

   Nous voici arrivés à un moment important de notre projet, celui où nous allons devoir gérer toutes nos collisions mais avant cela, il nous reste une chose à faire. Nous allons en effet maintenant mettre notre menu en place et écrire une nouvelle classe, la classe «Scripts». Ceci va nous donner pas mal de boulot mais, croyez-moi, une fois ce chapitre terminé nous nous serons déjà ôté une belle épine du pied... 

   Pourquoi une classe Scripts ?   Eh bien, celle-ci va contenir tous les écrits qui seront apportés dans notre jeu. Le nom s'imposait donc tout naturellement.   C'est bien entendu par l'écriture de cette classe qu'il nous faudrait commencer ce chapitre mais en premier lieu nous avons quelques ajouts à faire dans notre classe «Hero». Je vous ai, en effet, déjà signalé ailleurs que celle-ci devrait être complétée au fur et à mesure de l'avancement de nos chapitres. 

Le projet « AronAndTheAliens10 »

   Reprenez votre projet précédent ou créez-en un nouveau que vous nommerez «AronAndTheAliens10» (reportez-vous au chapitre précédent en ce qui concerne les manipulations à réaliser).

     1 – Complétons notre classe Hero

   Dans la région Déclaration des variables de la classe Hero, ajoutez :

   Fonction dans laquelle nous mettons trois unités de tonneaux d'énergie dans notre variable energyBarrels. Ces 3 tonneaux d'énergie vont donc nous permettre au départ du jeu, comme je vous l'ai signalé lors du précédent chapitre sur les power-ups, de parcourir (3 x 1500) unités de déplacement intergalactique. Dans ce chapitre nous allons d'ailleurs expérimenter le fait que l'astronef tombe à cours d'énergie si la variable availableGalacticUnits atteint la valeur 0 et nous afficherons à cet effet une nouvelle fenêtre indiquant le type de mort d'Aron.

   Quant au booléen onCombatWindow, il permettra, selon son état (false ou true) d'ouvrir soit la fenêtre de menu soit la fenêtre de combat. 

   Voilà, je crois que nous pouvons maintenant créer notre nouvelle classe, la classe «Scripts». Remplacez le code existant par le code suivant : 

   Nous avons pas mal de choses à expliquer au sujet de notre classe «Scripts» et nous allons le faire fonction par fonction. Mais auparavant, remarquez que je fais dériver cette classe de la classe «AronAndTheAliens10» en écrivant:

class Scripts : AronAndTheAliens10

   Nous allons tout de suite voir pourquoi à l'intérieur de la fonction MenuScript().

   Vous voyez d'autre part que la classe ne possède pas de constructeur ?   Eh bien, puisque cette classe est destinée à recevoir des fonctions d'écriture de divers scripts, nous n'en avons simplement pas besoin ! 
   Voyons maintenant les fonctions que contient cette classe.

   Fonction MenuScript()

   Premièrement, nous voyons que nous passons une variable de type SpriteBatch et deux autres de type SpriteFont à la fonction. Effectivement nous aurons besoin d'y écrire deux polices de hauteurs différentes, font et font3. 

   Nous initialisons ensuite un tableau de chaînes de caractères qui va contenir la préface du menu de notre jeu. Remarquez que le texte anglais de la chaîne est celui qui est écrit en italique et en français tout au début du chapitre, je n'aurai donc pas besoin de vous en faire une traduction. 

   Une des possibilités du C# est de pouvoir créer une chaîne de caractères sans donner a priori la longueur de la chaîne, et c'est ce que nous faisons ici :

   Mais cela n'est pas nécessaire.  Et pour la lecture de cette chaîne, nous allons utiliser une nouvelle instruction conditionnelle, inconnue du langage C ou du C++ mais qui existe en C#, il s'agit de l'instruction foreach. Nous allons tout de suite y revenir. 

   Le titre de notre jeu est écrit par la méthode DrawString() sous une forme spéciale. Celle-ci, en effet, va écrire notre titre en une position centrée sur notre écran. En effet, l'expression «ClientBounds.Width» contient implicitement les dimensions de notre écran tandis que la méthode MeasureString() de la classe SpriteFont calcule la longueur de notre chaîne. L'expression entière centre directement le titre sur notre écran en une position choisie en y = 75.

   Plus joli et plus rapide qu'en C, non ? 

   Maintenant, souvenez-vous que j'ai fait dériver la classe Scripts de la classe AronAndTheAliens10.
   En effet, les dimensions de notre fenêtre ne sont connues que de notre classe de base, d'où l'expression base.Window.ClientBounds.Width / 2. Notez que j'aurais pu utiliser le pointeur this à la place de base et que les expressions base.Window.ClientBounds.Width ou this.Window.ClientBounds.Width sont strictement équivalentes dans ce cas.

   Ensuite, avant l'écriture du texte on positionne la première phrase en y = 150 avec un delta y de 25 pixels pour les autres.

   L'instruction foreach est très simple. On initialise une variable script de type String qui va successivement écrire toutes les phrases de la chaîne en les centrant automatiquement sur l'écran grâce à l'expression que nous venons de voir plus haut.

   Et c'est tout pour notre première fonction de la classe Scripts, nous passons à la suivante. 

   Fonction DrawHud()

   Oui, j'entends certains d'entre-vous dire : Mais qu'es-ce qu'il nous fait là, Gondulzak ?

   La fonction DrawHud a déjà été écrite dans la classe AronAnTheAliens09... 

   C'est exact  ! Eh bien, enlevez-la simplement de la classe AronAndTheAliens10 car je la réintègre dans la classe Scripts avec quelques ajouts. En effet, cette fois quand nous allons dessiner notre Hud, nous allons y ajouter les valeurs de départ de nos acquis que nous n'avions pas introduits dans le précédent chapitre. Dans cette fonction, nous ajoutons donc les valeurs initiales de hero.health, hero.shield, hero.energyBarrels, hero.gold et hero.score. Et comme ces variables ont été déclarées et initialisées dans la classe Hero, nous passons une instance de cette classe à la fonction de même qu'une instance de la classe SpriteFont afin d'écrire la police avec les dimensions de font2 (souvenez-vous bien de ceci quand, dans une fonction, vous devrez utiliser des variables initialisées dans une autre classe ).

   Et c'est tout en ce qui concerne la fonction DrawHud().

   Fonction Challenge()

   Que fait cette fonction ?  Eh bien, en gros, elle affiche tout ce qu'il y a lieu de faire pour permettre à l'astronef de voyager le plus longtemps possible sans se faire exploser par un astéroïde ou une affreuse sorcière alien !

   Dans un premier temps, nous affichons la ligne de texte "Earn 200 gold to get a barrel" soit en français «Amassez 200 pièces d'or pour acheter un tonneau». Ah Ah...  Eh oui, lors de la gestion de nos collisions il vous faudra au moins 200 po pour vous saisir de votre premier power-up !  Comment ?  Mais en explosant des aliens bien sûr !  Et vous vous apercevrez que tant que vous n'aurez pas amassé cette somme, la ligne de texte va clignoter en couleur rouge ! 

   Notre seconde ligne de texte affiche "Reach the Earth to buy a 50 pts Shield (200 po) or a 250 pts Supershield (500 po)" que j'ai modifié dès ce chapitre et qui veut dire «Rejoignez la Terre pour acheter un bouclier de 50 pts pour 200 po ou un super bouclier de 250 pts pour 500 po» (pour autant que vous ayez cette somme, bien entendu ! ).

   Et enfin, nous connaissons la signification de la troisième ligne de texte affichée qui je vous le rappelle, veut dire «Tuez un maximum d'aliens mais prenez garde aux missiles et aux astéroïdes».

   Et c'est tout en ce qui concerne notre fonction «Challenge()».

   Fonction StatesWarnings()

   Cette fonction veut dire : Alertes d'états. Son but, entre autres, est d'avertir le joueur si une valeur acquise d'importance devenait dangereusement basse. 

   Nous commençons par la santé et nous voyons que celle-ci sera coloriée en rouge si sa valeur atteint un quart de sa valeur initiale, soit 25 points.

   Ensuite, dès que la quantité d'energyBarrel est égale à 1, nous le signalons en la faisant clignoter en rouge et nous affichons la décroissance des 1500 dernières unités galactiques contenues dans la variable availableGalacticUnits jusqu'à ce que celles-ci tombent à 0. Nous allons en voir les conséquences dans la fonction UpdateHero() de notre classe AronAndTheAliens10.

   La traduction de la phrase "Inter Galactic Distance Energy Units available : " veut dire : «Unités d'énergie de distance inter galactique restantes».

   Et c'est tout en ce qui concerne la fonction «StateWarnings()».

   Fonction TypeOfDeath()

   Une chose qui me semble utile est aussi de signaler dans une nouvelle fenêtre et après chaque mort d'Aron, dans quoi celui-ci s'est pris les pieds...  je veux dire ce qui a provoqué le crash de l'astronef. 
   Et c'est ce qui va être écrit dans cette fonction, en commençant par ce premier crash que nous connaissons depuis ce chapitre, c'est à dire le manque d'énergie !

   On teste donc la variable booléenne noMoreEnergy et si celle-ci est vraie on écrit la phrase : "No more Energy , you are lost in Space !" qui en français veut dire : «Manque d'énergie , vous vous perdez dans l'Espace !».

   Et on recommence un nouveau jeu en pressant la touche «Enter» ou le bouton correspondant du gamepad. 

   Cette fonction sera bien entendu complétée par la suite au fur et à mesure de nos différentes collisions mais en attendant, c'est ici que l'on arrête nos explications au sujet de la classe Scripts et nous pouvons maintenant procéder aux ajouts que nous avons à effectuer dans le fichier AronAndTheAliens10.cs.

     3 – Classe AronAndTheAlien10

   Dans la région CLASSES REFERENCES, ajoutez :

   Et en dessous de la région POWER_UP DECLARATIONS DATA'S ajoutez la région suivante :

   Il s'agit là des déclarations des textures qui seront appliquées sur notre fenêtre de menu.

   Passons maintenant à la fonction Initialize(). A l'intérieur de la région INITIALIZE ANIMATIONS DATA'S, juste en dessous de :

   Et nous passons à la fonction LoadContent(). A l'intérieur de la région TEXTURES, à la suite de :

   Région dans laquelle nous créons notre fonction DrawBackgroundMenu().

   Maintenant, nous allons écrire la fonction DrawMenu(). Donc à la suite de la région BACKGROUND MENU, entrez la région suivante :

   La première ligne de notre fonction appelle la fonction MenuScript() de notre classe Scripts qui va écrire le titre du jeu ainsi que la chaîne de caractères qui contient sa préface. Un appui sur la touche «Enter» ou sur le bouton correspondant du gamepad démarre alors notre jeu. 

   Bien, il nous faut maintenant tester la quantité restante d'energyBarrel de notre astronef. Nous allons donc écrire une nouvelle fonction que nous appellerons «TestEnergy()». Juste avant la région HERO UPDATE FUNCTION entrez la région suivante : 

   Notre premier test fait que, à chaque distance parcourue de 1500 unités intergalactiques, notre quantité de tonneaux d'énergie est décrémentée d'une unité et nous réinitialisons la variable distance à 0.

   Dès que l'astronef n'a plus qu'un tonneau d'énergie en stock, nous faisons décroitre la variable availableGalacticUnits de 1500 à 0. Quand cette variable atteint la valeur 0, on met le booléen noMoreEnergy à true, la santé à 0 et on quitte la zone de combat avec le booléen onCombatWindow qui devient faux. La fonction TypeOfDeath() de la classe Scripts prend alors la relève et indique le type de crash subi par l'astronef.

   Mises à jour

   Et c'est bien entendu dans la fonction UpdateHero() que nous allons appeler la fonction TestEnergy(). Donc, dans la fonction UpdateHero(), dans chaque test de flèche pressée, juste avant les modifications de la variable hero.Position, nous faisons appel à TestEnergy().

   Après chaque mort du héros, nous devons réinitialiser nos valeurs du Hud avec les valeurs initialisées au départ du jeu et pour ce faire nous écrivons la fonction ResetGame(). Donc à la suite de la région HERO UPDATE FUNCTION, entrez la région suivante :

   Et où allons-nous faire appel à notre fonction ResetGame() ?   Mais dans notre fonction Update() bien sûr, et au moment où l'on presse la touche «Enter» du clavier ou le bouton «Start» du gamepad ! 
   Donc, dans la fonction Update(), en dessous de la ligne :

   Terminé pour la fonction Update(), il nous reste à modifier la fonction Draw(). 

   Fonction Draw()

   Dans la fonction Draw(), si vous n'aviez pas encore enlevé l'appel à la fonction DrawHud(), faites-le maintenant.

   Ce sont des appels aux fonctions vues dans notre classe Scripts. Ensuite, en-dessous du dessin de la patrouille, donc de la ligne :

   Ces instruction parlent d'elles-mêmes, nous les avons déjà vues précédemment. 

   Avant de terminer ce chapitre, j'aurais aimé ajouter une dernière chose. Il m'est venu à l'esprit de réaliser un affichage en temps réel de la position de la galaxie, du gros astéroïde et des planètes dans leur champ de déplacement. Il me semble intéressant qu'au cours du jeu on puisse toujours connaitre la position de la Terre par rapport à la fenêtre de combat pour appliquer telle stratégie si nous devons encore attendre un certain temps avant d'obtenir un super bouclier par exemple. 

   Ok, on se lance et cela prendra peu de temps.  Cliquez sur votre fichier Planets.cs dans l'explorateur de solutions et à la suite du dessin du Big Asteroid au premier plan, donc en fin de région, ajoutez les lignes suivantes : 

   Et, toujours dans la classe «Planets», on n'oublie surtout pas de remplacer le nom de la fonction :

   Et de même, dans la fonction Draw() du fichier AronAndTheAliens10.cs, 

    Et voilà, ce chapitre est enfin terminé.  Je vais maintenant vous montrer quelques screenshots du crash de l'astronef par manque d'énergie. Mais compilez ce projet et expérimentez vous-même les déplacements de l'astronef en pressant les flèches du clavier ou du gamepad et surveillez la valeur de l'élément Energy barrels.

   Dans le prochain chapitre où nous allons introduire nos premières collisions, vous pourrez vous saisir de power-ups et rejoindre la Terre pour acheter un super bouclier, par exemple. En attendant, voici les screenhots capturés au cours de ce chapitre.

   A bientôt pour le chapitre 21 (Les Collisions – partie I). 

         Gondulzak.