7. Les Dialogues [WME Resource Center]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 7. Les Dialogues ======

WME offre des capacités de dialogue très puissant et ce chapitre traite de la façon comment vous pouvez mettre en œuvre des arbres de dialogue dans votre jeu. Nous allons utiliser notre dernier exemple où nous avons dans une même scène Molly et Sally.

Notre chapitre débute de la même façon que le précédent, avec la définition de ce qu'on appelle "boite de réponses". C'est l'interface dans lequel seront stocké les choix de dialogue que le joueur a pour bien communiqué avec les autres personnages.

Vous allez voir que c'est très similaire à la définition de la boite d'inventaire. Nous allons parler du fichier qui se trouve dans **data\interface\responses.def** et comme on l'a déjà vu, c'est affecté dans les gestionnaire de projet en tant que Response Window. (Fenêtre de réponse)

<code script>
RESPONSE_BOX
{
  FONT = "fonts\outline_white.font"
  FONT_HOVER = "fonts\outline_red.font"
</code>

Chemin vers le fichier Font utilisé pour les options de dialogues et pour les options de dialogues en surbrillance.(souris par dessus)

<code script>
  HORIZONTAL = FALSE
</code>

HORIZONTAL spécifie si les options de dialogue sont affichés horizontalement ou verticalement.

<code script>
  SPACING = 5
</code>

Combien de pixels devrait séparer les options?

<code script>
  AREA {40, 0, 800, 170}
</code>

Pareil que dans la boite d'inventaire, vous définissez la fenêtre dans laquelle vos options vont apparaitre.

<code script>
  WINDOW
  {    
    X = 0
    Y = 420
    WIDTH = 800
    HEIGHT = 180

    BUTTON
    {
      TEMPLATE = "ui_elements\template\but.button"
      IMAGE = "ui_elements\arrow_up.bmp"
      TEXT = ""
      NAME = "prev"

      X = 0
      Y = 0
      WIDTH = 30
      HEIGHT = 30
    }

    BUTTON{
      TEMPLATE = "ui_elements\template\but.button"
      IMAGE = "ui_elements\arrow_down.bmp"
      TEXT = ""
      NAME = "next"

      X = 0
      Y = 150
      WIDTH = 30
      HEIGHT = 30
    }
  }
}
</code>

Là encore voyez qu'il y a une définition de fenêtre avec deux boutons (prev et next) qui sont les boutons de défilement. Si WME trouve des boutons nommé ainsi, il les utilisent automatiquement. Tous le positionnement (Absolu dans WINDOW et relatif dans BUTTONS, comme la boite d'inventaire).

Pour les autres options possible vous pouvez utiliser :

**TEXT_ALIGN** - Spécifie l'alignement des texte de ligne de réponse; Ça peut être aussi bien "left", "right" ou "center"; La valeur par défaut est "left" 

**VERTICAL_ALIGN** - spécifie l'alignement vertical des réponses au sein de la zone de réponse (elle n'a aucun effet sur les éléments classés à l'horizontale); Ça peut être une des valeur suivante: "top", "center" ou "bottom";  La valeur par défaut est "bottom" 

Bien sûr, vous pouvez, pour la fenêtre, utiliser le paramètre IMAGE qui définira une image de fond pour la boite de réponses. Je vais laisser à votre imagination pour l'instant et passons sur la manière dont le dialogue lui-même est construit.

Les dialogues dans WME sont entièrement scripté(mis dans un script) ce qui leur donnent une grande flexibilité. Vous pouvez faire ce que vous voulez, au milieu du dialogue vous voulez inclure une sequence cinematographique complexe, une vidéos, et j'en passe - Vous l'avez. 

Mais retour à nos dialogue - Regardons un exemple d'arbre de dialogue que j'ai créé dans ce but:

{{wmebook:ch7.jpg|}}

C'est la façon typique dont le joueur peut parcourir l'arbre des dialogues. Il peut aussi bien parler du temps ou du livre ou il peut poser des questions sur ses collègues, ce qui lui fraye un chemin pour poser des questions sur certains collègues et par ailleurs Peter se fraye un chemin vers l'intrigue. 

En outre nous aimerions définir quelques autres règles à notre dialogue. La météo est le sujet très stupide,donc nous allons laisser notre joueur poser qu'une fois un question a se sujet dans tout le jeu. Marc et Dirac ne sont pas important pour l'histoire, nous laisserons donc notre joueur leur demander qu'une seule chose par dialogue. Enfin le sujet "livre" sera ouvert au joueur seulement si Molly à ramassé le livre.

Allons-y. Nous devons nous familiariser avec quelques nouvelles méthodes:

**Game.AddResponse([response number], [response text]);** Ajouter une réponse dans la fenêtre des réponses.
**Game.AddResponseOnce([response number], [response text]);** Ajouter une réponse dans la fenêtre qu'une fois par branche dialogue en cours. Puis le sujet disparaît jusqu'à ce que vous laissiez cette branche de dialogue.
**Game.StartDlgBranch();** est une méthode utilisée quand vous voulez commencer une branche de dialogue pour utiliser avec la méthode AddResponseOnce.
**Game.EndDlgBranch();** est une méthode utilisée quand vous voulez terminer une branche de dialogue pour utiliser avec la méthode AddResponseOnce.
**Game.AddResponseOnceGame([response number], [response text]);** Ajoute une reponse dans la fenêtre qu'une fois pour tout le jeu.
**Game.GetResponse();** Affiche la boîte de dialogue préparée, attend que le joueur choisisse une réponse et renvoie le numéro de la réponse choisie.

Parce que nous voulons garder notre code propre, nous allons utiliser des fonctions séparées pour tous les niveaux de l'arbre, nous allons appeler ces fonctions “basic”(de base), “Colleagues”(Collègues) et “Peter” pour les distinguer facilement.

Mais assez bavardé, ouvrez sally.script et nous allons continuer d'avancer. Effacer tout dans ce fichier et y laisser quelque chose comme ceci:

<code script>
#include "scripts\base.inc"

on "LeftClick"
{
  basic();
}
</code>

Bon début, n'est ce pas? Bon, Nous allons ajouter quelque chose de plus évidemment. Commençons par la fonction basic();

<code script>
function basic()
{
	var options;
	options[0] = "Quel temps magnifique, n'est ce pas?";
	options[1] = "Pouvez vous me dire quelque chose au sujet de vos collegues?";
	options[2] = "A quoi sert ce livre?";
	options[3] = "Au revoir!";
	
	var selected;
	while (selected != 3)
	{
		Game.AddResponseOnceGame(0,options[0]);	
		Game.AddResponse(1,options[1]);	
		Game.AddResponse(3,options[3]);	
		
		Game.Interactive = true;
		selected = Game.GetResponse();
		Game.Interactive = false;

		actor.Talk(options[selected]); // L'acteur dit la ligne sélectionnée en premier
		
		switch (selected)  //Nous choisissons quoi faire en se basant sur l'option selectionnée
		{
			case 0:
				sally.Talk("Pas vraiment");	
				break;	
			case 1: 
				sally.Talk("Qui vous intéresse exactement?");	
				break;
			case 3:
				sally.Talk("A plus tard!");	
				break;		
		}
	}
	Game.Interactive = true;
}
</code>

D'abord nous avons créé un tableau appelé options. C'est très utile, pas seulement pour garder le texte propre et dans un seul endroit, mais aussi parce que quand la valeur est sélectionnée, notre acteur peut facilement dire les mots que le joueur a sélectionnés.Puis vient la mécanique du dialogue. Le dialogue par lui même est une boucle, qui tourne jusqu’à ce que le joueur choisisse l'option 3 (au revoir). Donc à chaque parcours de la boucle, la boite de dialogue est recréée et le joueur peut choisir son option à nouveau.

Nous pouvons voir qu'à l’intérieur de cette boucle nous avons attribuer 3 réponses (nous n'avons pas résolu le problème du livre encore) et ensuite on met le jeu en mode interactif. Mais il était toujours interactif, alors pourquoi? Parce qu'on ne veut pas que notre joueur tourne en rond tout en discutant, donc nous mettons le jeu en mode interactif seulement pour les dialogues. Nous attendons la saisie du joueur et puis utilisons la logique Switch pour choisir la réponse.
Comme je l'ai déjà indiqué, vous pouvez faire n'importe quoi comme une réponse. Si vous avez décidé qu'après avoir choisit une certaine option le jeu se ferme inopinément directe vers le bureau, mettez simplement Game.QuitGame(); Mais venez pas vous plaindre si les joueur vous torture après.

Okay, voyons le problème du livre. Nous voulons que le joueur parle du livre seulement si il l'a pris. C'est vraiment très intuitif et c'est la combinaison des idées du chapitre précédent aussi. modifiez la fonction basic pour:

<code script>
Game.AddResponseOnceGame(0,options[0]);	
Game.AddResponse(1,options[1]);	
if (actor.HasItem("book")) Game.AddResponse(2,options[2]);	
Game.AddResponse(3,options[3]);	
</code>

Donc nous avons dis là, que seulement si l'acteur détient le livre dans son inventaire, cette option peut être ajouté a l'arborescence des dialogues. Sympa. Et bien sûr nous avons besoin de définir la réponse adaptée.

<code script>
case 1: 
	sally.Talk("Qui vous intéresse exactement?");	
	break;
case 2: 
	sally.Talk("Je sais pas mais ça a l'air vraiment sympa!");	
	break;
case 3:
	sally.Talk("A plus tard!");	
	break;	
</code>

J'espère que vous commencez à avoir sentir toute la chose. Mais que diriez-vous de passer au deuxième niveau? Nous avons décidé d'utiliser une fonction appelée **colleagues** pour cela, allons donc la faire.

modifiez la section case 1: pour avoir:

<code script>
case 1: 
	sally.Talk("Qui vous intéresse exactement?");	
	colleagues();
	break;
</code>

Maintenant nous devons définir la fonction colleagues().

<code script>
function colleagues()
{
	var options;
	options[0] = "Marc?";
	options[1] = "Peter?";
	options[2] = "Dirac?";
	options[3] = "Revenons à mes autres questions";
	
	Game.StartDlgBranch(); // Nous allons démarrer une branche a cause de AddResponseOnce 
	var selected;
	while (selected != 3)
	{
		Game.AddResponseOnce(0,options[0]);	
		Game.AddResponse(1,options[1]);	
		Game.AddResponseOnce(2,options[2]);	
		Game.AddResponse(3,options[3]);	
	
		Game.Interactive = true;
		selected = Game.GetResponse();
		Game.Interactive = false;
		actor.Talk(options[selected]);
		
		switch (selected)
		{
			case 0:
				sally.Talk("Il était un héros d'un jeu d'aventure de science-fiction qui n'est jamais sorti.");	
				break;	
			case 1: 
				sally.Talk("Le croiriez-vous? Peter a disparu.");	
				sally.Talk("Nous avons tellement peur!");	
				break;
			case 2: 
				sally.Talk("Étrange personnage. Tranchants comme un rasoir.");	
				break;
			case 3:
				sally.Talk("Comme vous voulez.");	
				break;		
		}
	}
	Game.Interactive = true;
	Game.EndDlgBranch(); // On termine la branche là
}
</code>

**  -------------------- EN COURS DE TRADUCTION ------------------ **
Donc, comme nous pouvons voir, C'est vraiment similaire à la méthode basic(). La principale différence c'est la combinaison StartDlgBranch / EndDlgBranch, définissant le début et la fin de la branche et nous permet, avec de la bonne fonction, d'avoir le sujet a disparu de l'arbre quand on n'en a pas besoin (déjà lu).

So as you can see, it’s really almost identical to the basic() method. The only main difference is the StartDlgBranch / EndDlgBranch combo, which defines the start and the end of the tree branch and provides us with the nice function of having topic disappeared from the tree when we don’t need it (already read it).

Okay. You’d say that you don’t need to see the last section because of the perfect analogy to what we’ve just seen here. But I’ve decided to put a plot twist in it!

At the very beginning of this file we’ll create a new global variable called **murderSuspect**. 

So our file starts with:

<code script>
#include "scripts\base.inc"

global murderSuspect;
</code>

And now we can make this function called Peter:

<code script>
function Peter()
{
	var options;
	options[0] = "Where was Peter last seen?";
	options[1] = "Did he have any enemies?";
	options[2] = "Back to my other questions.";

	var selected;
	while (selected != 2)
	{
		Game.AddResponse(0,options[0]);	
		Game.AddResponse(1,options[1]);	
		Game.AddResponse(2,options[2]);	
	
		Game.Interactive = true;
		selected = Game.GetResponse();
		Game.Interactive = false;
		actor.Talk(options[selected]);
		
		switch (selected)
		{
			case 0:
				sally.Talk("He was with me on the party. Then he suddenly left.");	
				actor.Talk("That's strange. Don't you think?");
				sally.Talk("Well... No... It was ... usual.");	
				break;	
			case 1: 
				sally.Talk("No. Only that stupid girl who was hitting on him.");	
				actor.Talk("A girl you say? Did you get envious or what?");
				sally.Talk("Envious! Me??? On THAT girl? Never!");	
				sally.Talk("Besides I would kill hi...");	
				actor.Talk("WHAT???");
				sally.Talk("Nothing!");	
				murderSuspect = true;
				break;
			case 2: 
				sally.Talk("As you wish.");	
				break;		
		}
	}
	Game.Interactive = true;
}
</code>

The only difference in this one is that we set a global variable which will influence something in the game. This is the key stone on the game logic (sometimes referred as a gaming "butterfly effect" – someone tells you a piece of information and completely unrelated drawer in another town suddenly mysteriously opens – but we’re not discussing game design related flaws, right? Right???).

The only remaining change is to the function basic(); but I’m going to post the whole script now because I believe you will be able to spot that easily.

<code script>
#include "scripts\base.inc"

global murderSuspect;

function Peter()
{
	var options;
	options[0] = "Where was Peter last seen?";
	options[1] = "Did he have any enemies?";
	options[2] = "Back to my other questions.";

	Game.StartDlgBranch() ;
	var selected;
	while (selected != 2)
	{
		Game.AddResponse(0,options[0]);	
		Game.AddResponse(1,options[1]);	
		Game.AddResponse(2,options[2]);	
	
		Game.Interactive = true;
		selected = Game.GetResponse();
		Game.Interactive = false;
		actor.Talk(options[selected]);
		
		switch (selected)
		{
			case 0:
				sally.Talk("He was with me on the party. Then he suddenly left.");	
				actor.Talk("That's strange. Don't you think?");
				sally.Talk("Well... No... It was ... usual.");	
				break;	
			case 1: 
				sally.Talk("No. Only that stupid girl who was hitting on him.");	
				actor.Talk("A girl you say? Did you get envious or what?");
				sally.Talk("Envious! Me??? On THAT girl? Never!");	
				sally.Talk("Besides I would kill hi...");	
				actor.Talk("WHAT???");
				sally.Talk("Nothing!");	
				murderSuspect = true;
				break;
			case 2: 
				sally.Talk("As you wish.");	
				break;		
		}
	}
	Game.Interactive = true;
	Game.EndDlgBranch() ;

}


function colleagues()
{
	var options;
	options[0] = "Marc?";
	options[1] = "Peter?";
	options[2] = "Dirac?";
	options[3] = "Back to my other questions.";
	
	Game.StartDlgBranch() ;
	var selected;
	while (selected != 3)
	{
		Game.AddResponseOnce(0,options[0]);	
		Game.AddResponse(1,options[1]);	
		Game.AddResponseOnce(2,options[2]);	
		Game.AddResponse(3,options[3]);	
	
		Game.Interactive = true;
		selected = Game.GetResponse();
		Game.Interactive = false;
		actor.Talk(options[selected]);
		
		switch (selected)
		{
			case 0:
				sally.Talk("He was a hero of a Sci-Fi adventure game which was never released.");	
				break;	
			case 1: 
				sally.Talk("Would you believe it? Peter went missing.");	
				sally.Talk("We're so scared!");	
				Peter();
				break;
			case 2: 
				sally.Talk("Strange fellow. Sharp as a razor.");	
				break;
			case 3:
				sally.Talk("As you wish.");	
				break;		
		}
	}
	Game.Interactive = true;
	Game.EndDlgBranch() ;

}


function basic()
{
	var options;
	options[0] = "Nice weather, isn't it?";
	options[1] = "Can you tell me anything about your colleagues?";
	options[2] = "What's this book for?";
	options[3] = "You've murdered Peter!";
	options[100] = "Bye!";
	
	var selected;
	while (selected != 100)
	{
		Game.AddResponseOnceGame(0,options[0]);	
		Game.AddResponse(1,options[1]);	
		if (actor.HasItem("book")) Game.AddResponse(2,options[2]);	
		if (murderSuspect) Game.AddResponse(3,options[3]);	
		Game.AddResponse(100,options[100]);	
		
		Game.Interactive = true;
		selected = Game.GetResponse();
		Game.Interactive = false;
		actor.Talk(options[selected]);
		
		switch (selected)
		{
			case 0:
				sally.Talk("Not really");	
				break;	
			case 1: 
				sally.Talk("Who exactly is of interest to you?");	
				colleagues();
				break;
			case 2: 
				sally.Talk("I don't know but it really looks neat!");	
				break;
			case 100:
				sally.Talk("See ya!");	
				break;		
			case 3:
				sally.Talk("Yes! And now I'll kill you as well! *BLAM*");	
				Scene.FadeOut(1000,255,0,0,255);
				Game.QuitGame();
				break;						
		}
	}
	Game.Interactive = true;
}

on "LeftClick"
{
	basic();
}

</code>

Just to avoid confusion, Scene.FadeOut fades out the scene to specified color. It’s prototype is:

**Scene.FadeOut(duration, red, green, blue, alpha);** 

and we let it fade for 1000 ms (1 sec.), to full red and no transparency.

**Game.QuitGame();** simply exits the game to Windows. 

Of course you can find the listing of this script in the resources folder for the chapter 7.

You can find a couple of related methods which we didn’t cover here in documentation under

//Contents -> Scripting in WME -> Script Language Reference -> Game Object in the section Responses / Inventory//

And that concludes this chapter but don’t worry. There is a lor of exciting stuff to come.