**This is an old revision of the document!**

FIXME This page is not fully translated, yet. Please help completing the translation.
(remove this paragraph once the translation is finished)

L'objet Shape painter

Un objet Shape painter (peintre de formes) permet de dessiner des formes dans le jeu. Ce qui peut être utile pour créer des éléments d'interface utilisateur simples. Le Shape painter peut même être utilisé pour créer une boîte de sélection.

Ajouter un objet Shape Painter

Pour ajouter un objet Shape painter, créez un nouvel objet à partir de la liste Properties Editor (Editeur de propriétés) à droite de l'interface de l'Éditeur de scène. Sélectionnez-cliquez ensuite sur le nouvel objet, sélectionnez Edit object et dans la liste qui s'affiche, cliquez sur Shape painter. Vous devrez peut-être faire défiler la liste pour le trouver.

Éditer les propriétés

Il s'agit ensuite d'éditer les propriétés de l'objet pour le faire correspondre à ce que nous voulons. De nouveau, cliquez sur l’objet créé dans la liste des propriétés à droite. Sélectionnez Edit object dans la liste déroulante qui s'affiche. Une nouvelle fenêtre s'ouvre. Elle affiche les propriétés de l'objet Shape painter.

Changer la couleur et l'opacité

La fenêtre des propriétés du Shape painter présente des options permettant de changer

  • la couleur du contour de l'objet (Outline color),
  • l'opacité de contour de l'objet (Outline opacity),
  • l'épaisseur de ce contour (Outline size),
  • la couleur de remplissage de l'objet (Fill color),
  • l'opacité du remplissage (Fill opacity).

Position relative de l'object

La position par défaut des formes que nous dessinons à l'écran est relative à la positon de l'objet Shape painter dans la scène.

Dans le cas d'une position relative activée (case cochée dans la figure ci-dessus), la position de la forme dessinée sur l'écran correspondra à la positon 0 sur les axes X et Y. Ce sera la position de l'objet Shape painter. Autrement dit, si nous voulons dessiner une forme dont la position sur l’écran est de 100 pixels sur X et de 100 pixels sur Y, sa position sera située à 100 pixels de l’objet Shape painter où que ce dernier se trouve sur l’écran.

Lorsque la case est décochée, la position 0 sur les axes X et Y se trouve dans le coin supérieur gauche de la scène, quelle que soit la position de l'objet.

Dessiner une forme

Pour dessiner une forme, créez comme d'habitude un nouvel objet à l'aide de l'Éditeur d'objets. Ajoutez ensuite l'objet Shape painter à la scène. Si nous lançons l'aperçu maintenant, nous ne verrons rien. L'objet Shape painter ajoute simplement la fonctionnalité pour l'objet. Pour l'instant, il ne contient que les propriétés / paramètres du Shape painter. Pour dessiner une forme, nous devons utiliser l'Éditeur de scènes (Scene Events Editor). Si vous n'êtes pas familier avec les événements, je vous recommande de consulter la page des événements sur le wiki .

Passons à l'éditeur d'événements de scène (Scene Events Editor) pour ajouter un événement. Une fois l'événement ajouté, cliquez sur le texte add action (ajouter une action). Les formes primitives sont listées dans le menu déroulant Primitive drawing.

Let go to the events editor and add an event, then click add action. Next find the events for Primitive drawing. We can choose from 3 different type of shapes to draw. Circle, Line and Rectangle. We are going to draw a rectangle on the screen so let select the Rectangle under drawing

Next, on the right side select the shape painter object we are going to use and for the top left position enter 0 for both X and Y and the bottom right position enter 100 for both X and Y.

No if we launch a preview it will draw a 100 pixels wide and 100 pixels high rectangle on the screen.

If we left the relative position enabled, you may notice our rectangle is in the the same position as the shape painter object even though it origin point is 0. Now if we disable that option and launch the preview again, you going to see our object is drawn in the top left corner of our scene. Using events we can also change any properties of a shape on the fly.

Examples

List of examples coming soon

  • selection box