diff --git a/dessiner/dessiner.py b/dessiner/dessiner.py new file mode 100644 index 0000000..da79d49 --- /dev/null +++ b/dessiner/dessiner.py @@ -0,0 +1,175 @@ +"""Ce fichier permet de dessiner des formes à l'aide des fonctions suivantes + ++ triangle_equilateral(cote, info_feutre, coordonnees) ++ arc_de_cercle(rayon, angle, info_feutre, coordonnees) + + +Exemples d'utilisation : +>>> informations_feutre = {'écriture':'blue', 'fond':'#FF88FF', 'épaisseur':5} +>>> triangle_equilateral(50, informations_feutre, (50,100)) +>>> arc_de_cercle(75, 360, informations_feutre, (200,-200)) +""" + + +# Importation + +import turtle as trt +import random as rd + + +# Déclaration des fonctions privées + +def nouveau_stylo(ecriture, fond, largeur): + """Renvoie la référence d'un stylo configuré + + :: param ecriture(str) :: la couleur d'écriture ('red', '#FF0000') + :: param fond(str) :: la couleur de fond pour ce stylo + :: param largeur(int) :: la largeur du trait + :: return (Turtle) :: renvoie un objet de la classe Turtle + + """ + feutre = trt.Turtle() + feutre.color(ecriture) + feutre.fillcolor(fond) + feutre.pensize(largeur) + feutre.speed(0) + return feutre + +def deplacer(feutre, x, y): + """Lève le feutre, déplace le feutre et abaisse le feutre + + :: param feutre(Turtle) :: la référence de l'objet Turtle + :: param x(int) :: coordonnée horizontale (abscisse) + :: param y(int) :: coordonnée verticale (ordonnée) + :: return (None) :: c'est une fonction sans retour + .. effet de bord :: modifie l'état de feutre + + """ + feutre.penup() # On lève la pointe + feutre.goto(x, y) # On déplace le crayon + feutre.pendown() # On abaisse la pointe + +def trace_triangle_equilateral(feutre, cote): + """Trace un triangle (equilatéral) à l'aide du crayon feutre + + :: param feutre(Turtle) :: la référence de l'objet Turtle + :: param cote(int) :: la valeur en pixel des côtés + :: return (None) :: fonction sans retour + .. effet de bord :: modifie l'état de feutre + + """ + feutre.begin_fill() + for x in range(3): + feutre.forward(cote) + feutre.left(120) + feutre.end_fill() + feutre.hideturtle() + +def trace_arc(feutre, rayon, angle): + """Trace un arc de cercle à l'aide du crayon feutre + + :: param feutre(Turtle) :: la référence de l'objet Turtle + :: param rayon(int) :: la valeur en pixel du rayon + :: param angle(int) :: l'angle à tracer (360 pour un cercle) + :: return (None) :: fonction sans retour + .. effet de bord :: modifie l'état de feutre + + """ + feutre.begin_fill() + feutre.circle(rayon, angle) + feutre.end_fill() + feutre.hideturtle() + +def trace_rectangle(feutre, largeur, longueur): + """Trace un rectangle à l'aide du crayon feutre + + :: param feutre(Turtle) :: la référence de l'objet Turtle + :: param longueur(int) :: la valeur en pixel des cotés sur la longueur + :: param largeur(int) :: la valeur en pixel des cotés sur la largeur + :: return (None) :: fonction sans retour + """ + feutre.begin_fill() + feutre.right(180) + feutre.forward(longueur) + feutre.right(90) + feutre.forward(largeur) + feutre.right(90) + feutre.forward(longueur) + feutre.right(90) + feutre.forward(largeur) + feutre.end_fill() + feutre.hideturtle() + + +# Déclarations des fonctions publiques + +def triangle_equilateral(cote, info_feutre, coordonnees): + """Trace un triangle (equilatéral) à partir des info_feutre et aux bonnees coordonnées + + :: param cote(int) :: la valeur en pixel des côtés + :: param info_feutre(dict) :: un dictionnaire {"écriture":str, "fond":str, "épaisseur":int} + :: param coordonnees(tuple (int,int) ) :: un tuple (x,y) + + """ + ecriture = info_feutre['écriture'] + fond = info_feutre['fond'] + epaisseur = info_feutre['épaisseur'] + x = coordonnees[0] # ou x,y = coordonnees (par désempaquetage) + y = coordonnees[1] + + feutre = nouveau_stylo(ecriture, fond, epaisseur) + deplacer(feutre, x, y) + trace_triangle_equilateral(feutre, cote) + + return feutre + +def arc_de_cercle(rayon, angle, info_feutre, coordonnees): + """Trace un arc de cercle à partir des info_feutre et aux bonnees coordonnées + + :: param rayon(int) :: la valeur en pixel du rayon + :: param angle(int) :: la valeur en ° de l'angle + :: param info_feutre(dict) :: un dictionnaire {"écriture":str, "fond":str, "épaisseur":int} + :: param coordonnees(tuple (int,int) ) :: un tuple (x,y) + + """ + ecriture = info_feutre['écriture'] + fond = info_feutre['fond'] + epaisseur = info_feutre['épaisseur'] + x = coordonnees[0] # ou x,y = coordonnees (par désempaquetage) + y = coordonnees[1] + + feutre = nouveau_stylo(ecriture, fond, epaisseur) + deplacer(feutre, x, y) + trace_arc(feutre, rayon, angle) + + return feutre + +def rectangle(largeur, longueur, info_feutre, coordonnees): + """Trace un rectangle à partir des info_feutre et aux bonnees coordonnées + + :: param largeur(int) :: la valeur en pixel des cotés de a largeur + :: param longueur(int) :: la valeur en pixel des cotés de la longueur + :: param info_feutre(dict) :: un dictionnaire {"écriture":str, "fond":str, "épaisseur":int} + :: param coordonnees(tuple (int,int) ) :: un tuple (x,y) + + """ + ecriture = info_feutre['écriture'] + fond = info_feutre['fond'] + epaisseur = info_feutre['épaisseur'] + x = coordonnees[0] # ou x,y = coordonnees (par désempaquetage) + y = coordonnees[1] + + feutre = nouveau_stylo(ecriture, fond, epaisseur) + deplacer(feutre, x, y) + trace_rectangle(feutre, largeur, longueur) + + return feutre + +# Instructions du programme principal + +if __name__ == '__main__': + + informations_feutre = {'écriture':"blue", 'fond':'#FF88FF', 'épaisseur':5} + triangle_equilateral(50, informations_feutre, (50,100)) + arc_de_cercle(75, 360, informations_feutre, (200,-200)) + rectangle(140, 80, informations_feutre, (300, -200)) \ No newline at end of file