DESCRIPTION.

La fonction FN_b2RopeJoint() permet de créer un lien souple mais non extensible entre deux corps dans un monde physique Box2d.

SYNTAXE.

kcorde = FN_b2RopeJoint( monde , ancre , satellite , ancrex , ancrey , satellitex , satellitey , taille )

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.

ancre et satellite doivent être les identifiants des variables des deux corps à lier.

ancrex et ancrey doivent être des valeurs numériques indiquant les coordonnées, du point d’attache sur ancre. 

satellitex et satellitey doivent être des valeurs numériques indiquant les coordonnées, du point d’attache sur satellite. 

taille doit être une valeur numérique indiquant la longueur maximum qui peut exister entre ancre et satellite.

L'appel de la fonction FN_b2RopeJoint() va créer une liaison virtuelle souple non extensible entre deux corps, comme s'ils étaient relier par une corde ou une chaine. Cette liaison empêchera les deux points d'attache aux corps de s’éloigner au-delà d’une longueur maximale, mais n’exerce aucune poussée.C e type de liaison agit uniquement en traction sur les deux points d'attache, jamais en compression. La distance entre les deux points d'attache peut se réduire, mais elle ne pourra jamais dépasser taille:. On pourra l'utiliser pour simuler une corde, un cable, une chaine, une laisse, un pendule suspendu, un pont suspendu simple.

L'appel de la fonction FN_b2RopeJoint() 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.

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

La fonction FN_b2RopeJoint() 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 ---

kmain = FN_b2DynamicBody( kmonde , 2 , 1 , 0 , 10 , -1 , 0 , .1 , 0 )

kballon = FN_b2DynamicBody( kmonde , 2 , 1 , 0 , 10 , -1 , 0 , .1 , 0 )

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

kcorde = FN_b2RopeJoint( kmonde , kmain , kballon , 0 , 2 , 2 , 2 , 1.8 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END