De/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:de 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:de 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

Hammer's "Object Properties" dialog

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:de kann einen OnTrigger Output abfeuern, wenn ein Spieler den Bereich betritt.

Target entity

Der targetname:de oder classname:de des Entitys, welches den Input erhalten soll. Der * Buchstabe wird als Suchplatzhalter 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 getestet 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:de 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 OutValue des math_counter:de, 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:de 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:de 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:de 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 getestet 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>

Developer mode reports all entity I/O to the console, and unless you're playing on a dedicated server also enables cheats (which is needed for all of the commands below). If you are in developer 2, you will also get the last eight lines of the console displayed at the top of your screen.

ent_messages_draw <bool>

This displays the same information as developer mode, except that instead of appearing in the console it's drawn in the 3D world at the location of the entities in question.

ent_fire <targetname or classname> <input> <parameter>

This extremely useful command allows you to manually fire inputs on any entity at any time. If you want to unlock a door ahead of time, you would type ent_fire my_door unlock, followed if you're feeling lazy by ent_fire my_door open.

Like the "output target" field in Hammer, ent_fire supports classnames and wildcards. If you want to ent_fire npc_* ignite, you can!

Tipp:ent_fire is where the special !picker targetname comes in. Use it to target whatever is under your crosshair.

ent_pause

This command pauses all entities in the map except the player; submit it again to unpause. It is designed for use with ent_step.

ent_step <number of steps>

When used with ent_pause, this command makes entities to perform a specified number of I/O steps before pausing again (default is 1).

See also

• Entity Creation:de
• List of entities:de
• Targetname:de
• User Inputs and Outputs:de
  Zu erledigen: Merge into this article