DESCRIPTION.

La fonction FN_b2UserDataJoint() retourne la valeur numérique personnalisée associée à un lien entre deux corps dans un monde physique Box2d.

SYNTAXE.

kvaleur = FN_b2UserDataJoint( lien )

REMARQUES.

lien doit être l'identifiant de la variable ayant reçu la valeur retournée par l'appel d'une fonction créant un nouveau lien, ou jointure, entre deux corps.

La fonction FN_b2UserDataJoint() retourne une valeur numérique personnalisée qui permet d'identifier de façon unique un lien entre deux. Si l'on doit utiliser cette valeur pour effectuer des actions sur ce corps il faudra, de préférence, l'affecter à une variable. 

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

Voir la fonction PROC_b2UserDataJoint() qui associe une valeur numérique personnalisée à un lien entre deux corps.

La procédure FN_b2UserDataJoint() 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 d'un projectile ---

kprojectile01 = FN_b2DynamicBody( kmonde , 10 , 5 , .64 , 15 , -.5 , -.25 , .02 , 0 )

PROC_b2UserDataBody( kprojectile01 , 2001 ) : REM - par exemple 20 pour projectile et 01 pour le premier de ce type

PRINT FN_b2UserDataBody( kprojectile01 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END