Patch Editor
Construisez de la logique en reliant des nœuds. Le graphe devient un vrai script et tourne exactement aussi vite que lui — vous pouvez lire le code généré à tout moment.
Ce que font réellement les nœuds est décrit dans Patches ; cette page porte sur l'usage de l'éditeur.
Ce que vous éditez
| Vous avez ouvert | Vous éditez |
|---|---|
| le bouton de la barre latérale | le graphe de la scène |
un fichier .patch des assets | un patch réutilisable, réenregistré avec Save |
Dans les deux cas, vos modifications passent par le chemin d'édition habituel : l'annulation et la collaboration en direct fonctionnent sans rien de plus.
La barre d'outils
| Bouton | Effet |
|---|---|
| + Add node | le menu des nœuds, par catégorie |
| Load example | des graphes tout faits pour démarrer ou pour apprendre |
| Node from object | un nœud de référence vers ce qui est sélectionné dans la scène |
| Code | le script généré, en lecture seule, avec un bouton de copie |
| Save patch | enregistrer le graphe comme fichier réutilisable |
Il montre le script exact qu'est devenu votre graphe. Si quelque chose ne se comporte pas bien, le lire va généralement plus vite que de suivre les fils — et c'est ainsi que vous confirmez que le graphe fait ce que vous croyez.
Travailler avec le graphe
| Action | Comment |
|---|---|
| Ajouter un nœud | clic droit sur le canevas vide (il apparaît sous le curseur), ou + Add node |
| Menu du nœud | clic droit sur un nœud — copier, couper, dupliquer, coller, supprimer |
| Sélectionner | cliquer ; tracer un rectangle ; Maj pour ajouter à la sélection |
| Tout sélectionner | Ctrl + A |
| Supprimer | Suppr ou Retour arrière |
| Copier / couper / coller | Ctrl + C / X / V |
| Dupliquer | Ctrl + D |
| Zoom | molette |
| Déplacer la vue | bouton du milieu, ou glisser le canevas |
| Replier un nœud | le chevron de son en-tête masque les ports inutilisés |
Câblage
Tirez depuis un port : les ports compatibles s'allument, les incompatibles s'estompent.
Vous obtenez un menu des nœuds capables de l'accepter, et en choisir un crée le nœud déjà connecté. C'est bien plus rapide que d'ajouter un nœud puis de chercher son port.
Saisissez un fil existant près de son extrémité pour le réacheminer ou le retirer ; saisissez une
entrée occupée pour la détacher. Échap ou un clic droit annule un glissement en cours.
Types de ports
Chaque type a sa couleur :
| Type | Couleur | Transporte |
|---|---|---|
pulse | bleu clair | le flux d'exécution |
number | bleu | un nombre |
boolean | orange | vrai ou faux |
string | vert | du texte |
vector | violet | un triplet x, y, z |
color | rose | une couleur |
object | bleu foncé | une référence vers un objet |
pulse, object et vector ne se connectent qu'à leur propre type. Les scalaires — number,
boolean, string, colour — se convertissent librement entre eux.
Les ports vecteur se déplient via un chevron en sockets x, y et z distincts : sur une
entrée cela assemble un vecteur à partir de morceaux, sur une sortie cela le décompose.
Un port object sans fil propose une liste déroulante des objets de la scène. Laissé vide, il
désigne l'objet auquel le graphe est attaché.
Les nœuds constants et 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. Le menu de redimensionnement de son en-tête le passe en étendu sur tout le viewport, le ramène ancré, ou en fait une fenêtre flottante. Tirez ses bords pour le redimensionner.
Suite : UI Editor