DESCRIPTION.

La procédure PROC_b2DestroyWorld() détruit un monde et tous les corps qu'il contient.

SYNTAXE.

PROC_b2DestroyWorld( monde )

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 quel le monde physique doit être supprimé.

L'appel de la procédure PROC_b2DestroyWorld supprime les références à tous les corps contenus dans monde, ainsi que leurs leurs fixtures et leurs joints, ainsi que toutes les structures internes de simulation, puis détruit monde, en libèrnt toute la mémoire requise par monde et met fin à la simulation associée à monde.

BBC BASIC for SDL 2.0 ne gérant pas les pointeurs, la procédure PROC_b2DestroyWorld() va donc utiliser, pour sa définition, la syntaxe spéciale : DEF PROC_b2DestroyWorld ( RETURN monde ) pour éviter ensuite d’utiliser accidentellement un monde détruit. Cela signifie que :

- la procédure PROC_b2DestroyWorld() va recevoir la variable monde par référence ;

- la variable monde pourra donc être modifier dans le corps de la la procédure PROC_b2DestroyWorld() ;

- après destruction, la procédure met généralement monde = 0 ou, à une valeur invalide ;

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_b2DestroyWorld() 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 de box2dlib ---

PROC_b2Init

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

PROC_b2Init

kmonde = FN_b2CreateWorld( 0 , -9.81 )

REM --- Suppression du monde ---

PRINT kmonde

PROC_b2DestroyWorld( kmonde )

PRINT kmonde

REM --- Fermeture de box2dlib ---

PROC_b2Exit

REM --- Fin du programme ---

END