DESCRIPTION.

La procédure PROC_b2SetAwake() permet d'indiquer manuellement si corps doit participer aux interactions dans un monde physique Box2d.

SYNTAXE.

PROC_b2SetAwake( corps , statut )

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.

statut doit être un nombre entier quelconque mais valide, Si statut vaut : 

- toute valeur différente de 0, 1 en général, corps est actif et interagit avec les autres corps ; 

- 0, corps ne participe pas aux différent calculs temporairement.

Dans un monde physique Box2D, chaque corps physique possède un état appelé : 

- awake, réveillé, état par défaut, dans lequel le corps participe aux calculs de physique à chaque frame, ou ;

- asleep, endormi, dans lequel le corps cesse temporairement les calculs pour optimiser la performance.

L'appel de la procédure PROC_b2SetAwake() permet de faire basculer, temporairement, un corps d'un état à l'autre, pour économiser les ressources du CPU. Si statut vaut 0, corps sera dans l'état asleep, endormi, il restera alors statique jusqu'à ce qu’une force ou collision le réveille.

Voir la fonction FN_b2IsAwake() qui retourne l'état réveillé / endormie d'un corps.

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

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