De/Inputs and Outputs

Inputs und Outputs (Zusammengefasst "I/O") sind die Kommunikationswege der Entities(en), um in einer Map(en) zu kommunizieren. Entities haben zwei Methoden um miteinander zu kommunizieren: Sie können einen „Output“ an ein anderes Entity senden oder sie erhalten einen „Input“ von einem anderen Entity. Ein Entity könnte, sobald es „stirbt“, einen Output an ein anderes Entity senden, damit dieses die Farbe wechselt. Derselbe Ouput könnte auch dazu verwendet werden, um ein den spawn Input eines anderen Entities auszulösen. Die Output werden mit den Inputs über eine „Connection“ verbunden, welche festlegt welche Daten dem Empfänger zugestellt werden, mit wie viel Verzögerung dies stattfindet und ob der Output mehrmals gesendet werden kann. Outputs können mit jedem Input verbunden werden und umgekehrt geht es natürlich genauso. Das ermöglicht komplexe und mächtige Interaktionen zwischen den Entities.

Betrachten wir das logic_timer(en) Entity. Es könnte so konfiguriert sein, dass es den OnTimer Output „abfeuert“ sobald es das eingestellte Zeitlimit erreicht, welcher den ShowSprite Input eines env_sprite(en) auslöst (bzw. aufruft). Wenn der Timer sein Zeitlimit erreicht, wird das Sprite erscheinen. Wenn Sie die Connection Einstellungen verwenden, könnten Sie z.B. den Output erst nach zwei Sekunden auslösen oder es so einstellen, dass der Output nur einmalig abgefeuert wird.

Inputs

Inputs sind Kommandos, welche ein Entity dazu veranlassen den Zustand bzw. deren Tätigkeit zu ändern. Sie werden durch Outputs ausgelöst (bzw. aufgerufen) – sie können ohne Output nicht geändert werden.

Sie können sich die Liste der Inputs, welche ein Entity erhält, im Inputs Tab des object properties dialog(en). Wenn Sie auf den "mark" Button klicken, werden Sie zu dem Output weitergeleitet, welcher den Input auslöst.

Outputs

Hammer's "Object Properties" dialog

Outputs werden abgefeuert, sobald sicher der Status des Entitys verändert. Ein Timer(en) wird den Output abfeuern, sobald er sein Zeitlimit erreicht hat, ein Button(en) sendet den Output, wenn der Button gedrückt wird und eine Tür(en) sendet den Output, wenn sie geschlossen wird.

Output Events werden im Outputs Tab des object properties dialog(en) erstellt. Diese Schnittstelle stellt eine Liste der Outputs bereit, welche bereits von diesem Entity ausgehen. Es werden Konfigurationsfelder bereitgestellt, um den aktuell ausgewählten Output zu bearbeiten und es gibt Buttons, welche zur Erstellung bzw. zum löschen von Outputs benötigt werden. Der Button „mark“ bringt Sie zu dem Input, welcher durch den aktuell ausgewählten Output betroffen ist.

Das sind die Ouput Konfigurationsmöglichkeiten:

Output name

Legt fest, welches Event den Output veranlasst „abgeschossen“ zu werden. Z.B. ein trigger_multiple(en) kann einen OnTrigger Output abfeuern, wenn ein Spieler den Bereich betritt.

Target entity

Der targetname(en) oder classname(en) des Entitys, welches den Input erhalten soll. Der * Buchstabe wird als Suchplatzhalter (Wildcards) akzeptiert.

• Ein fettgedruckter Name bedeutet, dass der targetname mehrere Entities betrifft
• Ein roter Name bedeutet, dass sicher der targetname auf ein nicht vorhandenes Entity bezieht
  Fehler:Gültige classnames und Platzhalterwerte und special targetnames werden auch rot dargestellt. Keine Sorge: Die Engine wird diese richtig Beachten/Behandeln!

Input name

Der Input, welcher beim Zielentity ausgeführt werden soll.

Parameters

Sie können mit Hilfe von Parametern dem Zielentity Daten übergeben. Ein Parameter kann alles Mögliche sein: Wie laut ein Sound(en) abgespielt werden soll, den targetname(en) eines anderen Entity, oder vielleicht eine Farbe(en). Es hängt alles davon ab, welche Werte der Input akzeptiert. Wenn nichts akzeptiert wird, wird das Feld ausgegraut.

Manche Outputs, wie der OutValue des math_counter(en), generieren eigenständig Parameter. Um einen generierten Parameter zu verwenden, müssen Sie das Feld „reading“ mit <none> füllen.

Bemerkung:Falls der Output Value ein targetname(en) ist, kann es sein, dass dieser nicht einzigartig ist!

Time delay

Die Anzahl der Sekunden die nach dem Output Event vergeht, bevor der Output abgefeuert wird.

Fire once only

Falls diese Option aktiviert ist, wird der Output nach dem Abfeuern gelöscht.

Einen einfachen Auslöser erstellen

Das ist ein Beispiel wie man einen einfachen Auslöser mit Inputs und Outputs erstellen kann, damit ein Sound abgespielt wird, sobald der Spieler einen bestimmten Bereich betritt.

Öffnen Sie eine Map und fügen Sie ein ambient_generic(en) hinzu (Schreiben Sie "ambient_1" in das Name Feld). Gehen Sie in die Object Properties und wählen Sie ein Soundfile, welches abgespielt werden soll, und wählen Sie im Tab Flags "Start Silent" aus. Wählen Sie die "tools/toolstrigger" Textur aus und erstellen Sie damit einen würfelförmigen Brush. Führen Sie auf diesem Brush einen Rechtsklick aus und benutzen Sie den "Tie to Entity(en)" Befehl und erstellen Sie ein trigger_once(en) Entity. Gehen Sie zum Outputs Tab und klicken Sie auf Add....

Setzen Sie "My output named" auf "OnStartTouch". Der Output wird nun ausgelöst, sobald ein Spieler den Brush berührt.

Setzen Sie "Targets entities named" auf "ambient_1". Sie können dazu den „nach unten“ Pfeil der Tastatur verwenden. Das Ziel des Outputs ist nun der ambient_generic den Sie schon platziert haben.

Setzen Sie "Via this input" auf "PlaySound". Diese Option wählt die PlaySound Aktion aus der Aktionsliste des ambient_generic, welche den Sound abspielen wird.

Klicken Sie auf Apply um Ihre Änderungen zu speichern und schließen Sie das Fenster. Nun haben wir den Auslöser erstellt, welcher nun einen Sound abspielen wird, sobald der Spieler den Bereich betritt.

Wenn Sie nun die Eigenschaften des ambient_generic anschauen, werden Sie sehen, dass der Output des Auslösers automatisch in einen Input des ambient_generic Entity konvertiert worden ist.

Wenn Sie nun die Map kompilieren und den Auslöser testen wollen, stellen Sie sicher, dass alle nötigen Elemente vorhanden sind (Startpunkt für den Spieler, Licht, etc) und Sie den Sound bei dem ambient_generic Entity richtig hinterlegt haben.

Debugging

Source stellt eine Reihe von verschiedenen debugging Tools zur Verfügung, um Probleme mit den I/O Anweisungen zu beheben.

Natürlich ist der object properties dialog auch ein debugging Tool. Ungültige Inputs und Outputs werden rot dargestellt; die I/O Icons am unteren Rand des Dialogs verändern sich auch dementsprechend. Ungültige Outputs werden auch im Check For Problems(en) Dialog des Hammer Editors dargestellt (Alt+P). Sie sollten bevor Sie die Map kompilieren immer nach eventuell vorhandenen Problemen schauen.

Fehler: Gültige classnames und Platzhalterwerte und special targetnames werden auch rot dargestellt. Keine Sorge: Die Engine wird diese richtig Beachten/Behandeln!

Es gibt auch eine Anzahl von Konsolen(en) Kommandos und Variablen, welche Ihnen helfen werden, Fehler zu finden während Ihre Map läuft:

developer <0-2>

Der Developer mode(en) Berichtet in der Konsole über alle Entity I/O und falls Sie sich nicht auf einem dedicated server(en) befinden, werden Cheats(en) aktiviert (Cheats werden für alle folgenden Kommandos benötigt). Wenn Sie developer 2 aktiviert haben, werden Ihnen zusätzlich die letzten acht Reihen der Konsole am oberen Bildschirmrand angezeigt.

ent_messages_draw <bool(en)>

Zeigt dieselben Informationen wie der developer Mode, allerdings wird es nicht in der Konsole ausgegeben sondern direkt auf dem Entity in der 3D Welt.

ent_fire <targetname(en) oder classname(en)> <input> <parameter>

Dieser „extrem“ nützliche Befehl erlaubt es Ihnen manuelle Inputs zu jeder Zeit und auf jedes beliebige Entity zu feuern. Wenn Sie z.B. eine Tür schon früher öffnen wollen, müssen Sie ent_fire my_door unlock eingeben, gefolgt von einem ent_fire my_door open (falls Sie etwas faul sind).

Wie das "output target" Feld in Hammer, unterstützt ent_fire classnames und Platzhalter. Sie können auch ent_fire npc_* ignite, probieren Sie es aus!

Tipp:Bei ent_fire können Sie ein spezielles !picker(en) targetname benutzen. Benutzen Sie es, um Ziele mit Ihrem Fadenkreuz auswählen zu können.

ent_pause

Dieser Befehl pausiert alle Entities einer Map mit Ausnahme des Spielers (wiederholen Sie den Befehl, damit die Entities den Pausenmodus verlassen). Dieser Befehl wurde erstellt, um mit dem ent_step Befehl leichter arbeiten zu können.

ent_step <number of steps>

Wenn der Befehl zusammen mit ent_pause benutzt wird, führt dieser Befehl eine festgelegte Anzahl von I/O Schritten aus, um danach wieder in den Pausemodus zu schalten (Standard ist 1).

Siehe auch

• Entity erstellung(en)
• Liste aller Entities(en)
• Targetname(en)
• Benutzer Inputs und Outputs(en)