DESCRIPTION.

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

SYNTAXE.

kvaleur = FN_b2UserDataBody( corps )

REMARQUES.

corps doit être l'identifiant de la variable ayant reçu la valeur retournée par l'appel d'une fonction créant un nouveau corps statique, dynamique ou cinétique.

La procédure FN_b2UserDataBody() retourne une valeur numérique personnalisée qui permet d'identifier de façon unique un corps. 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_b2UserDataBody() qui associe une valeur numérique personnalisée à un corps.

La procédure FN_b2UserDataBody() 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