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.\\ | ||
+ | |||
+ | |||