(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