Référence API Python
engrenage()
Crée une roue dentée, définie par ses dents et son module.
Syntaxe
engrenage(x=0, y=0, dents=None, module=None, angle=0, materiau=None, couleur=None, fixe=None, etage=None)
gear(x=0, y=0, teeth=None, module=None, angle=0, material=None, color=None, fixed=None, floor=None) # anglais
Description
Crée un engrenage à denture externe, centré en (x, y). Son rayon primitif vaut module × dents / 2 — il se lit (.rayon), il ne se donne pas. Un engrenage créé par script naît libre : sans pivot() ni fixe=True, il tombe. Avec fixe=True, il tourne sur place (un engrenage à la souris naît ainsi).
Paramètres
| Paramètre | Type | Description | Défaut |
|---|---|---|---|
x, y | nombre | le centre, en mm | 0, 0 |
dents / teeth | entier | le nombre de dents, de 4 à 200 | 20 |
module | nombre | la taille d'une dent en mm, de 2 à 100 — deux roues n'engrènent que si leurs modules sont égaux | 10 |
angle | nombre | la rotation initiale en degrés ; mecanique.engrener() la règle pour mettre les dents en phase | 0 |
materiau / material | texte | acier, bois… | "standard" |
couleur / color | texte | celle du matériau | |
fixe / fixed | booléen | True : la roue tourne sur place, montée sur un axe implicite à son centre (c'est l'état d'un engrenage tracé à la souris). Un pivot() explicite fait pareil, avec en plus le moteur et les butées | False |
etage / floor | entier | 0 à 15 ; deux roues n'engrènent qu'au même étage | 0 |
Valeur retournée
L'objet créé : .dents, .module, .rayon (primitif), .masse se lisent.
Exemple
petit = engrenage(x=-100, y=0, dents=12, module=10, materiau="acier")
grand = engrenage(dents=36, module=10, materiau="acier")
mecanique.engrener(petit, grand, sens=0)
pivot(x=petit.x, y=petit.y, corps=petit, moteur=True, vitesse=60, couple=10)
pivot(x=grand.x, y=grand.y, corps=grand)
print("rayons :", petit.rayon, grand.rayon, "- rapport :", mecanique.rapport(petit, grand))
Erreurs possibles
Un engrenage a un nombre ENTIER de dents (tu as demandé 12.5).« dents » va de 4 à 200,« module » va de 2 à 100.- Les erreurs communes (type, matériau, étage).
Notes
- L'engrènement est détecté par le labo : deux roues au bon entraxe, même module, même étage, sont en prise —
mecanique.engrener()garantit ces conditions. - Un engrenage a un amortissement de 2,0 (rotation et déplacement) : libre, il s'arrête vite.
- Les dentures internes (couronnes) ne se créent pas par script.
- Le « Réglages Moteur » propre à l'engrenage (celui de la souris) ne se règle pas par script : motorise son pivot.