TortueGraphique 2.0.0

🐢 TortueGraphique

Bibliothèque de dessin graphique style Logo/Tortue pour .NET 8.0 Windows Forms.

Créez facilement des dessins, des animations et des jeux éducatifs avec une API simple et intuitive inspirée du langage Logo.

✨ Fonctionnalités

• 🐢 API style Logo : Commandes intuitives (Avancer, Tourner, etc.)
• 🎨 Primitives de dessin : Points, traits, cercles, polygones, texte
• 🎭 Couches transparentes : Superposez plusieurs dessins
• ✨ Rendu haute qualité : Antialiasing et optimisation GDI+
• 🎨 Gestion des couleurs : Color, RGB, RGBA avec transparence
• 📐 Formes géométriques : Carré, rectangle, cercle, polygones réguliers
• 📝 Support du texte : Polices personnalisables, tailles, styles
• 🔄 Pattern Dispose : Gestion automatique des ressources

📦 Installation

Via .NET CLI

dotnet add package TortueGraphique

Via Package Manager Console

Install-Package TortueGraphique

Via Visual Studio

1. Clic droit sur le projet → Gérer les packages NuGet
2. Rechercher "TortueGraphique"
3. Cliquer sur Installer

🚀 Démarrage rapide

Exemple simple : Dessiner un carré

using TortueGraphique.Lib.Graphics;
using System.Drawing;
using System.Windows.Forms;

// Créer une tortue sur fond blanc (800x600)
using var tortue = new Tortue(800, 600);

// Dessiner un carré rouge
tortue.ChangerCouleur(Color.Red);
tortue.ChangerEpaisseur(3);
tortue.BaisserStylo();

for (int i = 0; i < 4; i++)
{
    tortue.Avancer(100);
    tortue.TournerDroite(90);
}

// Afficher dans un PictureBox
pictureBox.Image = tortue.ObtenirBitmap();

Résultat

Un carré rouge de 100 pixels de côté avec un trait de 3 pixels d'épaisseur.

📚 Documentation

Commandes de déplacement

tortue.Avancer(100);           // Avance de 100 pixels
tortue.Reculer(50);            // Recule de 50 pixels
tortue.TournerDroite(90);      // Tourne de 90° vers la droite
tortue.TournerGauche(45);      // Tourne de 45° vers la gauche
tortue.DefinirAngle(0);        // Définit l'angle absolu (0° = droite)

Gestion du stylo

tortue.BaisserStylo();                    // Active le dessin
tortue.LeverStylo();                      // Désactive le dessin
tortue.ChangerCouleur(Color.Blue);        // Change la couleur
tortue.ChangerCouleur(255, 0, 0);         // Rouge en RGB
tortue.ChangerEpaisseur(5);               // Change l'épaisseur du trait

Positionnement

tortue.AllerA(400, 300);       // Téléporte sans tracer
tortue.AllerVers(400, 300);    // Déplace en traçant (si stylo baissé)
tortue.Centrer();              // Revient au centre du canvas
tortue.Reinitialiser();        // Réinitialise position, angle et stylo

Formes rapides

tortue.Carre(100);             // Carré de 100 pixels de côté
tortue.Rectangle(150, 80);     // Rectangle 150x80
tortue.Cercle(50);             // Cercle de rayon 50
tortue.Polygone(6, 80);        // Hexagone (6 côtés de 80px)

Texte

// Texte simple
tortue.Texte("Hello!", 24);

// Avec police personnalisée
tortue.Texte("Bonjour", 20, "Arial");

// Avec style
tortue.Texte("Bold", 18, "Arial", FontStyle.Bold);

// Avec couleur spécifique
tortue.Texte("Red", 16, "Arial", Color.Red);

Primitives de dessin

// Point
tortue.Point(100, 100, Color.Red, diametre: 5);
tortue.Point(150, 150, 255, 0, 0, diametre: 10);  // RGB

// Trait
tortue.Trait(0, 0, 100, 100, Color.Blue, TypeBoutTrait.Arrondi, epaisseur: 3);

🎭 Couches transparentes

Utilisez TortueCouche pour créer des dessins superposés avec fond transparent.

using TortueGraphique.Lib.Graphics;
using System.Drawing;

// Couche de fond (opaque)
using var fond = new Tortue(800, 600);
fond.ChangerCouleur(Color.Blue);
fond.Cercle(150);

// Couche transparente
using var couche = new TortueCouche(800, 600);
couche.ChangerCouleur(Color.FromArgb(128, 255, 0, 0)); // Rouge semi-transparent
couche.AllerA(400, 300);
couche.Carre(100);

// Fusionner les couches
Bitmap resultat = new Bitmap(fond.ObtenirBitmap());
using (Graphics g = Graphics.FromImage(resultat))
{
    g.DrawImage(couche.ObtenirBitmap(), 0, 0);
}

pictureBox.Image = resultat;

🎮 Exemple : Spirale colorée

using var tortue = new Tortue(800, 600);
tortue.BaisserStylo();

int[] couleurs = { 
    Color.Red.ToArgb(), 
    Color.Orange.ToArgb(), 
    Color.Yellow.ToArgb(), 
    Color.Green.ToArgb(), 
    Color.Blue.ToArgb(), 
    Color.Purple.ToArgb() 
};

for (int i = 0; i < 360; i++)
{
    tortue.ChangerCouleur(Color.FromArgb(couleurs[i % couleurs.Length]));
    tortue.Avancer(i * 0.5f);
    tortue.TournerDroite(59);
}

pictureBox.Image = tortue.ObtenirBitmap();

🎨 Exemples d'utilisation

Fractale : Arbre

void DessinerArbre(Tortue tortue, float longueur, int profondeur)
{
    if (profondeur == 0) return;

    tortue.Avancer(longueur);
    
    // Branche droite
    tortue.TournerDroite(30);
    DessinerArbre(tortue, longueur * 0.7f, profondeur - 1);
    tortue.TournerGauche(30);
    
    // Branche gauche
    tortue.TournerGauche(30);
    DessinerArbre(tortue, longueur * 0.7f, profondeur - 1);
    tortue.TournerDroite(30);
    
    tortue.Reculer(longueur);
}

// Utilisation
using var tortue = new Tortue(800, 600);
tortue.AllerA(400, 550);
tortue.DefinirAngle(90); // Vers le haut
tortue.ChangerCouleur(Color.Green);
tortue.BaisserStylo();
DessinerArbre(tortue, 100, 8);

Jeu simple

Consultez le projet d'exemple JeuxBalle pour voir comment créer un jeu de casse-briques complet avec gestion des collisions et animations.

🛠️ Configuration requise

• .NET 8.0 ou supérieur
• Windows (utilise GDI+ via System.Drawing)
• Windows Forms pour l'affichage

📄 Licence

Ce projet est sous licence MIT.

🤝 Contribution

Les contributions sont les bienvenues ! N'hésitez pas à :

• Signaler des bugs
• Proposer de nouvelles fonctionnalités
• Soumettre des pull requests

👤 Auteur

Marc - Développeur passionné par la programmation graphique et l'éducation

🙏 Remerciements

Inspiré par le langage Logo et les tortues graphiques de Seymour Papert.

📝 Changelog

Version 1.0.0 (2025-01-21)

• 🎉 Première version publique
• ✨ API complète de dessin style Logo
• 🎭 Support des couches transparentes
• 📝 Support du texte avec polices personnalisées
• 🎨 Rendu haute qualité avec antialiasing
• 🔄 Pattern IDisposable pour gestion des ressources

💡 Astuce : Utilisez using avec vos tortues pour libérer automatiquement les ressources !

using var tortue = new Tortue(800, 600);
// Pas besoin d'appeler Dispose() manuellement

🔄 Version 2.0.0 - Breaking Change

**Important 😗* À partir de la version 2.0.0, le système de coordonnées a changé !

Avant (v1.x)

// Centre du canvas 800x600 était à (400, 300)
Tortue tortue = new Tortue(800, 600);
tortue.AllerA(400, 300);  // Centre

Maintenant (v2.x)

// Centre du canvas est maintenant à (0, 0)
Tortue tortue = new Tortue(800, 600);
tortue.AllerA(0, 0);      // Centre
tortue.Centrer();         // Ou utilisez Centrer()

Migration

Pour migrer votre code de v1.x vers v2.0 :

• Coordonnées X : nouveauX = ancienX - largeur/2
• Coordonnées Y : nouveauY = ancienY - hauteur/2

Exemple pour un canvas de 800x600 :

• AllerA(400, 300) devient AllerA(0, 0)
• AllerA(200, 150) devient AllerA(-200, -150)
• AllerA(600, 450) devient AllerA(200, 150)

✨ Nouveautés v2.0.0

Méthodes ArcDroite et ArcGauche

Dessinez des arcs de cercle courbes :

tortue.ArcDroite(90, 100);   // Arc de 90° à droite, rayon 100
tortue.ArcGauche(180, 50);   // Arc de 180° à gauche, rayon 50

Les arcs respectent l'état du stylo (levé/baissé).