(Anciennement CreateGraphicOverlay, désormais obsolète)
static Overlay* Overlay.CreateGraphical(int x, int y, int slot, bool transparent)
Crée un calque sur l'écran contenant une copie de l'image contenue à l'emplacement
SLOT du Sprite Manager. L'image est placée aux coordonnées (X,Y) à l'écran (et non
à celles de la pièce).
Si transparent vaut 'true', alors le calque sera dessiné de la même façon que
les personnages/objets, et si la valeur est 'false' alors un rectangle noir sera peint
comme fond de la sprite.
Voyez la description de Overlay.CreateTextual pour plus
de précisions sur les calques.
Exemple :
Overlay* monCalque = Overlay.CreateGraphical(100, 100, 300, true); Wait(40); monCalque.Remove();
créera un calque de l'image contenue dans l'emplacement 300 du Sprite Manager, aux coordonnées
(100,100). Cela l'affichera durant une seconde, puis l'effacera.
Voir Aussi : Overlay.CreateTextual,
Overlay.Remove
(Anciennement CreateTextOverlay, désormais obsolète)
static Overlay* Overlay.CreateTextual(int x, int y, int largeur, FontType font, int couleur, string texte)
Crée un calque à l'écran contenant le texte que vous passez à la position
spécifiée. Un tel calque ressemble trait pour trait à du texte de discours
affiché pour les conversations, cependant avec cette commande le texte reste
affiché à l'écran jusqu'à ce que vous l'effacier avec la commande Remove, ou
que le joueur change de pièce, auquel cas le calque est automatiquement effacé.
Les paramètres X et Y définissent la position où sera affiché le calque à l'écran,
selon son coin haut-gauche. LARGEUR est la largeur, en pixels, de la zone de texte.
FONT est le numéro de police utilisé par l'éditeur (0 est la police normale, 1 est
la police de discours). COULEUR est la couleur du texte - utilisez une couleur allant
de 1 à 15.
Finalement, TEXTE est bien entendu le texte qui sera affiché.
La fonction retourne un objet Overlay, que vous utiliserez plus tard pour repositionner
et effacer le calque.
Vous pouvez insérer des valeurs de variables dans le message. Pour plus d'information,
voyez la section string formatting.
NOTE : des grands calques, tout comme de grands objets, peuvent ralentir la machine
lorsqu'ils sont affichés.
NOTE : pour le moment il n'est possible d'afficher que 10 calques à la fois. D'autres
commandes comme Say et SayBackground créent des calques de façon interne, donc n'espérez pas
pouvoir en créer 10 avec CreateTextual.
NOTE : si la variable contenant l'objet Overlay est créée dans une fonction, le calque
sera supprimé lorsque celle-ci aura terminé son exécution.
Par conséquent, si vous vouez que le calque reste affiché à l'écran après l'exécution de la fonction
où il a été créé, la déclaration Overlay* de la variable doit être placée en haut du
script et hors de toute fonction.
Exemple :
Overlay* monCalque = Overlay.CreateTextual(50,80,120, Game.SpeechFont, 15,"Ceci est le texte du calque"); Wait(40); monCalque.Remove();
affichera une zone de texte de 120 pixels, dont le coin haut gauche sera placé aux coordonnées (50,80),
contenant la chaîne “Ceci est le texte du calque” qui utilisera la police de discours (SpeechFont) et la couleur blanche.
Le calque restera affiché durant une seconde, puis sera effacé.
Voir Aussi : Overlay.CreateGraphical, Overlay.X,
Overlay.Y, Overlay.Remove
(Anciennement RemoveOverlay, désormais obsolète)
Overlay.Remove()
Efface le calque spécifié de l'écran. Utilisez ceci lorsque vous avez
fini d'utiliser le calque.
Exemple :
Overlay* monCalque = Overlay.CreateTextual(50,80,120,2,15,"Ceci est le texte du calque"); Wait(200); monCalque.Remove();
créera un calque de texte, attendra 200 cycles de jeu (environ 5 secondes) puis effacera
le calque de l'écran.
Voir Aussi : Overlay.CreateTextual
(Anciennement SetTextOverlay, désormais obsolète)
Overlay.SetText(int largeur, FontType font, int couleur, string texte, ...)
Remplace le calque spécifié par un nouveau, aux mêmes coordonnées mais spécifié avec
un nouveau texte, une nouvelle largeur, une nouvelle police et une nouvelle couleur.
Vous pouvez insérer des valeurs de variables dans le message. Pour plus d'information,
voyez la section string formatting.
Exemple :
Overlay* monCalque = Overlay.CreateTextual(50,80,120,Game.SpeechFont,15,"Ceci est le texte du calque"); Wait(200); monCalque.SetText(120,2,15,"Ceci est le texte qui remplace l'ancien");
créera un calque de texte, attendra 200 cycles de jeu (environ 5 secondes), puis
remplacera le calque par un nouveau.
Voir Aussi : Overlay.CreateTextual,
Overlay.Remove
(Anciennement IsOverlayValid, désormais obsolète)
readonly bool Overlay.Valid;
Vérifie si le calque est actuellement affiché ou non.
Retourne 1 si c'est le cas, sinon 0.
Exemple :
Overlay* monCalque = Overlay.CreateTextual(50,80,120,2,15,"Ceci est le texte du calque"); Display("Propriété valide du calque avant : %d", myOverlay.Valid); monCalque.Remove(); Display("Propriété valide du calque après : %d", myOverlay.Valid);
créera un calque, et affichera la proriété Valid (qui vaudra 1). Puis, efface le calque
et affiche une nouvelle fois sa propriété Valid (qui sera alors 0).
Voir Aussi : Overlay.CreateTextual,
Overlay.Remove
(Anciennement MoveOverlay, désormais obsolète)
int Overlay.X;
Retourne/Définit la coordonnée X du calque (c'est-à-dire le côté gauche du calque).
Ceci vous permet de déplacer dynamiquement les calques à l'écran.
Exemple :
Overlay* calqueTest = Overlay.CreateTextual(50,80,120,2,15,"Ceci est le texte du calque"); while (calqueTest.X < 100) { calqueTest.X++; Wait(1); } calqueTest.Remove();
crée un calque de texte, puis le déplace graduellement vers la droite pour enfin l'effacer.
Voir Aussi : Overlay.CreateTextual,
Overlay.Y, Overlay.Remove
(Anciennement MoveOverlay, désormais obsolète)
int Overlay.Y;
Retourne/Définit la coordonnée Y du calque (c'est-à-dire le haut du calque).
Ceci vous permet de déplacer dynamiquement les calques à l'écran.
Exemple :
Overlay* calqueTest = Overlay.CreateTextual(50,50,120,2,15,"Ceci est un calque textuel"); while (calqueTest.Y < 100) { calqueTest.Y++; Wait(1); } calqueTest.Remove();
crée un calque textuel, puis le déplace graduellement vers le bas pour enfin l'effacer.
Voir Aussi : Overlay.CreateTextual,
Overlay.X, Overlay.Remove