DESCRIPTION.

La fonction FN_b2IsAwake() retourne la masse d'un corps dans un monde physique Box2d.

SYNTAXE.

ketat = FN_b2IsAwake( 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.

Dans un monde physique Box2D, chaque corps physique possède un état appelé awake, il est réveillé, état par défaut, dans lequel le corps participe aux calculs de physique à chaque frame, ou asleep, il est endormi pour économiser des ressources, c'est-à-dire qu'il n'est pas pris en compte dans les calculs tant qu’une collision ou une force ne le réveille. L'appel de la fonction  FN_b2IsAwake() interroge donc le moteur Box2D pour récupérer la valeur 1 pour éveillé ou 0 pour endormi.

Voir la procédure PROC_b2SetAwake() qui permet de forcer manuellement un état réveillé / endormie pour un corps.

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

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

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

PROC_b2SetAwake( kprojectile , 1 )

PRINT FN_b2GetMass( kprojectile )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END