Référence API Python

pivot()

Crée une charnière, une soudure, un moteur, des butées.

Syntaxe

pivot(x=0, y=0, corps=None, moteur=None, vitesse=None, couple=None, frein=None,
      fixe_au_fond=None, soude=None, butees=None, contact=None, etage=None)
pivot(x=0, y=0, bodies=None, motor=None, speed=None, torque=None, brake=None,
      to_ground=None, welded=None, limits=None, collide=None, floor=None)   # anglais

Description

Crée un pivot au point (x, y), qui relie les pièces de corps. Une pièce seule : charnière au monde. Deux pièces : charnière entre elles. Avec soude=True, jusqu'à 16 pièces : elles ne font plus qu'une (un arbre). La première pièce est la référence : elle porte le moteur et les butées.

Paramètres

Paramètre	Type	Description	Défaut
`x`, `y`	nombre	le point de rotation, en mm	0, 0
`corps` / `bodies`	objet ou liste	1 ou 2 objets (charnière), 1 à 16 (`soude=True`). Ni pivot ni ressort	obligatoire
`moteur` / `motor`	booléen	le pivot tourne tout seul	`False`
`vitesse` / `speed`	nombre	tr/min, de −600 à 600 ; positif = sens des aiguilles	60
`couple` / `torque`	nombre	couple max en N·m, de 0 à 1 000 000	1000
`frein` / `brake`	booléen	bloque la rotation (exclusif avec `moteur`)	`False`
`fixe_au_fond` / `to_ground`	booléen	avec 2 pièces : le point ne bouge pas dans le monde	`False`
`soude` / `welded`	booléen	pas de rotation : les pièces sont solidaires	`False`
`butees` / `limits`	`(min, max)`	angles en degrés, −360 à 360, `min < max`, comptés depuis la pose de départ	aucune
`contact` / `collide`	booléen	les deux pièces se touchent (par défaut elles se traversent)	`False`
`etage` / `floor`	entier	0 à 15	celui de la première pièce

Valeur retournée

Le pivot (.type vaut "pivot", .x, .y se lisent). Il ne sert généralement à rien de le garder.

Exemple

sol(x=0, y=250)
chassis = rectangle(x=0, y=0, largeur=300, hauteur=20, materiau="bois")
roue_g = cercle(x=-100, y=60, rayon=40, materiau="caoutchouc")
roue_d = cercle(x=100, y=60, rayon=40, materiau="caoutchouc")
pivot(x=-100, y=60, corps=[roue_g, chassis], moteur=True, vitesse=120, couple=2)
pivot(x=100, y=60, corps=[roue_d, chassis], moteur=True, vitesse=120, couple=2)
camera.suivre(chassis)

Essayer ce code dans l’atelier Python

Erreurs possibles

Un pivot demande au moins 1 objet(s) à relier.
Un pivot relie 1 à 2 objets (tu en as donné 3). Pour rendre plusieurs pièces solidaires d'un même axe, utilise un axe : axe(x, y, corps=[...]).
Un pivot ne peut relier que des objets, pas un spring.
Un pivot soudé ne tourne pas : il n'a ni moteur, ni frein, ni butées.
Un pivot ne peut pas être à la fois moteur et freiné.
« limits » attend deux angles, par exemple limits=(-45, 45)., Une butée va du plus petit au plus grand angle.
« to_ground » ne sert qu'avec deux objets.
Bornes : « vitesse » va de -600 à 600, « couple » va de 0 à 1000000, « limits[0] » va de -360 à 360.

Notes

Le pivot est toujours un corps fixe dans la scène (.fixe vaut True) : c'est la tige.
Un moteur qui n'atteint pas sa vitesse sature (couple trop faible) — voir Le moteur de pivot.
Une butée est un ressort très raide : le bras rebondit de quelques degrés. Pour un arrêt franc, un bloc fixe.