Référence API Python
rectangle()
Crée une planche ou un bloc rectangulaire.
Syntaxe
rectangle(x=0, y=0, largeur=None, hauteur=None, angle=0, materiau=None, couleur=None, fixe=None, etage=None)
rectangle(x=0, y=0, width=None, height=None, angle=0, material=None, color=None, fixed=None, floor=None) # anglais
Description
Crée un rectangle centré en (x, y). Sans dimensions, il fait 100 × 50 mm. La pièce est libre (elle tombe) sauf fixe=True.
Paramètres
| Paramètre | Type | Description | Défaut |
|---|---|---|---|
x, y | nombre | le centre, en mm (y vers le bas) | 0, 0 |
largeur / width | nombre | la largeur, de 1 à 10 000 mm | 100 |
hauteur / height | nombre | la hauteur, de 1 à 10 000 mm | 50 |
angle | nombre | l'inclinaison en degrés, sens des aiguilles | 0 |
materiau / material | texte | bois, caoutchouc, verre, glace, pierre, acier, or, helium, standard (ou l'anglais) | "standard" |
couleur / color | texte | "#a16207" ou un nom de couleur | celle du matériau |
fixe / fixed | booléen | True : ne bouge pas (un mur, un support) | False |
etage / floor | entier | l'étage, 0 à 15 | 0 |
Valeur retournée
L'objet créé (voir Les objets) : on le garde dans une variable pour le relier (pivot(corps=...)), l'accrocher (ressort(a=...)), le lire (.masse) ou le suivre (camera.suivre(...)). Jamais None.
Exemple
sol(x=0, y=250)
support = rectangle(x=0, y=150, largeur=20, hauteur=200, fixe=True, materiau="pierre")
bras = rectangle(x=60, y=40, largeur=240, hauteur=10, angle=-15, materiau="bois", couleur="#a16207")
pivot(x=0, y=40, corps=[bras, support], butees=[-40, 40])
print(bras.masse, "kg")
Erreurs possibles
« largeur » attend un nombre (tu as donné "100")— un nombre, sans guillemets.« largeur » va de 1 à 10000 (tu as demandé 0).Le matériau « fer » n'existe pas…,Les étages vont de 0 à 15…,Un étage est un nombre ENTIER….tu as donné deux fois le même réglage, avec des valeurs différentes—largeur=etwidth=ensemble avec des valeurs différentes.
Notes
- La masse vaut densité × largeur × hauteur (en m²) : 200 × 20 mm de bois → 0,28 kg.
- Amortissements posés par le moteur : 0,5 en rotation, 0,5 en déplacement.
- Un rectangle se coupe au couteau, se redimensionne à la souris ; ni l'un ni l'autre par script.