DESCRIPTION.

La procédure PROC_b2SetVelocity() modifie les vitesses linéaires et/ou angulaire d'un corps dans un monde physique Box2d.

SYNTAXE.

PROC_b2SetVelocity( corps , horizontal , vertical , rotation )

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.

horizontal doit être une valeur numérique, indiquant la nouvelle vitesse linéaire, ou vélocité, horizontale m/s : si horizontal est : 

- positif, le corps se déplace vers la droite, dès sa création ;

- négatif, le corps se déplace vers la gauche, dès sa création ;

- nul, le corps n'a pas de mouvement horizontal.

vertical doit être une valeur numérique, indiquant la nouvelle vitesse linéaire, ou vélocité, vertical  rad/s : si vertical est : 

- positif, le corps se déplace vers le haut, dès sa création ;

- négatif, le corps se déplace vers le bas, dès sa création ;

- nul, le corps n'a pas de mouvement vertical.

rotation doit être une valeur numérique, indiquant la nouvelle vitesse de rotation en rad/s.

La procédure PROC_b2SetVelocity() ne prenant pas en compte la physique, et ne calculant pas de collision instantanée avec d’autres corps, elle doit être employée avec précaution. En effet, dans Box2D, modifier directement la vitesse d’un corps dynamique peut causer des problèmes de 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_b2SetVelocity() 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 )

REM --- Position du projectile ---

PROC_b2GetVelocity( kprojectile , kabscisse , kordonnee , kangle )

PRINT kabscisse , kordonnee , kangle

PROC_b2SetVelocity( kprojectile , 25 , 17 , .5  )

PROC_b2GetVelocity( kprojectile , kabscisse , kordonnee , kangle )

PRINT kabscisse , kordonnee , kangle

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END