DESCRIPTION.

La procédure PROC_b2SetAllowSleep() active ou désactive le mode inactif d’un corps dans un monde physique Box2d.

SYNTAXE.

PROC_b2SetAllowSleep( 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 ne peut pas être inactif ; 

- 0, corps peut être inactif .

Dans Box2D, on dit qu'un corps dort lorsqu’il est inactif, c'est le cas si un corps ne bouge plus, sa vitesse est nulle, et/ou qu'il n’est plus soumis à des forces significatives.

Endormir un corps permet d' économiser les ressources du CPU, de stabiliser la simulation, d'éviter les tremblements microscopiques, de ne plus recalculer sa physique tant qu’il reste immobile.

Interdire un corps de s'endormir s'avère utile lorsque qu'il doit toujours être actif pour réagir immédiatement même si immobile, que l'application doit observer des forces petites mais continues, par exemple un moteur ou engrenage où le sommeil casse la dynamique, ou si le corps est piloté par l'utilisateur.

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_b2SetAllowSleep() 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 ---

PROC_b2Init

kmonde = FN_b2CreateWorld( 0 , -9.81 )

REM --- Creation d'un projectile monde ---

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

PROC_b2SetAllowSleep( kprojectile , 1 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END