Patch-Editor

Bauen Sie Logik, indem Sie Nodes verbinden. Ein Patch läuft so schnell wie Code, und Sie können ihn jederzeit als Code lesen.

Hier geht es um die Bedienung des Editors. Was jeder Node tut, steht unter Patches.

Was Sie bearbeiten

Ein Patch kann zum ganzen Projekt gehören, zum Raum, zu einer Szene oder zu einem einzelnen Objekt.

Sie haben geöffnet	Sie bearbeiten
Patch-Editor in der linken Leiste	den Patch der aktuellen Szene. Hat sie keinen, den des Raums oder des Projekts.
Logik bearbeiten unter Verhalten eines Objekts	den eigenen Patch dieses Objekts
eine Patch-Datei in Projekt-Assets	einen Patch, den Sie an vielen Objekten wiederverwenden können

Karte anzeigen unten links zoomt heraus auf eine Karte aller Patches im Projekt. Dort ist jeder Patch eine Gruppe von Nodes. Doppelklicken Sie auf eine Gruppe, um sie zu öffnen, oder klicken Sie sie mit der rechten Maustaste an und wählen Sie Hineingehen. Anzeigen, wie angehängt zeigt, woran der Patch hängt.

Um einen wiederverwendbaren Patch anzulegen, klicken Sie mit der rechten Maustaste in Projekt-Assets und wählen Asset erstellen → Patch-Graph. Hängen Sie ihn dann an ein Objekt: Klicken Sie unter Verhalten des Objekts auf Verhalten hinzufügen.

Rückgängig und die gemeinsame Live-Bearbeitung funktionieren wie gewohnt.

Werkzeugleiste

Die Schaltflächen liegen an den Rändern der Arbeitsfläche:

Schaltfläche	Was sie tut
+ Node hinzufügen	Öffnet das Node-Menü, nach Kategorien sortiert. Oben links.
Patch-Name	Wechselt zu einem anderen Patch: Projekt-Patch, Raum-Patch, Szenen-Patch oder Entitäts-Patch…. Eine Ebene, die noch keinen Patch hat, ist mit Erstellen markiert. Neben + Node hinzufügen.
Karte anzeigen	Zeigt die Karte aller Patches. Unten links.
Variablen	Ein Tab am linken Rand. Öffnet die Variablen und Ereignisse des Projekts. Dort legen Sie sie mit Namen und Typ an.
Code	Ein Tab am rechten Rand. Zeigt das erzeugte Skript, schreibgeschützt, mit einer Schaltfläche Kopieren.
Alles einpassen	Ein Pfeil am Rand der Arbeitsfläche. Er erscheint, wenn Ihre Nodes außerhalb des Bildschirms liegen, und holt sie zurück ins Bild.

Die Tabs an den Rändern erscheinen, wenn der Zeiger in ihre Nähe kommt. Auf einem Touchscreen sind sie immer zu sehen.

Können einige Nodes nicht ausgeführt werden, erscheint neben dem Patch-Namen eine Warnung. Zeigen Sie auf die !-Markierungen an den Nodes, um den Grund zu sehen.

Einen Graphen mit Code prüfen

Code zeigt genau das Skript, zu dem Ihr Graph geworden ist. Funktioniert etwas nicht, ist das Lesen oft schneller, als Verbindungen nachzuverfolgen. Außerdem sehen Sie so, ob der Graph tut, was Sie erwarten.

Mit dem Graphen arbeiten

Aktion	So geht's
Node hinzufügen	Rechtsklick auf eine leere Stelle der Arbeitsfläche (der Node erscheint unter dem Mauszeiger) oder Klick auf + Node hinzufügen.
Node-Menü	Rechtsklick auf einen Node: kopieren, ausschneiden, duplizieren, einfügen, löschen.
Auswählen	Klicken oder auf einer leeren Stelle einen Rahmen aufziehen. Mit gedrückter Shift-Taste erweitern Sie die Auswahl.
Alles auswählen	Ctrl + A
Löschen	Delete oder Backspace
Kopieren / ausschneiden	Ctrl + C / Ctrl + X
Einfügen	Ctrl + V gedrückt halten: Die Nodes folgen dem Mauszeiger. Lassen Sie los oder klicken Sie, um sie abzulegen.
Duplizieren	Ctrl + D
Zoomen	Mit dem Mausrad scrollen oder auf einem Trackpad die Finger zusammenziehen.
Verschieben	Mit der mittleren Maustaste ziehen oder Space gedrückt halten und ziehen. Auf einem Trackpad mit zwei Fingern ziehen. Auf einem Touchscreen mit einem Finger ziehen.
Node einklappen	Klicken Sie auf den Pfeil in seiner Kopfzeile, um ungenutzte Ports auszublenden.

Nodes verbinden

Ziehen Sie von einem Port aus. Ports, die die Verbindung annehmen können, leuchten auf, die anderen werden abgeblendet.

Verbindung auf eine leere Stelle fallen lassen

Sie erhalten ein Menü mit Nodes, die die Verbindung annehmen können. Wählen Sie einen aus, und der neue Node ist bereits verbunden. Das geht viel schneller, als erst einen Node hinzuzufügen und dann seinen Port zu suchen.

• Um eine Verbindung umzulegen oder zu entfernen, greifen Sie sie nahe an ihrem Ende.
• Um einen Eingang zu lösen, greifen Sie ihn.
• Um das Ziehen abzubrechen, drücken Sie Escape oder klicken Sie rechts.

Port-Typen

Jeder Port-Typ hat eine eigene Farbe:

Typ	Farbe	Überträgt
pulse	Hellblau	die Reihenfolge, in der Dinge ablaufen
number	Blau	eine Zahl
boolean	Orange	wahr oder falsch
string	Grün	Text
vector	Lila	drei Werte: x, y und z
color	Rosa	eine Farbe
object	Dunkelblau	einen Verweis auf ein Objekt

pulse, object, vector und boolean lassen sich nur mit ihrem eigenen Typ verbinden. Zahl, Text und Farbe werden frei ineinander umgewandelt.

• Vektor-Ports öffnen sich über einen Pfeil in getrennte Anschlüsse x, y und z. An einem Eingang setzen Sie so einen Vektor aus Teilen zusammen. An einem Ausgang zerlegen Sie ihn.
• Ein object-Port ohne Verbindung zeigt eine Liste der Objekte der Szene. Leer gelassen steht er für das Objekt, an dem der Graph hängt.
• Konstanten-Nodes sowie die ID-Felder an Variablen-, Nachrichten- und Global-Nodes füllen Sie direkt in der Kopfzeile des Nodes aus.

Größe des Panels

Der Editor öffnet sich unten angedockt. Über das Menü in seiner Kopfzeile ändern Sie, wo er sitzt:

• Maximieren füllt den ganzen Viewport.
• Fenster unten andocken dockt ihn wieder unten an.
• Abdocken macht ihn zu einem frei schwebenden Fenster.

Ziehen Sie an seinen Rändern, um die Größe zu ändern.

---

Weiter: UI-Editor – die 2D-Oberfläche über Ihrer Szene bauen.