{{backlinks>.}}

====== Rectangle ======

  * Ouvrir [[icn>python:pygram:installer|pygram.blend]]
  * Créer un [[icn>blender:texte#nouveau_fichier|nouveau fichier texte]] nommé ''shapes.py''
  * Écrire une **[[icn>python:fonction|fonction]]** ''rectangle(x,y,w,h)'' permettant de créer des rectangles de toutes dimensions et positionnés sur n'importe quel point du plan. Nous pourrons, pour tester cette fonction, l'appeler deux fois pour créer les deux rectangles suivants :

  * Un rectangle positionné à l'origine, de 5m de large et 10m de haut
  * Un rectangle positionné contre le premier rectangle ayant les mêmes dimensions

  * Voir plus bas les **[[#détails]]** de construction.

{{:python:pygram:pygram_rectangle.png}}


===== Détails =====


==== En-tête ====

  * Commencer par ajouter ce code :

<code python>
import bpy
Pygram = bpy.data.texts["pygram.py"].as_module()
Pygram.cleanup()
</code>


==== Créer ====

Il s'agit donc de **créer** une fonction ''rectangle(x,y,w,h)'' prenant **4 [[icn>python : fonction#arguments|arguments]]** et permettant de créer des rectangles à partir d'une coordonnée (x,y) dans l'espace et aux dimensions voulues : en largeur (''w'' pour //width//) et en hauteur (''h'' pour ''height''). Les objets produits par la fonction ''rectangle()'' doivent être nommés « ''rectangle'' ».


Pour créer cette fonction ''rectangle()'', il faut se servir des **[[python:pygram:objet|fonctions]] de Pygram** telles qu'illustrées dans le [[https://fordj.org/rvba/fordj/src/branch/main/engine/alphengine/scripts/script.py|script.py]] ((''obj.point()'', ''obj.face()'',...)) d'exemple mais en y ajoutant des //variables// qui serviront de //paramètres// pour la création de rectangles de toutes dimensions.

==== Utiliser ====

Cette fonction doit ensuite être **utilisée deux fois** ((On dit plutôt « appeler » une fonction)) pour générer les deux rectangles.