Patch editor

Construisez de la logique en reliant des nœuds. Un patch tourne aussi vite que du code, et vous pouvez le lire sous forme de code à tout moment.

Cette page explique comment utiliser l'éditeur. Le rôle de chaque nœud est décrit dans Patches.

Ce que vous modifiez

Un patch peut appartenir à tout le projet, à l'espace, à une scène ou à un seul objet.

Vous avez ouvert	Vous modifiez
Patch editor dans la barre latérale gauche	le patch de la scène actuelle. Si elle n'en a pas, celui de l'espace ou du projet.
Edit logic dans les Behaviors d'un objet	le patch propre à cet objet
un fichier de patch dans Project assets	un patch réutilisable sur de nombreux objets

Show map, dans le coin inférieur gauche, dézoome jusqu'à une carte de tous les patchs du projet. Chaque patch y forme un groupe de nœuds. Double-cliquez sur un groupe pour l'ouvrir, ou faites un clic droit dessus et choisissez Go inside. Reveal how attached montre à quoi le patch est rattaché.

Pour créer un patch réutilisable, faites un clic droit dans Project assets et choisissez Create asset → Patch graph. Rattachez-le ensuite à un objet : dans les Behaviors de l'objet, cliquez sur Add behavior.

L'annulation et la collaboration en direct fonctionnent comme d'habitude.

Barre d'outils

Les boutons se trouvent sur les bords du canevas :

Bouton	Ce qu'il fait
+ Add node	Ouvre le menu des nœuds, classés par catégorie. En haut à gauche.
Nom du patch	Passe à un autre patch : Project patch, Space patch, Scene patch ou Entity patch…. Un niveau qui n'a pas encore de patch porte la mention Create. À côté de + Add node.
Show map	Affiche la carte de tous les patchs. En bas à gauche.
Variables	Un onglet sur le bord gauche. Ouvre les Variables et les Events du projet : vous les y ajoutez avec un nom et un type.
Code	Un onglet sur le bord droit. Affiche le script généré, en lecture seule, avec un bouton Copy.
Fit all	Une flèche au bord du canevas. Elle apparaît quand vos nœuds sont hors de l'écran et les ramène dans la vue.

Les onglets des bords apparaissent quand le pointeur s'en approche. Sur un écran tactile, ils sont toujours visibles.

Si certains nœuds ne peuvent pas s'exécuter, un avertissement apparaît à côté du nom du patch. Survolez les marques ! sur les nœuds pour savoir pourquoi.

Vérifiez un graphe avec Code

Code affiche le script exact que votre graphe est devenu. Si quelque chose ne marche pas, le lire est souvent plus rapide que de suivre les fils. Vous voyez aussi si le graphe fait bien ce que vous attendez.

Travailler avec le graphe

Action	Comment
Ajouter un nœud	Clic droit sur une zone vide du canevas (le nœud apparaît sous le curseur), ou clic sur + Add node.
Menu d'un nœud	Clic droit sur un nœud : copier, couper, dupliquer, coller, supprimer.
Sélectionner	Cliquez, ou tracez un cadre sur une zone vide du canevas. Maintenez Shift pour ajouter à la sélection.
Tout sélectionner	Ctrl + A
Supprimer	Delete ou Backspace
Copier / couper	Ctrl + C / Ctrl + X
Coller	Maintenez Ctrl + V : les nœuds suivent le curseur. Relâchez, ou cliquez, pour les poser.
Dupliquer	Ctrl + D
Zoomer	Molette de la souris, ou pincement sur un trackpad.
Se déplacer	Glissez avec le bouton du milieu de la souris, ou maintenez Space et glissez. Sur un trackpad, glissez avec deux doigts. Sur un écran tactile, glissez avec un doigt.
Replier un nœud	Cliquez sur le chevron de son en-tête pour masquer les ports inutilisés.

Relier des nœuds

Tirez un fil depuis un port. Les ports qui peuvent le recevoir s'allument, les autres s'assombrissent.

Lâchez un fil sur une zone vide

Vous obtenez un menu des nœuds qui peuvent recevoir ce fil. Choisissez-en un : le nouveau nœud est déjà relié. C'est bien plus rapide que d'ajouter un nœud puis de chercher son port.

• Pour rediriger ou supprimer un fil, attrapez-le près de son extrémité.
• Pour détacher une entrée, attrapez-la.
• Pour annuler un glisser, appuyez sur Escape ou faites un clic droit.

Types de ports

Chaque type de port a sa propre couleur :

Type	Couleur	Transporte
pulse	bleu clair	l'ordre dans lequel les choses s'exécutent
number	bleu	un nombre
boolean	orange	vrai ou faux
string	vert	du texte
vector	violet	trois valeurs : x, y et z
color	rose	une couleur
object	bleu foncé	une référence à un objet

pulse, object, vector et boolean ne se relient qu'à leur propre type. Les nombres, chaînes et couleurs se convertissent librement entre eux.

• Les ports vector s'ouvrent avec un chevron en trois prises séparées, x, y et z. Sur une entrée, cela construit un vecteur à partir de ses parties. Sur une sortie, cela le décompose.
• Un port object sans fil affiche la liste des objets de la scène. Laissez-le vide pour désigner l'objet auquel le graphe est rattaché.
• Les nœuds de constante, ainsi que les champs d'identifiant des nœuds de variable, de message et de global, se saisissent directement dans l'en-tête du nœud.

Taille du panneau

L'éditeur s'ouvre ancré en bas de l'écran. Le menu de son en-tête change sa position :

• Maximize l'étend à toute la vue.
• Tile window to bottom l'ancre de nouveau en bas.
• Undock en fait une fenêtre flottante.

Faites glisser ses bords pour le redimensionner.

---

Suite : UI editor — construisez l'interface 2D par-dessus votre scène.