Morph01/Tetris
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Ajout de la javadoc

Browse Source
This commit is contained in:
ROGER
2025-05-22 11:01:42 +02:00
committed by Morph01
parent c50210db3f
commit f6c6c5044a
21 changed files with 522 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

184
app/src/main/java/org/Models/Grille.java
View File

@@ -9,6 +9,10 @@ import java.util.ArrayList;
import java.util.List;
import java.util.Observable;
/**
* Représente la grille de jeu du Tetris, gère l'état des cases, la pièce courante,
* le score, la suppression des lignes et les déplacements/rotations des pièces.
*/
@SuppressWarnings("deprecation")
public class Grille extends Observable {
private boolean[][] grille;
@@ -23,6 +27,12 @@ public class Grille extends Observable {
private int score = 0;
private int nbLignesSupprimees = 0;
/**
* Crée une nouvelle grille de jeu avec le nombre de lignes et de colonnes spécifié.
*
* @param nbLignes nombre de lignes de la grille
* @param nbColonnes nombre de colonnes de la grille
*/
public Grille(int nbLignes, int nbColonnes) {
this.nbLignes = nbLignes;
this.nbColonnes = nbColonnes;
@@ -30,6 +40,9 @@ public class Grille extends Observable {
initGrille();
}
/**
* Initialise toutes les cases de la grille à vide (false).
*/
public void initGrille() {
for (int i = 0; i < nbLignes; i++) {
for (int j = 0; j < nbColonnes; j++) {
@@ -38,6 +51,13 @@ public class Grille extends Observable {
}
}
/**
* Modifie l'état d'une case de la grille.
*
* @param i indice de ligne
* @param j indice de colonne
* @param value true si la case est occupée, false sinon
*/
public void setCase(int i, int j, boolean value) {
if (i >= 0 && i < nbLignes && j >= 0 && j < nbColonnes) {
this.grille[i][j] = value;
@@ -46,6 +66,13 @@ public class Grille extends Observable {
}
}
/**
* Retourne l'état d'une case de la grille.
*
* @param i indice de ligne
* @param j indice de colonne
* @return true si la case est occupée, false sinon
*/
public boolean getCase(int i, int j) {
if (i >= 0 && i < nbLignes && j >= 0 && j < nbColonnes) {
return this.grille[i][j];
@@ -53,10 +80,20 @@ public class Grille extends Observable {
return false;
}
/**
* Retourne la pièce courante.
*
* @return la pièce courante
*/
public PieceCourante getPieceCourante() {
return pieceCourante;
}
/**
* Définit la pièce courante et la place en haut de la grille.
*
* @param pieceCourante la nouvelle pièce courante
*/
public void setPieceCourante(PieceCourante pieceCourante) {
this.pieceCourante = pieceCourante;
this.pieceCouranteX = 3;
@@ -65,14 +102,29 @@ public class Grille extends Observable {
notifyObservers();
}
/**
* Retourne la position X de la pièce courante.
*
* @return position X
*/
public int getPieceCouranteX() {
return pieceCouranteX;
}
/**
* Retourne la position X de la pièce courante.
*
* @return position X
*/
public int getPieceCouranteY() {
return pieceCouranteY;
}
/**
* Déplace la pièce courante dans la direction spécifiée si possible.
*
* @param direction direction du déplacement
*/
public void deplacerPiece(Direction direction) {
switch (direction) {
@@ -100,6 +152,9 @@ public class Grille extends Observable {
}
}
/**
* Déplace la pièce courante d'une case vers le bas.
*/
private void deplacerPieceBas() {
pieceCouranteY++;
@@ -107,6 +162,9 @@ public class Grille extends Observable {
notifyObservers();
}
/**
* Déplace la pièce courante d'une case vers la gauche.
*/
private void deplacerPieceGauche() {
pieceCouranteX--;
@@ -114,6 +172,9 @@ public class Grille extends Observable {
notifyObservers();
}
/**
* Déplace la pièce courante d'une case vers la droite.
*/
private void deplacerPieceDroite() {
pieceCouranteX++;
@@ -121,20 +182,38 @@ public class Grille extends Observable {
notifyObservers();
}
/**
* Fait descendre la pièce courante jusqu'à ce qu'elle ne puisse plus descendre.
*/
private void deplacerPieceToutEnBas() {
while (peuxBouger(Direction.BAS, this.motifPieceCouranteColoriee())) {
deplacerPieceBas();
}
}
/**
* Retourne le nombre de lignes de la grille.
*
* @return nombre de lignes
*/
public int getNbLignes() {
return nbLignes;
}
/**
* Retourne le nombre de colonnes de la grille.
*
* @return nombre de colonnes
*/
public int getNbColonnes() {
return nbColonnes;
}
/**
* Retourne la liste des points occupés par la pièce courante dans la grille.
*
* @return liste des points colorés
*/
public List<Point> motifPieceCouranteColoriee() {
List<Point> casesColores = new ArrayList<>();
@@ -150,6 +229,13 @@ public class Grille extends Observable {
return casesColores;
}
/**
* Vérifie si la pièce peut bouger dans la direction donnée.
*
* @param direction direction du déplacement
* @param motif motif de la pièce
* @return true si le déplacement est possible, false sinon
*/
public boolean peuxBouger(Direction direction, List<Point> motif) {
int deltaX = 0;
int deltaY = 0;
@@ -174,10 +260,19 @@ public class Grille extends Observable {
return positionValide(nouvellePosition);
}
/**
* Retourne la matrice représentant la grille.
*
* @return matrice de booleans
*/
public boolean[][] getGrille() {
return grille;
}
/**
* Fixe la pièce courante sur la grille et vérifie la suppression de lignes.
*/
public void fixerPiece() {
for (Point caseColoree : motifPieceCouranteColoriee()) {
setCase(caseColoree.y, caseColoree.x, true);
@@ -187,6 +282,11 @@ public class Grille extends Observable {
verifierEtSupprimerLignesSiBesoin();
}
/**
* Vérifie si la pièce courante doit être fixée (ne peut plus descendre).
*
* @return true si la pièce doit être fixée, false sinon
*/
public boolean doitFixerPiece() {
if (!peuxBouger(Direction.BAS, this.motifPieceCouranteColoriee())) {
return true;
@@ -195,14 +295,27 @@ public class Grille extends Observable {
return false;
}
/**
* Met la grille en pause ou la reprend.
*
* @param enPause true pour mettre en pause, false pour reprendre
*/
public void setEnPause(boolean enPause) {
this.enPause = enPause;
}
/**
* Indique si la grille est en pause.
*
* @return true si en pause, false sinon
*/
public boolean estEnPause() {
return enPause;
}
/**
* Vérifie et supprime les lignes complètes si besoin, met à jour le score.
*/
public void verifierEtSupprimerLignesSiBesoin() {
int tmpNbLignesSupprimees = 0;
System.out.println("Debut uppression d'une ligne......");
@@ -242,22 +355,47 @@ public class Grille extends Observable {
}
}
/**
* Retourne le score actuel.
*
* @return score
*/
public int getScore() {
return score;
}
/**
* Définit le score.
*
* @param score nouveau score
*/
public void setScore(int score) {
this.score = score;
}
/**
* Retourne le nombre total de lignes supprimées.
*
* @return nombre de lignes supprimées
*/
public int getNbLignesSupprimees() {
return nbLignesSupprimees;
}
/**
* Définit le nombre de lignes supprimées.
*
* @param nbLignesSupprimees nouveau nombre de lignes supprimées
*/
public void setNbLignesSupprimees(int nbLignesSupprimees) {
this.nbLignesSupprimees = nbLignesSupprimees;
}
/**
* Supprime la ligne d'indice i et fait descendre les lignes au-dessus.
*
* @param i indice de la ligne à supprimer
*/
public void supprimerLigne(int i) {
for (int ligne = i; ligne > 0; ligne--) {
for (int j = 0; j < nbColonnes; j++) {
@@ -273,6 +411,12 @@ public class Grille extends Observable {
notifyObservers();
}
/**
* Retourne la liste des points d'une ligne donnée.
*
* @param i indice de la ligne
* @return liste des points de la ligne
*/
public List<Point> getLignePoints(int i) {
List<Point> coordonnesCase = new ArrayList<>();
@@ -283,6 +427,11 @@ public class Grille extends Observable {
return coordonnesCase;
}
/**
* Fait descendre une ligne d'une position.
*
* @param i indice de la ligne à descendre
*/
public void descendreLigne(int i) {
for (int j = 0; j < nbColonnes; j++) {
List<Point> coordonnesCase = new ArrayList<>();
@@ -296,6 +445,11 @@ public class Grille extends Observable {
}
}
/**
* Tente de tourner la pièce courante dans l'orientation donnée.
*
* @param orientation sens de rotation
*/
public void tournerPiece(Orientation orientation) {
if (peuxTournerPiece(orientation)) {
boolean[][] motif = pieceCourante.getMotif();
@@ -314,11 +468,23 @@ public class Grille extends Observable {
}
}
/**
* Vérifie si la pièce courante peut tourner dans l'orientation donnée.
*
* @param orientation sens de rotation
* @return true si la rotation est possible, false sinon
*/
public boolean peuxTournerPiece(Orientation orientation) {
List<Point> positionApresRotation = calculerPositionApresRotation(orientation);
return positionValide(positionApresRotation);
}
/**
* Calcule la position de la pièce après rotation.
*
* @param orientation sens de rotation
* @return liste des points après rotation
*/
private List<Point> calculerPositionApresRotation(Orientation orientation) {
List<Point> nouvellePosition = new ArrayList<>();
boolean[][] motifActuel = pieceCourante.getMotif();
@@ -348,6 +514,12 @@ public class Grille extends Observable {
return nouvellePosition;
}
/**
* Vérifie si la position donnée est valide (dans la grille et non occupée).
*
* @param points liste des points à vérifier
* @return true si la position est valide, false sinon
*/
public boolean positionValide(List<Point> points) {
for (Point point : points) {
if (point.x < 0 || point.x >= nbColonnes || point.y < 0 || point.y >= nbLignes) {
@@ -361,6 +533,15 @@ public class Grille extends Observable {
return true;
}
/**
* Calcule la nouvelle position d'une liste de points après déplacement.
*
* @param points liste de points d'origine
* @param deltaX déplacement en X
* @param deltaY déplacement en Y
* @return nouvelle liste de points déplacés
*/
private List<Point> calculerNouvellePosition(List<Point> points, int deltaX, int deltaY) {
List<Point> nouvellePosPoints = new ArrayList<>();
@@ -371,6 +552,9 @@ public class Grille extends Observable {
return nouvellePosPoints;
}
/**
* Réinitialise la grille, le score, le nombre de lignes supprimées et la pièce courante.
*/
public void reinitialiserGrille() {
initGrille();
score = 0;