actions-de
Differences
This shows you the differences between two versions of the page.
| Previous revision | |||
| — | actions-de [2025/04/22 11:32] (current) – [Hinweise] stefanf | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== Dialog: **WAS** eine Aktion ausführen soll ====== | ||
| + | [[: | ||
| + | [[german|Inhalt]] -> [[german# | ||
| + | * **[[actions-de|Aktionen definieren]]** | [[actionctrl-de|Aktions-Steuerung]] | [[actionctrl-de# | ||
| + | |||
| + | \\ | ||
| + | |||
| + | | ||
| + | Diesen Dialog erreicht man über Menüleiste -> Tabellen -> Aktionen oder über [ALT]+[3] | ||
| + | \\ | ||
| + | |||
| + | =====Übersicht===== | ||
| + | {{: | ||
| + | ====Spalten der Tabelle==== | ||
| + | Die Festlegung der **Kennung** ist unter **[[# | ||
| + | Der **Typ** wird in der Registerkarte **[[# | ||
| + | Der angezeigte Typ ist ein __**[[actions-de# | ||
| + | ===Doppel-Klick=== | ||
| + | Ein Doppel-Klick öffnet __**[[: | ||
| + | |||
| + | |||
| + | ===Kennung=== | ||
| + | Die Kennung der Aktion kann hier editiert / geändert werden. Die Kennung ist beliebig, sollte aber keine Umlaute enthalten.\\ | ||
| + | Mit Klick auf die Schaltfläche **" | ||
| + | |||
| + | ===nicht verwendet=== | ||
| + | Ist gesetzt, wenn für die ausgewählte Aktion __kein__ Eintrag in der Registerkarte ' | ||
| + | |||
| + | ===Beschreibung=== | ||
| + | Freitext zur Beschreibung der Aktion.\\ | ||
| + | Mit Klick auf die Schaltfläche **" | ||
| + | Falls keine Beschreibung angegeben ist, werden in diese Spalte // | ||
| + | |||
| + | === Typ === | ||
| + | **[[# | ||
| + | \\ | ||
| + | ===== Schaltflächen/ | ||
| + | ==== Neu ==== | ||
| + | Mit dieser Schaltfläche wird eine neue Aktion " | ||
| + | |||
| + | ====Verwendung...==== | ||
| + | Verwendete Aktionen werden mit " | ||
| + | |||
| + | ==== Löschen ==== | ||
| + | Die markierte Aktion wird gelöscht.\\ | ||
| + | |||
| + | ==== Dokumentation==== | ||
| + | Eine Liste aller definierten Aktionen wird im Standardbrowser dargestellt.\\ | ||
| + | |||
| + | ==== Test ==== | ||
| + | Die markierte Aktion kann testweise - ohne Aktionssteuerung eines Objektes - ausgelöst werden.\\ | ||
| + | |||
| + | ==== Parameter ==== | ||
| + | Es kann ein Wert gesetzt werden, der beim Test der Aktion den Parameter der **[[# | ||
| + | |||
| + | ====Suchen==== | ||
| + | Filtert mit " | ||
| + | \\ | ||
| + | |||
| + | ===== Gemeinsame Dialog-Schaltflächen ===== | ||
| + | {{: | ||
| + | Siehe: __**[[: | ||
| + | |||
| + | =====Definition===== | ||
| + | {{: | ||
| + | |||
| + | ====Typ u. Kennung==== | ||
| + | Zusammen definieren sie, welches Objekt eine Aktion ausführen soll.\\ | ||
| + | Ist im Auswahlfeld " | ||
| + | \\ | ||
| + | Bei den Typen Lokomotive und Funktion kann das Feld Kennung leer bleiben, wenn die Aktion durch eines der folgenden Objekte ausgelöst wird: | ||
| + | * Rückmelder **< | ||
| + | * Fahrstraße | ||
| + | * Weiche | ||
| + | * Fahrplan | ||
| + | Die __**[[actionctrl-de|Aktions-Steuerung]]**__ dieser Objekte übermittelt der Aktion für die Typen Lokomotive und Funktion bei leerem Kennungs-Feld automatisch die Kennung der entsprechenden Lokomotive.\\ | ||
| + | Dadurch können alle Lokomotiven, | ||
| + | z.B. bei der Ausfahrt aus dem Schattenbahnhof das Licht einschalten, | ||
| + | ohne dass die Aktion für jede Lokomotive einzeln definiert werden muss.\\ | ||
| + | Im Dialog **[[actioncond-de|Aktions-Bedingung]]** können zusätzliche Abhängigkeiten definiert werden. | ||
| + | |||
| + | **< | ||
| + | ==== Sub-Kennung ==== | ||
| + | Nur für die Verwendung mit __**[[: | ||
| + | |||
| + | ====Befehl==== | ||
| + | Definiert den Befehl, der vom ausgewählten Objekt ausgeführt werden soll.\\ | ||
| + | Es werden nur die Befehle zur Auswahl angeboten, die das betreffende Objekt ausführen kann. \\ | ||
| + | |||
| + | ===Doppelte Anführungszeichen=== | ||
| + | Wenn der Rocrail-Server unter Windows läuft, fügt die Option zusätzliche einfassende Anführungszeichen hinzu: | ||
| + | < | ||
| + | "" | ||
| + | </ | ||
| + | Ohne diese Option sieht der Befehl wie folgt aus: | ||
| + | < | ||
| + | " | ||
| + | </ | ||
| + | ===Asynchron=== | ||
| + | Das externe Programm oder externe Script bzw. XmlScript wird asynchron ausgeführt, | ||
| + | Diese Option darf __nicht__ aktiviert sein, wenn auf das Ergebnis((z.B. die Bild-Datei eines Erfassungs(Grabbing)-Programms)) des ext. Programms oder Scripts gewartet werden muss. (Zum Beispiel: **[[: | ||
| + | \\ | ||
| + | |||
| + | ====Parameter==== | ||
| + | Einige Befehle benötigen zusätzliche Parameter (Siehe Tabelle unten).\\ | ||
| + | \\ | ||
| + | =====Die Typen, Befehle & Parameter===== | ||
| + | Einige Befehle benötigen noch einen zusätzlichen Eingabewert.\\ | ||
| + | ^ Typ ^ Typ- \\ Kürzel ^ Kennung ^ Befehl \\ deutsch in ( ) ^ Parameter ^ Beschreibung ^ | ||
| + | | Ausgang | ||
| + | | Zubehör-Gruppe | ||
| + | | Rückmelder | ||
| + | | Ext. Programm starten. | ext | entfällt | Pfad, Name u. Parameter \\ des ext. Programmes, der **[[# | ||
| + | | Weiche | sw |Weiche | ||
| + | | Fahrstraße | st |Fahrstraße | set (stellen), lockset (verschlossen stellen), lock (verschliessen), | ||
| + | | System | ||
| + | | Signal | ||
| + | | Block | bk |Block | schedule (Fahrplan), schedule_manual (Fahrplan manuell), tour (Tour), unlock (entriegeln), | ||
| + | | Aufstell-Block | sb |Aufstell-Block | unlock (entriegeln), | ||
| + | | Lokomotive | lc |Lokomotive | go (starten), | ||
| + | | Funktion | ||
| + | | Drehscheibe | tt |Drehscheibe | 0...47, 180 (180< | ||
| + | | FiddelYard | seltab | ||
| + | | Text | tx | Text-Objekt | update (aktualisieren), | ||
| + | | Sound | sound | - | play (abspielen), | ||
| + | | [[: | ||
| + | | Wagen | car | Wagen | empty (leer), loaded (beladen), maintenance (Wartung)| Der neue Wagen-Status. | - | | ||
| + | | Fahrdienstleiter | operator | ||
| + | | Ortschaft | location | Ortschaft | minocc (min. Belegung), fifo, go, schedule, scheduletable | Setzt die minimale Belegung in dieser Ortschaft. \\ go und schedule starten eine zufällige Lok. | Parameter: minocc-Anzahl oder 0/1 für FiFo-De-/ | ||
| + | | Wetter | weather | ||
| + | | Licht | light | flip, enable, disable | Aktiviert ein Licht der **[[: | ||
| + | | Uhr | clock | - | set (einstellen) | Teiler, | ||
| + | **< | ||
| + | **< | ||
| + | **< | ||
| + | **< | ||
| + | |||
| + | \\ | ||
| + | ====Hinweise==== | ||
| + | ===Typ "Ext. Programm starten" | ||
| + | Wenn dieser Typ verwendet wird, um ein externes Programm oder ein Script auszuführen, | ||
| + | Alternativ kann ein Programm auf einem Unix-System in seinem eigenen Prozess gestartet werden (myprog.sh &)\\ | ||
| + | XMLScript-Dateien müssen ohne Pfad eingestellt werden, siehe __**[[: | ||
| + | |||
| + | Das Abspielen einer Ton-Datei kann z.B. in dem Skript definiert werden.\\ | ||
| + | |< >| | ||
| + | ^Betriebsystem^ Befehl ^ Hinweise ^ | ||
| + | |Windows|'' | ||
| + | |Ubuntu|'' | ||
| + | |Suse|'' | ||
| + | |Raspi|'' | ||
| + | |||
| + | ===Befehls-Rekorder-Datei abspielen=== | ||
| + | Eine Befehls-Rekorder-Datei, | ||
| + | Siehe: **[[rocview: | ||
| + | Zusatzliche Parameter werden ignoriert. | ||
| + | |||
| + | ===XML-Script=== | ||
| + | Eine XML-Datei, *.xml, kann auch mit dem Typ "Ext. Programm starten" | ||
| + | Siehe: **[[xmlscripting-en|XMLScripting (en)]]**\\ | ||
| + | Zusätzliche Parameter werden ignoriert.\\ | ||
| + | |||
| + | ===espeak=== | ||
| + | Wenn **[[http:// | ||
| + | '' | ||
| + | Die aufrufende Aktion ergänzt die Befehlszeile um den aktualisierten Text.\\ | ||
| + | \\ | ||
| + | Die Pfadangaben sind natürlich an die jeweilige lokale Konfiguration anzupassen.\\ | ||
| + | Falls Rocrail-Server und Rocview auf unterschiedlichen PCs laufen, wird das Programm am **Server-PC** ausgeführt. Die Pfadnamen zum Programm sind entsprechend zu wählen. | ||
| + | \\ | ||
| + | === Balabolka === | ||
| + | Wenn **[[https:// | ||
| + | '' | ||
| + | Die aufrufende Aktion ergänzt die Befehlszeile um den aktualisierten Text.\\ | ||
| + | \\ | ||
| + | Die Pfadangaben sind natürlich an die jeweilige lokale Konfiguration anzupassen.\\ | ||
| + | Falls Rocrail-Server und Rocview auf unterschiedlichen PCs laufen, wird das Programm am **Server-PC** ausgeführt. Die Pfadnamen zum Programm sind entsprechend zu wählen. | ||
| + | \\ | ||
| + | ===VLC=== | ||
| + | **[[https:// | ||
| + | Die Aktion wird folgendermaßen definiert: | ||
| + | Typ: "Ext. Programm starten" | ||
| + | Voreinstellung der Optionen " | ||
| + | Befehl: '' | ||
| + | Parameter: '' | ||
| + | |||
| + | Erklärung: | ||
| + | '' | ||
| + | |||
| + | Die Optionen beginnen jeweils mit **doppeltem** Bindestrich: | ||
| + | '' | ||
| + | '' | ||
| + | '' | ||
| + | |||
| + | Weitere Optionen:\\ | ||
| + | '' | ||
| + | |||
| + | Diese Aktion kann z. B. in einem Block oder via Rückmelder ausgelöst werden.\\ | ||
| + | |||
| + | * Forum-Themen mit Beispielen für mehrkanalige Sound-Wiedergabe | ||
| + | * **[[https:// | ||
| + | * **[[https:// | ||
| + | |||
| + | \\ | ||
| + | |||
| + | ==== Laufzeit ==== | ||
| + | //In 100ms-Einheiten// | ||
| + | Die Dauer einer Aktion für Funktionen; 10 = 1s. Null = dauernd. Wird nur von Funktions-Befehlen verwendet. | ||
| + | * **Hinweis: | ||
| + | |||
| + | ==== Zeitgeber ==== | ||
| + | //In ms//\\ | ||
| + | Mit diesem Parameter ist eine verzögerte Ausführung der konfigurierten Aktion einstellbar. | ||
| + | In der Praxis kann dies verwendet werden, um z.B. eine durch einen Rückmelder getriggerte Aktion erst dann auszuführen, | ||
| + | nachdem die hier eingetragene Zeit abgelaufen ist.\\ | ||
| + | Beispiel: 5000 = 5s. | ||
| + | \\ | ||
| + | Damit kann z.B. einen Achtungspfiff kurz vor einem Tunnel abgegeben werden, ohne dass dort extra einen Rückmelder installiert sein muss. | ||
| + | Die entsprechende Aktion kann also beim letzten (**evtl. weit entfernten**) Rückmelder vor dem Tunnel getriggert werden, | ||
| + | wird aber durch die Zeitverzögerung erst knapp vor dem Tunnel ausgeführt.\\ | ||
| + | \\ | ||
| + | Eine weitere Anwendungsmöglichkeit kann z.B. durch eine Aktionssteuerung mehrere Aktionen gleichzeitig starten, | ||
| + | diese durch unterschiedliche Zeitverzögerungen aber nacheinander ausführen lassen. | ||
| + | * **Hinweis: | ||
| + | |||
| + | ==== Aktivierungszeit ==== | ||
| + | * **Standard: | ||
| + | * **Stunden: | ||
| + | * **Viertelstunden: | ||
| + | ===Benutze==== | ||
| + | Soll die Aktion zu bestimmten Uhrzeiten gestartet werden, wird " | ||
| + | Die Uhrzeit bezieht sich auf die interne Uhrzeit von Rocrail, und **nicht** auf die tatsächliche Uhrzeit. | ||
| + | Hier könnte es ggf. sinnvoll sein, die interne Uhr schneller laufen zu lassen, um einen 24-Stunden-Zyklus z.B. für eine Tag/ | ||
| + | Wenn die Option **[[: | ||
| + | |||
| + | ===Jede=== | ||
| + | Diese Aktion wird immer jede " | ||
| + | Sie kann durch eine Aktions-Steuerung mit Status " | ||
| + | **Benutze** muss gesetzt sein, um den **Jede**-Zeitgeber zu aktivieren.\\ | ||
| + | Die **Zufall**-Option muss deaktiviert sein.\\ | ||
| + | Das kleinste Ausführungs-Intervall ist eine Minute.\\ | ||
| + | Ein Beispiel hierzu siehe am Ende dieses Abschnittes. | ||
| + | |||
| + | ===Zufall=== | ||
| + | Diese Aktion wird in einem zufälligen Intervall ausgeführt.\\ | ||
| + | Die zufällige Aktivierungszeit liegt relativ zwischen 1 Minute und der definierten Aktivierungszeit.\\ | ||
| + | Die Auflösung erfolgt im Minuten-Maßstab.\\ | ||
| + | Die **Benutze**-Option muss gesetzt sein, um den Zufalls-Zeitgeber zu aktivieren.\\ | ||
| + | Die **Jede**-Option wird __nicht__ verwendet, wenn **Zufall** gesetzt ist.\\ | ||
| + | |||
| + | ===Aktiviert=== | ||
| + | Option vor Aktivierung; | ||
| + | |||
| + | == Beispiel == | ||
| + | In der Plan-Datei sieht ein entsprechender Eintrag z.B. so aus: | ||
| + | <code xml> | ||
| + | < | ||
| + | <ac id=" | ||
| + | < | ||
| + | </ | ||
| + | Siehe auch: http:// | ||
| + | \\ | ||
| + | ** Beispiel zu Aktivierungszeit -> Benutze -> Jede ** \\ | ||
| + | Die Aktion wird in einem Schalter 2x aufgerufen, 1x mit ON und 1x mit OFF\\ | ||
| + | Schalter = Grün ... Aktion wird ausgeführt\\ | ||
| + | Schalter = Rot .... Aktion wird gestoppt\\ | ||
| + | \\ | ||
| + | {{: | ||
| + | {{: | ||
| + | {{: | ||
| + | |||
| + | \\ | ||
| + | =====Verwendung===== | ||
| + | Diese Registerkarte listet alle Objekte //" | ||
| + | |||
| + | {{: | ||
| + | |||
| + | Ein Doppelklick auf ein Objekt der Liste öffnet den zugehörigen Dialog **[[: | ||
| + | |||
| + | \\ | ||
| + | =====Schnittstelle===== | ||
| + | Die Adresse des Sound-Player-Gerätes/ | ||
| + | {{: | ||
| + | Wenn der Sound-Befehl '' | ||
| + | Wenn der Sound-Befehl '' | ||
| + | * RocNet | ||
| + | * RocNetNode | ||
| + | * Virtual | ||
| + | |||
| + | \\ | ||
| + | =====Bericht===== | ||
| + | {{: | ||
| + | \\ | ||
| + | Ein Doppelklick auf einen Eintrag öffnet den Eigenschaftsdialog des ausgewählten Objekts.\\ | ||
| + | ====Erzeugen==== | ||
| + | Erzeugt einen Bericht von allen verwendeten Aktionen in allen Objekten.\\ | ||
| + | |||
| + | |||