ajout java doc + Makefile + mariadb.jar

This commit is contained in:
2024-10-27 20:39:25 +01:00
parent 6aacd0d59a
commit 23983e861f
14 changed files with 384 additions and 39 deletions

View File

@@ -7,11 +7,27 @@ import javax.swing.*;
import java.awt.*;
import java.awt.geom.Path2D;
/**
* La classe <code>HexagonTile</code> représente une tuile hexagonale dans le jeu.
* Elle gère l'affichage d'une tuile avec ses segments de terrain et
* indique si la tuile est un placeholder.
*/
public class HexagonTile extends JPanel {
/** La tuile associée à cet hexagone. */
private Tile tile;
/** La position de l'hexagone sur la grille. */
private Point position;
private boolean isPlaceholder; // Indicateur si l'hexagone est un placeholder
/** Indicateur si l'hexagone est un placeholder. */
private boolean isPlaceholder;
/**
* Constructeur de la classe <code>HexagonTile</code>.
*
* @param position La position de l'hexagone sur la grille.
* @param isPlaceholder Indique si cet hexagone est un placeholder.
*/
public HexagonTile(Point position, boolean isPlaceholder) {
this.position = position;
this.isPlaceholder = isPlaceholder;
@@ -19,24 +35,50 @@ public class HexagonTile extends JPanel {
setPreferredSize(new Dimension(100, 100));
}
/**
* Récupère la position de l'hexagone.
*
* @return La position de l'hexagone.
*/
public Point getPosition() {
return position;
}
/**
* Définit la tuile associée à cet hexagone.
*
* @param tile La tuile à associer.
*/
public void setTile(Tile tile) {
this.tile = tile;
this.isPlaceholder = false; // Une fois la tuile posée, ce n'est plus un placeholder
repaint();
}
/**
* Récupère la tuile associée à cet hexagone.
*
* @return La tuile associée.
*/
public Tile getTile() {
return tile;
}
/**
* Vérifie si l'hexagone est rempli avec une tuile.
*
* @return <code>true</code> si l'hexagone contient une tuile, sinon <code>false</code>.
*/
public boolean isFilled() {
return this.tile != null;
}
/**
* Méthode de peinture du composant.
* Dessine l'hexagone et ses segments de terrain, ou un placeholder si aucun terrain n'est présent.
*
* @param g Le contexte graphique dans lequel dessiner.
*/
@Override
protected void paintComponent(Graphics g) {
super.paintComponent(g);
@@ -62,6 +104,14 @@ public class HexagonTile extends JPanel {
g2d.draw(largeHexagon);
}
/**
* Dessine les segments de terrain associés à la tuile.
*
* @param g2d Le contexte graphique dans lequel dessiner.
* @param centerX La coordonnée X du centre de l'hexagone.
* @param centerY La coordonnée Y du centre de l'hexagone.
* @param radius Le rayon de l'hexagone.
*/
private void drawTerrainSegments(Graphics2D g2d, int centerX, int centerY, int radius) {
// Parcourt les segments de 0 à 5 pour dessiner chaque segment en fonction du terrain associé
for (int i = 0; i < 6; i++) {
@@ -71,6 +121,14 @@ public class HexagonTile extends JPanel {
}
}
/**
* Crée un hexagone à partir des coordonnées centrales et du rayon.
*
* @param centerX La coordonnée X du centre de l'hexagone.
* @param centerY La coordonnée Y du centre de l'hexagone.
* @param radius Le rayon de l'hexagone.
* @return La forme hexagonale créée.
*/
private Shape createHexagon(int centerX, int centerY, int radius) {
Path2D hexagon = new Path2D.Double();
for (int i = 0; i < 6; i++) {
@@ -87,6 +145,12 @@ public class HexagonTile extends JPanel {
return hexagon;
}
/**
* Récupère la couleur associée à un type de terrain.
*
* @param terrain Le type de terrain à évaluer.
* @return La couleur correspondant au type de terrain.
*/
private Color getTerrainColor(TerrainType terrain) {
if (terrain == null) {
return Color.WHITE;