DESCRIPTION.

La procédure PROC_b2SetNextVertex() associe un sommet virtuel, ou fantome, après le dernier sommet d'une fixture faite de segments de ligne, dans un monde physique Box2d.

SYNTAXE.

PROC_b2SetNextVertex( fixture , abscisse , ordonnee )

REMARQUES.

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

abscisse doit être une valeur numérique, indiquant l'abscisse du sommet fantome.

ordonnee  doit être une valeur numérique, indiquant l'ordonnée du sommet fantome.reliés.

Dans un monde physique Box2D, une ChainShape, ou chaine de segments, est une série de segments, ouverte ou fermée, et créée avec l'appel de la fonction FN_b2ChainFixture(). Les ghost vertices, ou sommets fantomes, quant à eux, servent à améliorer la détection de contacts au niveau des extrémités d’une ChainShape. Les sommets fantomes vont permettre d’éviter des effets bosses ou des collisions incohérentes quand un corps touchera une extrémité d'une chaine de segments.

L'appel de la procédure PROC_b2SetNextVertex() va donc indiquer, dans un monde physique Box2D, un sommet virtuel qui suit la chaine de segments, en dehors des sommets qui lui sont définis explicitement lors de sa création.

On utilisera des sommets fantomes pour créer une chaîne ouverte, pour que les collisions aux extrémités soient plus fluides, pour relier implicitement deux chaines de segments sans les fusionner, ou pour donner une direction aux segments des extrémités. Par exemple : si une chaîne de segments représente le bord d’une falaise, il est utile de dire que la falaise continue légèrement, même si graphiquement elle s’arrête là.

Voir la fonction FN_b2ChainFixture() pour créer une fixture faite de segments de droite.

Voir la procédure PROC_b2SetPrevVertex() pour associer un sommet fantome avant le premier sommet d'une chaine de segments.

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

DIM LST_Abscisses( 6 ) : LST_Abscisses() = -15 , -10 , -5 , 0 , 5 ,10 , 15

DIM LST_Ordonnees( 6 ) : LST_Ordonnees() = 4 , 2 , 3 , 1 , 3 , 4 , 2

REM --- Initialisation et création du monde ---

PROC_b2Init

kmonde = FN_b2CreateWorld( 0 , -9.81 )

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

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

REM --- Création d'une fixture pour le sol ---

ksolF = FN_b2ChainFixture( ksol , 7 , LST_Abscisses() , LST_Ordonnees() , 0.3 , 0.2 , 0 , 0 )

PROC_b2SetPrevVertex( ksolF , -17 , 3.7 )

PROC_b2SetNextVertex( ksolF , 17 , 1.8 )

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END