Référence API Python
axe()
Un arbre : plusieurs pièces solidaires d'un même axe, qui tourne sur place.
Syntaxe
axe(x=0, y=0, corps=None, moteur=None, vitesse=None, couple=None, frein=None, butees=None, etage=None)
axle(x=0, y=0, bodies=None, motor=None, speed=None, torque=None, brake=None, limits=None, floor=None) # anglais
Description
Crée en une fois : une charnière au monde sur la première pièce (avec le moteur, le frein, les butées éventuels), puis une soudure de toutes les pièces entre elles. Résultat : elles tournent ensemble, à la même vitesse, même sur des étages différents. C'est la tige d'une montre : grande roue, pignon, aiguille.
Paramètres
| Paramètre | Type | Description | Défaut |
|---|---|---|---|
x, y | nombre | le point de l'axe | 0, 0 |
corps / bodies | objet ou liste | 1 à 16 pièces ; la première porte la charnière | obligatoire |
moteur, vitesse, couple, frein, butees, etage | comme pivot(), appliqués à la charnière |
Valeur retournée
La charnière (le premier pivot). La soudure n'est pas rendue.
Exemple
grande = engrenage(x=0, y=0, dents=30, module=8, etage=0, materiau="acier")
pignon = engrenage(x=0, y=0, dents=10, module=8, etage=1, materiau="acier")
aiguille = rectangle(x=60, y=0, largeur=140, hauteur=6, etage=2, couleur="#ef4444")
axe(x=0, y=0, corps=[grande, pignon, aiguille], moteur=True, vitesse=10)
sortie = engrenage(dents=30, module=8, etage=1)
mecanique.engrener(pignon, sortie, sens=0)
pivot(x=sortie.x, y=sortie.y, corps=sortie)
Erreurs possibles
Un axe porte au moins une piece : axe(x, y, corps=[roue, pignon]).(ValueError, quandcorpsmanque ou est vide).- Celles de pivot() (16 pièces au plus, moteur et frein exclusifs…).
Notes
- Une pièce ne peut appartenir qu'à un seul arbre.
- Les engrènements ne se font qu'entre roues du même étage : un arbre sert justement à changer d'étage entre deux réductions.