DESCRIPTION.

La procédure PROC_b2SetActive() active ou désactive un corps dans un monde physique Box2d.

SYNTAXE.

PROC_b2SetActive( 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 est inactif.

L'appel de la procédure PROC_b2SetActive() est une manière efficace de désactiver temporairement un objet pour économiser les ressources du CPU et/ou rendre un objet inactif lorsqu’il est hors-champ. Si statut vaut 0, corps n'est plus actif dans le monde physique Box2d, il ne prend plus part à la simulation, il ne entrer en collision avec d'autres corps, il ne bouge plus et son état n’est pas mis à jour.

Note : un corps désactivé reste dans le monde, mais il devient “invisible” pour la physique.

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_b2SetActive() 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_b2SetActive( kprojectile , 1 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END