Ce BE constitue le second devoir à rendre concernant INF-TC2, et correspond à 4h de TD encadré et 2h d'autonomie. Le compte-rendu (CR) de ce travail devra être déposé sur ``Pedagogie1``, dans l'espace de dépôt spécifique à votre groupe. Et cela dans un **délai de deux semaines après la séance de TD** (délai de rigueur, aucun travail accepté au delà de cette date). Ces 2 semaines ne tiennent pas compte d'éventuelles vacances.
Ce BE est le second devoir à rendre concernant INF-TC2. Le compte-rendu (CR) de ce travail devra être déposé sur `Pedagogie1`, sur l'espace de dépôt spécifique à votre groupe. Et cela dans un **délai de deux semaines après la dernière séance consacrée** (délai de rigueur, aucun travail accepté au delà de cette date). Ces 2 semaines ne tiennent pas compte d'éventuelles vacances.
*Commentaires:*
**Consignes:**
- Le travail peut être individuel ou en binôme.
- Le dépôt consistera en une unique archive (zip, rar) contenant l'ensemble des fichier :
- Le fichier Python, appelé *Pendu.py*, contenant toutes les classes (**FenPrincipale**, **ZoneAffichage** et **MonBoutonLettre**), et un programme principal permettant de lancer l'application.
- un rapport (format markdown ou pdf) contenant
- une en-tête où devront figurer de manière claire le nom des élèves, leur numéro de groupe, le nom de l'encadrant ainsi que le titre du BE.
- un diagramme de classes UML complet de votre application (pensez à utiliser _draw.io_!), avec les liens entre les classes, les cardinalités, les attributs (privés ou publics), et les méthodes (elles-mêmes publiques ou privées).
- Une présentation du code de la DENIERE PARTIE UNIQUEMENT de votre travail (partie intitulée _Améliorations du jeu_). Vous pouvez utilisez des explications textuelles, des diagrammes, des copies d'écran...
- Le travail peut être individuel ou en binôme. Si vous travaillez en binôme, **un seul dépôt suffit !**.
- Le dépôt consistera en une unique archive (zip, rar) contenant l'ensemble des fichiers suivants :
- Le fichier _Python_, appelé *Pendu.py*, contenant toutes les classes (**FenPrincipale**, **ZoneAffichage** et **MonBoutonLettre**), et un programme principal permettant de lancer l'application.
- Le fichier *mots.txt* et la classe *formes.py* (même s'ils n'ont pas été modifiés).
- un rapport (format _word_, _pdf_, ou miex encore _markdown_ !) contenant
- une en-tête où devront figurer le nom des élèves, leur numéro de groupe, le nom de l'encadrant ainsi que le titre du BE.
- un diagramme de classes UML complet de votre application (pensez à utiliser [diagrams](https://app.diagrams.net) !), avec les liens entre les classes, les cardinalités, les attributs (privés ou publics), et les méthodes (elles-mêmes publiques ou privées).
- Une présentation du code de la DERNIÈRE PARTIE UNIQUEMENT de votre travail (partie intitulée _Améliorations du jeu_). Vous pouvez utilisez des explications textuelles, des diagrammes, des copies d'écran...
- L'archive devra nécessairement porter le nom suivant : *nom1-devoir2.zip* ou *nom1-nom2-devoir2.zip* (pour les étourdis, pensez à remplacer *nom1* et *nom2* par vos propres noms :-) )
- L'archive devra nécessairement porter le nom suivant : *nom1-BE5.zip* ou *nom1-nom2-BE5.zip* (pour les étourdis, pensez à remplacer *nom1* et *nom2* par vos propres noms :-) )
L'objectif de ce BE est de réaliser le ``jeu du Pendu``. Pour rappel, ce jeu consiste à essayer de découvrir un mot qui est affiché de manière masquée (chacune de ses lettres est remplacée par le caractère _'*'_). Pour cela, le joueur sélectionne une lettre sur le clavier virtuel. Si elle fait partie du mot, alors le mot à découvrir est ré-affiché en laissant apparaître cette lettre en clair. Si par contre le mot ne contient pas la lettre sélectionnée, alors le compteur de coups ratés augmente d'un et l'élément suivant du pendu est ajouté au dessin. Le joueur gagne s’il a pu découvrir le mot avant que le pendu ne soit complètement affiché (au delà de 10 coups manqués). La figure ci-dessous présente l'interface que nous allons construire ; oui, les couleurs piquent un peu aux yeux, mais ça pourra vous aider à répondre à la première question!
L'objectif de ce BE est de réaliser le `jeu du Pendu`. Pour rappel, ce jeu consiste à essayer de découvrir un mot qui est affiché de manière masquée (chacune de ses lettres est remplacée par le caractère _'*'_). Pour cela, le joueur sélectionne une lettre sur le clavier virtuel. Si elle fait partie du mot, alors le mot à découvrir est ré-affiché en laissant apparaître cette lettre en clair. Si par contre le mot ne contient pas la lettre sélectionnée, alors le compteur de coups ratés augmente d'un et l'élément suivant du pendu est ajouté au dessin. Le joueur gagne s’il a pu découvrir le mot avant que le pendu ne soit complètement affiché (au delà de 10 coups manqués). La figure ci-dessous présente l'interface que nous allons construire ; oui, les couleurs piquent un peu aux yeux, mais ça pourra vous aider à répondre à la première question !
Nous allons vous accompagner dans le développement de ce logiciel. La première partie (90 minutes) porte sur la mise en place de l'interface graphique. La seconde (75 minutes) porte sur la logique du jeu, à partir des commandes associées au bouton _Nouvelle Partie_ et aux Boutons-lettres. La troisième partie met en place le dessin du pendu (75 minutes). La dernière partie propose de développer des fonctionnalités supplémentaires à notre application durant l'autonomie (avec une question _Bonus_ pour les plus téméraires!).
Nous allons vous accompagner dans le développement de ce programme. La première partie (90 minutes) porte sur la mise en place de l'interface graphique. La seconde (75 minutes) porte sur la logique du jeu, à partir des commandes associées au bouton _Nouvelle Partie_ et aux Boutons-lettres. La troisième partie met en place le dessin du pendu (75 minutes). La dernière partie propose de développer des fonctionnalités supplémentaires à notre application durant l'autonomie (avec une question _Bonus_ pour les plus téméraires!).
Ce BE fera l'objet d'un compte-rendu (CR), seul ou en binôme. L'énoncé correspond à 4h encadrées et 2h d'autonomie. Avant de commencer, veuillez prendre connaissance des consignes concernant le rendu du travail (à respecter scrupuleusement) qui se trouvent dans le fichier [consignes_BE#5.md](./consignes_BE#5.md), dans le même répertoire que cet énoncé.
Ce BE fera l'objet d'un compte-rendu (CR), seul ou en binôme. L'énoncé correspond à 4h de TD encadrées et 2h d'autonomie. Avant de commencer, veuillez prendre connaissance des consignes concernant le rendu du travail (à respecter scrupuleusement) qui se trouvent dans le fichier [consignes_BE#5.md](./consignes_BE#5.md), dans le même répertoire que cet énoncé.
---
## Partie 1 - Mise en place de l'interface statique (90 min.)
__Exercice 1 -__ Dessinez l'arbre de scène correspondant à la capture d'écran ci-dessus.
__Exercice 2 -__ En vous inspirant de l'organisation des classes du BE #4, programmez l'interface statique (_i.e._ sans commande) en distinguant la classe __FenPrincipale__ et la classe __ZoneAffichage__. À ce stade, à la place des 26 boutons du clavier (correspondant aux 26 lettres en majuscule), placez un simple bouton _"A"_ (le dessin du clavier est traité dans l'exercice suivant).
__Exercice 2 -__ En vous inspirant de l'organisation des classes du BE #4, programmez l'interface statique (_i.e._ sans commande) en distinguant la classe __FenPrincipale__ et la classe __ZoneAffichage__. À ce stade, à la place des 26 boutons du clavier (correspondant aux 26 lettres en majuscule), placez un simple bouton _"A"_ car le dessin du clavier est traité dans l'exercice suivant.
Testez votre interface et faites les ajustements nécessaires pour obtenir une apparence proche de celle donnée en exemple (mais sans le clavier, et avec les couleurs qui vous conviennent !). Le programme principal se réduira à ces quelques lignes:
Testez votre interface et faites les ajustements nécessaires pour obtenir une apparence proche de celle donnée en exemple (mais sans le clavier, et avec les couleurs qui vous conviennent !). Le programme principal se réduira à ces quelques lignes:
```python
if__name__=='__main__':
fen=FenPrincipale()
...
...
@@ -32,19 +32,20 @@ _Remarque_ : Vous pouvez à ce stade ajouter la commande _self.destroy_ sur le b
__Exercice 3 -__ Nous allons maintenant dessiner le clavier tel qu'il apparaîtra dans la version finale.
1. __Liste des boutons__ Les 26 boutons seront créés et stockés dans une liste de boutons. Pour transformer les nombres de 0 à 25 en lettres _A_, ..., _Z_, vous pourrez utiliser l'instruction suivante ```t = chr(ord('A')+i)``` qui transforme l'entier _i=0_ en la chaîne d'un caractère _t="A"_, l'entier _i=1_ en la chaîne d'un caractère _t="B"_, ...
1. __Liste des boutons__ Les 26 boutons seront créés et stockés dans une liste de boutons. Pour transformer les nombres de 0 à 25 en lettres _A_, ..., _Z_, vous pourrez utiliser l'instruction suivante ```t = chr(ord('A')+i)``` qui transforme l'entier _i=0_ en une chaîne d'un seul caractère _t="A"_, l'entier _i=1_ en une chaîne d'un seul caractère _t="B"_, ...
1. __Placement des boutons__ La disposition des boutons en grille sera réalisée grâce à la commande _grid_, selon l'exemple suivant : ```unBouton.grid(row=1, column=2)``` positionne _unBouton_ sur la première ligne, seconde colonne de la grille (dont la taille s'adapte automatiquement).
Pensez à exécuter votre programme pour vérifier le placement du clavier virtuel.
---
## Partie 2 - Logique de jeu, commandes (75 min.)
Cette partie est destinée à implémenter la logique de jeu, à travers les commandes de l'interface:
Cette partie est destinée à implémenter la logique de jeu, à travers les commandes de l'interface:
- _Bouton "Quitter"_ (normalement, c'est déjà fait avec l'appel à la méthode _destroy_!)
- _Bouton "Nouvelle partie"_
- _Boutons-lettres "A", ..., "Z"_
-_Bouton "Quitter"_ (normalement, c'est déjà fait avec l'appel à la méthode _destroy_!).
-_Bouton "Nouvelle partie"_.
-_Boutons-lettres "A", ..., "Z"_.
On fait ici abstraction de la représentation graphique du pendu qui sera traitée dans la partie suivante de cet énoncé. Allons-y pas-à-pas...
...
...
@@ -52,7 +53,7 @@ On fait ici abstraction de la représentation graphique du pendu qui sera trait
Une partie ne pourra commencer que si le joueur appuie sur le bouton "Nouvelle partie".
__Exercice 4 -__ L'appuie sur ce bouton doit provoquer une ré-initialisation de toute l'interface:
__Exercice 4 -__ L'appuie sur ce bouton doit provoquer une ré-initialisation de toute l'interface:
-Tirer un nouveau mot au hasard dans le fichier [mots.txt](./mots.txt) (à votre disposition à côté de cet énoncé) et réinitialiser le mot à découvrir;
-Dégriser les boutons-lettres (```state=NORMAL```);
...
...
@@ -61,7 +62,7 @@ __Exercice 4 -__ L'appuie sur ce bouton doit provoquer une ré-initialisation de
_Quelques conseils pour l’implémentation_
- Au chargement de l'application, pensez à griser toutes les lettres du clavier.
- Utilisez la méthode suivante pour charger les mots du fichier _mots.txt_ dans une liste privée appelée _self.\_\_mots_. Cette liste sera chargée un fois pour toute au lancement de l'application, et utilisée à chaque nouvelle partie.
- Utilisez la méthode suivante pour charger les mots du fichier _mots.txt_ dans une liste privée appelée _self.\_\_mots_. Cette liste sera chargée une fois pour toute au lancement de l'application, et utilisée à chaque nouvelle partie.
```python
def chargeMots(self):
f = open('mots.txt','r')
...
...
@@ -69,7 +70,7 @@ def chargeMots(self):
self.__mots = s.split('\n')
f.close()
```
- Pour tirer un nouveau mot, utilisez la fonction _randint(...)_ (```from random import randint```).
-Pour tirer un nouveau mot au hasard, utilisez la fonction _randint(...)_ (```from random import randint```).
<!--
_Tip_ Vous pouvez créer des attributs différents pour sauvegarder
...
...
@@ -83,7 +84,7 @@ Pensez à vérifier que votre application est bien fonctionnelle à ce stade.
### Boutons-lettres "A", ..., "Z" (45 min.)
Appuyer sur une lettre du clavier virtuel doit provoquer un certain nombre d'actions :
Le fait d'appuyer sur une lettre du clavier virtuel doit provoquer un certain nombre d'actions:
-griser le bouton-lettre qui vient d'être cliqué (```state=DISABLED```);
-faire apparaître autant de fois que nécessaire la lettre cliquée dans le mot à découvrir;
1. Créez la classe __MonBoutonLettre__, qui hérite de la classe __Button__, et qui sauvegarde, en tant qu'attribut privé, la lettre correspondant au bouton (ou le numéro du bouton). Modifiez en conséquence le constructeur de la classe __FenPrincipale__ pour que le clavier virtuel soit composé de 26 instances de la classe __MonBoutonLettre__.
1. Créer la fonction de callback _cliquer(self)_ dans la classe __MonBoutonLettre__, qui fera notamment appel à la méthode _traitement(...)_ de la classe __FenPrincipale__.
1. Programmez la méthode _traitement(...)_ dont l'objectif est de mettre à jour l'affichage du mot.
- Si la partie est gagnée, bloquez l'utilisation du clavier, et affichez un texte qui indique au joueur que c'est gagné!
- La partie est perdue quand le nombre de coups dépasse 10 (c'est le nombre d'éléments pour dessiner entièrement le pendu). Bloquez alors l'utilisation du clavier, et affichez un texte qui indique au joueur que c'est perdu!
- Si la partie est gagnée, bloquez l'utilisation du clavier, et affichez un texte qui indique au joueur que c'est gagné!
- La partie est perdue quand le nombre de coups dépasse 10 (c'est le nombre d'éléments nécessaires pour dessiner entièrement le pendu). Bloquez alors l'utilisation du clavier, et affichez un texte qui indique au joueur que c'est perdu!
À ce stade, l'application doit être entièrement fonctionnelle, seul le dessin du pendu est manquant, ce que nous allons compléter dès à présent...
---
## Partie 3 - Le dessin du pendu (75 min.)
Cet partie est consacrée au dessin progressif du pendu, au fur et à mesure des échecs du joueur. Ce dessin s'appuie sur les connaissances acquises lors du BE #4 et les classes du fichier [formes.py](./formes.py), disponible à côté de cet énoncé (c'est le même que celui utilisé dans le BE #4).
Cet partie est consacrée au dessin progressif du pendu, au fur et à mesure des échecs du joueur. Ce dessin s'appuie sur les connaissances acquises lors du BE #4 et les classes du fichier [formes.py](./formes.py), disponible à côté de cet énoncé (Attention le fichier utilisé ici est très légèrement différent de celui du BE #4, merci de bien télécharger cette version).
__Exercice 6 -__
Pour cela, l'idée est de créer le pendu comme une liste de rectangles et d'ellipses (10 pièces doivent suffire), dans le constructeur de la classe __ZoneAffichage__. Pour faire disparaître le pendu (au moment de la création des pièces, ou au moment de la réinitialisation d'une partie p. ex.), on affectera aux pièces l'état caché (```state=hidden```). Pour faire apparaître les pièces progressivement (sur ordre de la méthode _traitement(...)_), on leur affectera l'état normal (```state=normal```).
Pour gagner un peu de temps, voici un exemple de coordonnées pour les éléments graphiques :
```python
# Base, Poteau, Traverse, Corde
Rectangle(self,50,270,200,26,"brown")
Rectangle(self,87,83,26,200,"brown")
Rectangle(self,87,70,150,26,"brown")
Rectangle(self,183,67,10,40,"brown")
# Tete, Tronc
Rectangle(self,188,120,20,20,"black")
Rectangle(self,175,143,26,60,"black")
# Bras gauche et droit
Rectangle(self,133,150,40,10,"black")
Rectangle(self,203,150,40,10,"black")
# Jambes gauche et droite
Rectangle(self,175,205,10,40,"black")
Rectangle(self,191,205,10,40,"black")
```
---
## Partie 4 - Améliorations du jeu (autonomie)
Voici quelques améliorations possibles pour le jeu, seule la dernière est considérée comme un bonus.
__Exercice 7 - Apparence__ Développez le code qui permet au joueur de choisir les couleurs principales de l’application (par menus, boutons...).
__Exercice 7 - Apparence__ Développez le code qui permet au joueur de choisir les couleurs principales de l’application (par un menus, par des boutons...).
__Exercice 8 - Bouton Triche__ Implémentez un bouton "Triche" qui permet de revenir en arrière d'un coup, pendant la partie.
__Exercice 8 - Bouton Triche__ Implémentez un bouton "Triche" qui permet de revenir en arrière d'un coup en cours de partie.
__Bonus - Score joueur__ Implémentez un système de sauvegarde des parties jouées par un joueur (identifié par un pseudo demandé au joueur). Techniquement, on pourra créer une base de données _SQL_ (_cf_ BE #3), appelée _pendu.db_, qui stockera une table avec les joueurs et une table avec les parties jouées par ces joueurs, selon le schéma suivant :
__Bonus - Score joueur__ Implémentez un système de sauvegarde des parties jouées par un joueur (identifié par son nom et son numéro) ? Techniquement, on pourra créer une base de données SQL (BE #3), appelée _pendu.db_, qui stockera une table avec les joueurs et une table avec les parties jouées par ces joueurs, selon le schéma suivant:
Le score pour chaque mot pourra être défini comme le taux de caractères trouvés (ainsi un score de 1.0 désigne un succès).
_Remarque_ : on ne demande pas ici d'afficher un historique ou des statistiques sur un joueur. Pour consulter la base, on pourra simplement utiliser ```DB Browse for SQLite```.
_Remarque_ : on ne demande pas ici d'afficher un historique ou des statistiques sur un joueur. Pour consulter la base, on pourra simplement utiliser ```DB Browser for SQLite```.
