Inputs and Outputs
Inputs und Outputs (Zusammengefasst "I/O") sind die Kommunikationswege der Entities, um in einer Map 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 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 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. 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 Timer wird den Output abfeuern, sobald er sein Zeitlimit erreicht hat, ein Button sendet den Output, wenn der Button gedrückt wird und eine Tür sendet den Output, wenn sie geschlossen wird.
Output Events werden im Outputs Tab des object properties dialog 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 kann einen OnTrigger Output abfeuern, wenn ein Spieler den Bereich betritt.
- Target entity
- Der targetname oder classname 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! [todo tested in?]
- 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 abgespielt werden soll, den targetname eines anderen Entity, oder vielleicht eine Farbe. Es hängt alles davon ab, welche Werte der Input akzeptiert. Wenn nichts akzeptiert wird, wird das Feld ausgegraut.
- Manche Outputs, wie der
OutValuedes math_counter, generieren eigenständig Parameter. Um einen generierten Parameter zu verwenden, müssen Sie das Feld „reading“ mit<none>füllen.
Hinweis:Falls der Output Value ein targetname 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 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" Befehl und erstellen Sie ein trigger_once 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 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! [todo tested in?]Es gibt auch eine Anzahl von Konsolen Kommandos und Variablen, welche Ihnen helfen werden, Fehler zu finden während Ihre Map läuft:
developer <0-2>- Der Developer mode Berichtet in der Konsole über alle Entity I/O und falls Sie sich nicht auf einem dedicated server befinden, werden Cheats aktiviert (Cheats werden für alle folgenden Kommandos benötigt). Wenn Sie
developer 2aktiviert haben, werden Ihnen zusätzlich die letzten acht Reihen der Konsole am oberen Bildschirmrand angezeigt. ent_messages_draw <bool>- 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 oder classname> <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 unlockeingeben, gefolgt von einement_fire my_door open(falls Sie etwas faul sind). - Wie das "output target" Feld in Hammer, unterstützt
ent_fireclassnames und Platzhalter. Sie können auchent_fire npc_* ignite, probieren Sie es aus!
Tipp:Bei ent_firekönnen Sie ein spezielles!pickertargetname 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_stepBefehl leichter arbeiten zu können. ent_step <number of steps>- Wenn der Befehl zusammen mit
ent_pausebenutzt wird, führt dieser Befehl eine festgelegte Anzahl von I/O Schritten aus, um danach wieder in den Pausemodus zu schalten (Standard ist 1).