DESCRIPTION.

La fonction FN_b2StaticBox() créer un corps statique rectangulaire, box, pour le moteur physique Box2D.

SYNTAXE.

kboite = FN_b2StaticBox( monde , abscisse , ordonnee , angle , longueur , hauteur )

REMARQUES.

monde doit être l'identifiant de la variable ayant reçu la valeur retournée par l'appel de la fonction FN_b2CreateWorld() et qui indique donc le monde physique dans lequel on crée le corps.

abscisse doit être une valeur numérique, indiquant l'abscisse initiale du centre du corps.

ordonnee doit être une valeur numérique, indiquant l'ordonnée du centre du corps.

angle doit être une valeur numérique, indiquant la valeur de l'inclinaison horizontale du corps, en radians.

longueur doit être une valeur numérique, indiquant la moitié de la longueur du corps.

hauteur doit être une valeur numérique, indiquant la moitié de la hauteur du corps.

Le corps statique, ou objet statique, créé par l'appel de la fonction FN_b2StaticBox() aura donc ;

- une longueur totale de 2 fois longueur ;

- une hauteur totale de 2 fois hauteur ;

- une inclinaison de angle radia par rapport à l'horizon ;

- son centre aux coordonnées  ( abscisse , ordonnee ).

L'appel de la fonction FN_b2StaticBox() retourne un identifiant du corps qui devra être utilisé comme paramètre dans les procédures et fonctions du module box2dlib.bbc. Il est indispensable de mémoriser cette valeur dans une variable.

La fonction FN_b2StaticBox() fournit un moyen simple de créer un corps statique rectangulaire, box ou boite, dans le moteur physique Box2D. On l’utilise pour définir des obstacles, des sols, des murs, ... c'est-à-dire des objets immobiles qui ne bougent pas mais avec lesquels d’autres objets dynamiques peuvent entrer en collision.

La fonction FN_b2StaticBox() crée directement un body statique + une fixture (corps + forme) de type rectangle, sans qu'il soit nécessaire de faire appel à la séquence la séquence : b2BodyDef + b2PolygonShape + fixture.

Un corps créé via la fonction FN_b2StaticBox() est statique : il ne bouge pas, même sous l’effet de la gravité, et a une masse nulle. Dans Box2D, les corps statiques ne collent pas entre eux mais interagissent avec les corps dynamiques. 

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

La fonction FN_b2StaticBox() 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 du sol en bas du monde ---

REM --- d'une taille de 560 de long x 40 de haut ---

REM --- avec une inclinaison de 8 degres (soit 0,14 radian) ---

ksol = FN_b2StaticBox( kmonde , 320 , 460 , 0.14 , 280 , 20 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END