DESCRIPTION.

La procédure PROC_b2UserDataFixture() associe une valeur numérique personnalisée à une fixture dans un monde physique Box2d, et qui permettra de l'identifier de façon unique ultérieurement.

SYNTAXE.

PROC_b2UserDataFixture( fixture , donnee )

REMARQUES.

fixture doit être l'identifiant de la variable ayant reçu la valeur retournée par l'appel d'une fonction ayant créée une fixture.

donnee doit être un nombre entier quelconque mais valide.

La procédure PROC_b2UserDataFixture() permet de stocker un nombre entier personnalisant une fixture dans un monde Box2D, afin de pouvoir l’identifier plus tard. 

Vous pouvez y mettre un identifiant pour identifier un type de corps (ex : 1 = ennemi, 2 = plateforme, 3 = joueur…), l’adresse d’une structure mémoire BBC BASIC for SDL 2.0, une adresse de fonction de callback, un pointeur vers un sprite, un index de table, etc.

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

Voir la fonction FN_b2UserDataFixture() qui retourne la valeur numérique personnalisée associée à une fixture.

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

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

REM --- Création d'une fixture rectangulaire ---

kplateauF = FN_b2BoxFixture( kplateau , 0 , 0 , 0 , 1 , 0.5 , 0.3 , 0.2 , 1.0 )

PROC_b2UserDataFixture( kplateauF , 5 )

PRINT FN_b2UserDataFixture( kplateauF )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END