Référence API Python
dessin()
Crée une forme libre à partir de ses points.
Syntaxe
dessin(points=None, angle=0, materiau=None, couleur=None, fixe=None, etage=None)
shape(points=None, angle=0, material=None, color=None, fixed=None, floor=None) # anglais
Description
Crée un solide au contour donné par points, une liste de couples (x, y) en coordonnées du monde (mm). Le contour est refermé automatiquement ; la pièce est recentrée sur son centre de gravité (.x, .y sont ceux du centroïde) et découpée en morceaux convexes pour le moteur. Les paramètres x et y existent mais les points, eux, sont absolus.
Paramètres
| Paramètre | Type | Description | Défaut |
|---|---|---|---|
points | liste de (x, y) | au moins 3 points, dans l'ordre du contour, sans croisement | obligatoire |
angle | nombre | rotation en degrés | 0 |
materiau, couleur, fixe, etage | comme rectangle() |
Valeur retournée
L'objet créé (.type vaut "freeform", .masse = densité × aire).
Exemple
import math
# Une came en escargot : le rayon grandit sur 300 degres, puis retombe.
pts = []
for k in range(61):
a = math.radians(270 - k * 5)
r = 100 + 40 * k / 60
pts.append((r * math.cos(a), r * math.sin(a)))
came = dessin(points=pts, materiau="bois", couleur="#d97706")
pivot(x=0, y=0, corps=came, moteur=True, vitesse=20)
galet = cercle(x=0, y=-200, rayon=15, materiau="acier")
Erreurs possibles
Un dessin demande au moins 3 points (tu en as donné 2).« points[3].x » attend un nombre— un point mal écrit.- Un contour qui se croise donne une forme inattendue (pas d'erreur).
Notes
- Un galet rond suit mieux une came qu'un coin de planche : les coins accrochent les facettes du polygone.
- Une marche à pic sur une came fait sauter le suiveur ; une pente raide sur quelques degrés passe.
- Le trait de pinceau n'a pas de fonction : décris ses deux bords comme un seul contour.