DESCRIPTION.

La procédure PROC_b2SetSensor() active ou désactive le mode capteur pour une fixture dans un monde physique Box2d.

SYNTAXE.

PROC_b2SetFilter( fixture , mode )

REMARQUES.

fixture doit être l'identifiant de la variable ayant reçu la valeur retournée par l'appel d'une fonction ayant créée une fixture.

mode doit être une valeur binaire activant ou désactivant le mode capieur, ou sensor. Si mode vaut : 

- 0, valeur par défaut, le mode capteur est désactivé, mode normal ;

- 1, le mode capteur est activé.

Dans Box2D, une fixture, un élément attaché à un corps pour définir sa forme, sa densité, etc., peut être transformée en capteur, ou sensor). En mode capteur, un coprs ne génère pas de collisions physiques : pas de rebond, ni de frottement,  ni de forces appliquées. Mais il continuera de détecter les contacts, on pourra ainsi savoir si un autre corps entre ou sort de la zone du capteur.

On utilisera le mode capture, quand le programme réagir quand deux corps sont en contact sans qu'il y ait interattractions automatique entre eux. Par exemple ; si un personnage doit collecter des objets : pièces, armes, ressources, outils, ou s'il doit être téléporté dans un autre tableaux quand il rentre dans une certaine zone.

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_b2SetFilter() 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 plateau ---

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

REM --- Création d'une fixture rectangulaire ---

kplateauF = FN_b2BoxFixture( kplateau , 0 , 0 , 0 , 1 , 0.5 , 0.3 , 0.2 , 1.0 )

PROC_b2SetFilter( kplateauF , 1 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END