DESCRIPTION.

La fonction FN_b2WheelJoint() permet de lier deux en simulant une roue sur un pignon se déplaçant sur un axe dans un monde physique Box2d.

SYNTAXE.

ksoudure = FN_b2WheelJoint( monde , chassis , roue , abscisse , ordonnee , axex , axey , raideur , amortissement )

REMARQUES.

monde doit être l'identifiant de la variable ayant reçu la valeur retournée par l'appel de la fonction FN_b2CreateWorld() et qui indique donc le monde physique dans lequel on crée le corps.

roue et chassis doivent être les identifiants des variables des deux corps à lier.

abscisse et ordonnee doivent être des valeurs numériques indiquant les coordonnées, du point d’attache servant de référence pour figer les positions relatives de corpsa et de corpsb dans monde.

axex et axey doivent être des valeurs numériques indiquant les coordonnées, du point d’attache servant de référence pour figer les positions relatives de corpsa et de corpsb dans monde.

raideur doit être une valeur numérique indiquant le type de rigidité à respecter pour la distance entre les deux corps. Plus la valeur de raideur est grande, plus la soudure est rigide, peu mobile, sauf pour la valeur 0, qui annule toute élasticité à la soudure en la rendant totalement rigide. Les valeurs typique pour raideur sont : 

- de 0 à 4, pas de suspension ;

- de 2 à 4, pour simuler une suspension molle ;

- de 4 à 8, pour simuler une suspension plutot réaliste ;

- à partir de 10, pour simuler une suspension très rigide.

amortissement doit être une valeur numérique indiquant l’amortissement des oscillations à respecter si raideur est différent de 0. Par exemple, si amortissement vaut :

- de 0,2 à 0,3, pour simuler une suspension molle ;

- de 0,6 à 0,8, pour simuler une suspension plutot réaliste ;

- 1, pour simuler une suspension très rigide.

L'appel de la fonction FN_b2WheelJoint() va créer une translation de roue par rapport à chassis le long d’un axe, et autorisant une rotation libre pour roue, et en permettant un effet ressort et un amortisseur grâce aux paramètres raideur et amortisseur.

On pourra utiliser la fonction FN_b2WheelJoint() pour les déplacements des véhicules voitures, simuler des suspensions ou des plateformes amorties.

L'appel de la fonction FN_b2WheelJoint() retourne un identifiant du lien qui devra être utilisé comme paramètre dans les procédures et fonctions du module box2dlib.bbc. Il est indispensable de mémoriser cette valeur dans une variable pour pouvoir y faire référence ultérieurement.

La procédure PROC_b2WheelMotorSpeed() qui définit la vitesse d'un lien simulant une roue sur un pignon.

Rappel : la procédure PROC_b2Init devra toujours être appelée avant tout autre fonction ou procédure de box2dlib.bbc.

La fonction FN_b2WheelJoint() est importée depuis le module box2dlib.bbc. 

RUBRIQUES.

Les dessins et les graphismes pour plus de détails sur la création de dessins et de graphismes.

La gestion des couleurs pour plus de détails sur la gestion des couleurs logiques et physiques.

EXEMPLE.

REM --- Importation des modules ---

REM --- Module de la bibliothèque BBC BASIC ---

INSTALL @lib$ + "box2dlib.bbc"

REM --- INITIALISATION GENERALE ---

REM --- Initialisation et création du monde ---

PROC_b2Init

kmonde = FN_b2CreateWorld( 0 , -9.81 )

REM --- Creation des corps ---

kchassis = FN_b2DynamicBody( kmonde , 0 , 2 , 2 , .5 , 1 , 0 , 0, 0 )

kroue = FN_b2DynamicBody( kmonde , 0 , 1.2 , .4 , 1 , 0 , 0, 0 )

REM --- Creation d'un lien prismatique ---

kpignon = FN_b2WheelJoint( kmonde , kchassis , kroue , 0 , 1.2 , 0 , 1 , 4 , .7 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END