De/Inputs and Outputs

Inputs und Outputs (Zusammengefasst "I/O") sind die Kommunikationswege der , um in einer 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 Entity. Es könnte so konfiguriert sein, dass es den OnTimer Output „abfeuert“ sobald es das eingestellte Zeitlimit erreicht, welcher den ShowSprite Input eines 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 . Wenn Sie auf den "mark" Button klicken, werden Sie zu dem Output weitergeleitet, welcher den Input auslöst.
== Outputs ==
Outputs werden abgefeuert, sobald sicher der Status des Entitys verändert. Ein wird den Output abfeuern, sobald er sein Zeitlimit erreicht hat, ein sendet den Output, wenn der Button gedrückt wird und eine sendet den Output, wenn sie geschlossen wird.
Output Events werden im Outputs Tab des 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 kann einen OnTrigger Output abfeuern, wenn ein Spieler den Bereich betritt.
; Target entity
: Der oder 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 
; 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 abgespielt werden soll, den eines anderen Entity, oder vielleicht . 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 , generieren eigenständig Parameter. Um einen generierten Parameter zu verwenden, müssen Sie das Feld „reading“ mit <none> füllen. 
; 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 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 "" Befehl und erstellen Sie ein 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 Dialog des Hammer Editors dargestellt (). Sie sollten bevor Sie die Map kompilieren immer nach eventuell vorhandenen Problemen schauen.
Es gibt auch eine Anzahl von Kommandos und Variablen, welche Ihnen helfen werden, Fehler zu finden während Ihre Map läuft:
; developer <0-2>
: Der Berichtet in der Konsole über alle Entity I/O und falls Sie sich nicht auf einem befinden, werden 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 <>
: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 < oder > <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! 
; 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 ==
* 
* 
* 
*