5. Les Acteurs

Le chapitre qui suit parle des acteurs en général et traite aussi des détails de la création 2D - les sprites de l'acteur. Pour ceux qui sont intéressé par les acteurs 3D un chapitre appelé “La 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 dans la scène courante, nous savons faire marcher notre acteur marche, parler, se positioner dans la direction à laquelle il doit faire face, etc… Mais regardons, à quoi ressemble Molly. Ouvrez le fichier data\actors\molly\molly.actor et on voit 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.

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

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

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

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

ACTOR 
{

  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 est affecté par les niveaux d’échelle de la scène 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 déjà vu 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 placé sur FALSE. Si vous l'aviez changer pour TRUE vous auriez vu que Molly devient une partie interactive de la scène. Son nom s'affiche.
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 Police utilisé par la méthode actor.Talk que nous avons déjà utilisé.

Et il y en a deux autres :

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

Avant d'aller plus loin, faisons un peu de théorie. Pour avoir un superbe acteur 2D dans notre scène, nous devons définir cinq jeux (ensemble) de base d'animations ( walk (Marcher), talk (Parler), idle (au repos), 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 ça 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 à 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 du repos. 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 de façon réaliste. Par défaut c'est juste un flip que nous connaissons dans les jeux plus vieux. Les deux sont identiques, donc je vais vous 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 que l'acteur parle, ce qui le rend plus vivant. En plus de ça, nous pouvons définir des positions de parler qui seront invoquées 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.(roulement des yeux)

Récapitulons - Par defaut si nous appelons actor.Talk(“Salut, comment c'est arrivé? Blah blah blah”); toutes les animations appelées 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 à 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 plus 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 seront 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 "Salut".

Notez quelque part - 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 seront ensuite référencées à partir des scripts.

Nous voyons donc que ce n'est pas difficile de créer un nouvel acteur de qualité en 2D, avec ses 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 et 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 soit la constante directionnelle.

Enfin vous pouvez remplacer les animations par défaut(Par exemple l'animation courir, nager ou voler pour remplacer "marcher") et les changer à l'aide de actor.TalkAnimName, actor.IdleAnimName, actor.WalkAnimName, actor.TurnLeftAnimName et actor.TurnRightAnimName.

Ce livre ne remplace, évidemment, pas la documentation WME. Il y a d'autres méthodes et attributs qui peuvent être utilisés pour nos acteurs. Alors comme je l'ai promis dans le premier chapitre, je vais inclure pour clore ce chapitre, des passages pertinents de la documentation WME, où vous pourrez 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