Rooms

La manipulation de salles (rooms) 'à la volée' peut être une chose dangereuse. Vous devez bien comprendre que les salles changent à tout moment en fonction de ce qui se passe dans le jeu. Ceci ne concerne normalement que la salle actuellement active et il existe de nombreuses routines décrites dans les sections précédentes destinées à manipuler les instances, les arrière-plans et les tuiles de la salle active. Mais les changements opérés dans la salle active ne perdureront que si la salle est de type persistante. Par conséquent, vous ne devriez jamais manipuler certains aspects de la salle actuellement active ou de n'importe quelle salle persistante qui a déjà été visitée auparavant. De tels changements passeront inaperçus la plupart du temps et pourront parfois mener à des erreurs inattendues. Etant donné que ces salles sont reliées entre elles de manière sophistiquée, il n'existe donc pas de routine pour supprimer une salle.

Les routines suivantes sont disponibles.

room_set_width(ind, w) Régle la largeur w de la room d'index ind.
room_set_height(ind, h) Régle la hauteur h de la room d'index ind.
room_set_caption(ind, str) Détermine le titre str de de la salle d'index ind.
room_set_persistent(ind, val) Affiche la room d'index ind que celle-ci soit persistante ou non.
room_set_code(ind, str) Fournit la chaîne de code d'initialisation pour la room d'index ind.
room_set_background_color(ind, col, show) Fixe les propriétés de couleur de la room d'index ind si cette dernière ne posséde pas d'image d'arrière-plan. col indique la couleur et show indique si la couleur doit être affichée ou pas.
room_set_background(ind, bind, vis, fore, back, x, y, htiled, vtiled, hspeed, vspeed, alpha) Régle l'arrière-plan d'index bind (0 à 7) pour la room d'index ind. vis indique si l'arrière-plan est visible et fore si c'est actuellement un premier plan. back est l'index de l'image d'arrière-plan. x,y précise la position de l'image et htiled et vtiled mentionnent si l'image doit être affichée sous forme de tuiles. hspeed et vspeed donnent la vitesse à laquelle l'arrière-plan doit se déplacer et alpha correspond à la valeur alpha de translucidité (1 = solide et le plus rapide).
room_set_view(ind, vind, vis, xview, yview, wview, hview, xport, yport, wport, hport, hborder, vborder, hspeed, vspeed, obj) Sélectionne la vue d'index vind (0 à 7) pour la room d'index ind. vis indique si la vue est visible. xview, yview, wview et hview précisent la position de la vue dans la room. xport, yport, wport et hport donnent la position à l'écran. Si la vue doit suivre un objet, hborder et vborder déterminent la bordure visible minimale à conserver autour de objet. hspeed et vspeed indiquent la vitesse maximale avec laquelle la vue peut se déplacer. obj est l'index de l'objet ou encore celui de l'instance.
room_set_view_enabled(ind, val) Détermine si les vues doivent être autorisées pour la room d'index ind.
room_add() Ajoute une nouvelle room. Cette commande renvoie l'index de la room. Veuillez noter que la room ne fera pas partie de l'ordre des séquences des rooms. Aussi, la nouvelle room ne possédera pas de room précédente ou suivante. Si vous désirez vous déplacer vers une room que vous avez ajoutée, il sera nécessaire de fournir l'index de cette room.
room_duplicate(ind) Effectue une copie de la room d'index ind. Cette commande retourne l'index de la nouvelle room.
room_assign(ind, room) Assigne la room indiquée à la room ind. Cette commande effectue donc une copie de la room.
room_instance_add(ind, x, y, obj) Ajoute une nouvelle instance de l'objet obj à la room, en la plaçant à la position indiquée. Cette commande retourne l'index de l'instance.
room_instance_clear(ind) Supprime toutes les instances de la room indiquée.
room_tile_add(ind, back, left, top, width, height, x, y, depth) Ajoute une nouvelle tuile à la room à la position indiquée. La commande retourne l'index de la tuile. back correspond à l'arrière-plan à partir duquel la tuile est prise. left, top, width et height indiquent la partie de l'arrière-plan qui forme la tuile. x,y est la position de la tuile dans la room et depth la profondeur de la tuile.
room_tile_add_ext(ind, back, left, top, width, height, x, y, depth, xscale, yscale, alpha) Identique à la routine précédente mais cette fois, vous avez la possibilité d'indiquer un facteur d'échelle de direction x et y ainsi qu'une transparence alpha pour la tuile.
room_tile_clear(ind) Supprime toutes les tuiles de la room mentionnée.

<< Traduction française par Philippe Ragni - (2005) >>

« Objets | Fichiers, registres et exécution de programmes »