5. Les Acteurs

Le chapitre qui suit couvre les acteurs en général et traite aussi des détails de la création 2D - du sprite de l'acteur. Pour ceux qui sont intéressé par les acteurs 3D un chapitre appelé “Going 2.5D” y sera dédié, alors patience, nous y arriverons aussi.

Nous avons déjà vu quelques méthodes associé aux acteurs - Nous avons vu comment charger un acteur dans le jeu ou la scene courante, nous connaissons comment faire que notre acteur marche, parle, se position dans la direction à laquelle il fait face, etc… Mais regardons, à quoi ressemble Molly. Ouvrez le fichier data\actors\molly\molly.actor et de voir immédiatement que ce n'est pas un fichier de script - C'est un fichier de définition.

Divisons le en petits morceaux et expliquons l'ensemble du fichier:

; $EDITOR_PROJECT_ROOT_DIR$ ..\..\..\

Normalement dans les fichiers de définition de WME les lignes commençant par ; sont commentées. Notez que dans les commentaires de script :

(// or /* */) ne sont pas supportés dans les fichiers de définition et provoque des erreurs!

Mais cette ligne est spéciale et elle dis à WME à quel niveau nous sommes dans la structure de dossier ou en d'autres mots où est la racine du projet. Ceci est très important plus tard dans les fichiers de scene (si vous déplacez les scènes plus profondément dans les structure de dossiers, vous devrez modifier cette valeur ou votre scène ne fonctionnera pas).

Important: Les lignes dans les fichiers de définition ne se termine pas par des point-virgules!

ACTOR 
{

Notre bloc de données définissant un acteur commence par:

  NAME = "molly" 
  CAPTION="" 
  SCALABLE = TRUE 
  INTERACTIVE = FALSE 
  X = 400 
  Y = 460 
  SCRIPT="actors\molly\molly.script" 
 
  FONT = "fonts\outline_red.font"

NAME est le nom interne d'un acteur.
CAPTION est l’étiquette qui peut être utilisée , par exemple, dans game_loop.script pour afficher la légende de la même façon qu'avec les Entités (nodes).
SCALABLE peut être true ou false et défini si l'acteur affecté par les niveaux d’échelle de la scene ou par mise à l'échelle manuellement grâce à la méthode interne.

De plus on peut avoir:

ROTATABLE = TRUE/FALSE ce qui ferait que notre personnage serait affecté par les niveaux de rotation de la scène que nous avons vu déjà dans l'éditeur de Scène.
INTERACTIVE signifie que l'acteur est sensible à la souris. Si vous exécutez notre jeu dès maintenant et mettez le curseur de la souris sur Molly, le jeu ne réagit pas parce que INTERACTIVE est défini à FALSE. Si vous l'aviez changer pour TRUE vous auriez vu que Molly est une partie interactive de la scene.
X et Y sont les coordonnées initiale de l'acteur sur l'écran.
SCRIPT est le nom du fichier Script qui sera automatiquement attaché à l'acteur lors du chargement. vous pouvez avoir une multitude de ligne de script ici.
FONT est le fichier de font utilisé par la méthode actor.Talk que nous avons déjà utilisé.

Et il y a deux de plus :

SOUND_PANNING = TRUE/FALSE qui, s'il est réglé sur TRUE fera automatiquement un panoramique sonore de gauche à droite en fonction d'où il se trouve sur l'écran.
COLORABLE = TRUE/FALSE qui, s'il est réglé sur TRUE fera que l'acteur sera affecté par les régions décoration.

Avant d'aller plus loin, faisons un peu de théorie. Pour avoir un superbe acteur 2D dans notre scene, nous devons définir cinq jeux de base d'animations ( walk (Marcher), talk (Parler), idle (ralenti), turnleft (tourne à gauche), turnright (tourne à droite) ).

La documentation WME stipule clairement que: “…rappelez-vous que l'acteur est capable de marcher dans les huit directions, donc vous avez besoin de huit versions de chaque type d'animation pour les différentes directions. Si vous avez seulement quatre directions créées pour votre personnage, vous pouvez utiliser une animation pour plusieurs directions, mais le fichier de définition de l'acteur doit toujours les définir tous les 8. Par exemple, si vous avez une animation "personnage marche à gauche", vous pouvez l'affecter à la fois à "marcher à gauche" et "marcher haut gauche" ".

Mais regardons notre premier jeu d'animation appelé walk - Notez que le comportement a changé dans le nouveau WME (Avant c’était SPRITESET).

  ANIMATION 
  { 
    NAME       = "walk" 
 
    LEFT       = "actors\molly\ll\walk.sprite" 
    RIGHT      = "actors\molly\rr\walk.sprite" 
    UP         = "actors\molly\uu\walk.sprite" 
    DOWN       = "actors\molly\dd\walk.sprite" 
 
    UP_LEFT    = "actors\molly\ul\walk.sprite" 
    UP_RIGHT   = "actors\molly\ur\walk.sprite" 
    DOWN_LEFT  = "actors\molly\dl\walk.sprite" 
    DOWN_RIGHT = "actors\molly\dr\walk.sprite" 
  }

Comme vous voyez, vous assignez différents Sprites pour chacune des huit directions possibles. Et a ce sujet,Il y a une chose spéciale au sujet de l'animation de la marche - quand vous construisez votre animation d'acteur dans l'éditeur de sprite, vous avez à régler le paramètre "Move by" pour chaque image (frame) comme nous l’avons dit précédemment. Ceci définira à quelle vitesse le personnage bouge sur l'écran.

Le jeu de Sprites suivant s’appelle idle

  ANIMATION 
  { 
    NAME       = "idle" 
 
    LEFT       = "actors\molly\ll\stand.sprite" 
    RIGHT      = "actors\molly\rr\stand.sprite" 
    UP         = "actors\molly\uu\stand.sprite" 
    DOWN       = "actors\molly\dd\stand.sprite" 
 
    UP_LEFT    = "actors\molly\ul\stand.sprite" 
    UP_RIGHT   = "actors\molly\ur\stand.sprite" 
    DOWN_LEFT  = "actors\molly\dl\stand.sprite" 
    DOWN_RIGHT = "actors\molly\dr\stand.sprite" 
  }

Il n'y a rien de spécial au sujet de la marche au ralenti. Vous pouvez ajouter quelques effets sympa comme la respiration, traîner les pieds ou se gratter le nez.

les 2 jeux de sprite suivants s’appellent turnleft et turnright et à travers eux peut être réalisé un acteur qui se tourne réaliste. PAr defaut c'est juste un flip que nous connaissons dans les jeux plus vieux. Ils sont identiques, donc je vais afficher seulement turnleft.

  ANIMATION 
  { 
    NAME       = "turnleft" 
 
    LEFT       = "actors\molly\ll\turn.sprite" 
    RIGHT      = "actors\molly\rr\turn.sprite" 
    UP         = "actors\molly\uu\turn.sprite" 
    DOWN       = "actors\molly\dd\turn.sprite" 
 
    UP_LEFT    = "actors\molly\ul\turn.sprite" 
    UP_RIGHT   = "actors\molly\ur\turn.sprite" 
    DOWN_LEFT  = "actors\molly\dl\turn.sprite" 
    DOWN_RIGHT = "actors\molly\dr\turn.sprite" 
  }

Le dernier jeu est l'animation talk.

  ANIMATION 
  { 
    NAME       = "talk" 
 
    LEFT       = "actors\molly\ll\talk.sprite" 
    RIGHT      = "actors\molly\rr\talk.sprite" 
    UP         = "actors\molly\uu\talk.sprite" 
    DOWN       = "actors\molly\dd\talk.sprite" 
 
    UP_LEFT    = "actors\molly\ul\talk.sprite" 
    UP_RIGHT   = "actors\molly\ur\talk.sprite" 
    DOWN_LEFT  = "actors\molly\dl\talk.sprite" 
    DOWN_RIGHT = "actors\molly\dr\talk.sprite" 
  }

Nous pouvons définir plus d'un bloc talk! Si nous le faisons, WME joue alors de manière aléatoire les animations parler pendant qu'il parle ce qui le rend plus vivant. En plus de ça nous pouvons définir des positions de parler qui sera invoquer par le paramètre spécial dans la commande Talk.

Si nous créons une animation spéciale et la nommons, par exemple, eyeroll, nous pourrions alors par une ligne spéciale invoquer l'eyeroll.

Récapitulons - Par defaut si nous appelons actor.Talk(“Salut, comment c'est arrivé? Blah blah blah”); toutes les animations appelé talk sont jouées aléatoirement.

La méthode entière est actor.Talk(Text, SoundFilename, Duration, TalkStances, TextAlignment)

Text – est la ligne écrite. Jusqu'ici nous avons toujours utilisée uniquement ce paramètre.
SoundFilename – c'est, en quelque sorte, un paramètre obsolète. Nous allons voir pourquoi quand nous arriverons au chapitre de localisation, car dans les dernières versions du moteur, WME choisit automatiquement un nom de fichier correct pour jouer en fonction du fichier tableau de chaine. Donc, si vous allez utiliser des voix-off, mettez tout simplement Null à l'intérieur.
Duration n'est normalement pas utilisé. Le texte est automatiquement synchronisé avec le fichier de la parole. Vous pouvez utiliser Null à nouveau.
TalkStances – Ici vous pouvez spécifier l'ordre et les positions, qui sont utilisés pour le discours. Si ce paramètre est fourni, vous pouvez choisir uniquement une partie des positions.
TextAlignment – définit l'alignement des lignes écrites.

Donc notre commande pourrais ressemblez à ça par exemple:

actor.Talk("Salut.",null,null,"eyeroll"); ce qui fera faire un roulement d’œil en disant cette ligne.

Notez dans la marge - nous avons toujours utilisé seulement la variable actor pour les interactions avec l'acteur, mais c'est seulement un variable. Donc, si je voulais briser ce stéréotype, je peux facilement faire ce qui suit:

dans base.inc déclarez

global Peter;  
global Sally;

dans game.script utilisez notre

Peter = Scene.LoadActor("path_to_peter.actor file"); 
Sally = Scene.LoadActor("path_to_sally.actor file"); 
 
Peter.GoTo(100,100); 
Sally.Talk("blahblahblah");

Je pense que vous voyez que je veux dire. Mais revenons aux animations.

Vous pouvez bien sûr créer aussi des sprites pour les animations non-standard (Prendre, Pousser, Tirer, etc…) qui sera ensuite référencé à partir des scripts.

Nous voyons donc que ce n'est pas difficile de créer un nouvel acteur de qualité en 2D, avec des animations, à condition que nous ayons des graphismes correspondants. Et maintenant il est temps de découvrir quelques méthodes utilisables pour les acteurs.

actor.PlayAnim(path_to_sprite) – joue une animation comme définie dans le fichier sprite et attend que l'animation soit terminée.
actor.PlayAnimAsync(path_to_sprite) – Joue une animation comme définie dans le fichier acteur continu immédiatement.
actor.Reset() – Annule l'action en cours que l'acteur est en train de faire (parler, marcher)
actor.TurnTo(object or direction) – fait se tourner l'acteur, soit dans la direction d'un objet tel que défini dans l'éditeur scène ou la constante directionnelle.

Enfin vous pouvez remplacer les animations par défaut(Par exemple l'animation courir, nager ou voler pour remplacer "marcher")

Lastly you can override the default animations (for example run, swim or fly animation to replace "walk") et les changer à l'aide de actor.TalkAnimName, actor.IdleAnimName, actor.WalkAnimName, actor.TurnLeftAnimName et actor.TurnRightAnimName.

Ce livre ne remplace pas la documentation WME. Il y a d'autres méthodes et attributs qui peuvent être utilisées pour nos acteurs. Alors comme je l'ai promis dans le premier chapitre, je vais inclure pour clore, des passages pertinents de la documentation WME, où vous pouvez voir la description complètes des objets.

Contents→ Inside a game→ Actors - pour la description générale des acteurs
Contents → Scripting in WME → Script language reference → Actor object – pour les méthodes et attributs qui peuvent être utilisés avec les acteurs