Table of Contents
SVG dynthemes test
Content → Rocview → SVG Themes
| Here you go directly to the Rocrail-Workspace-Download |
Foreword 1:
This documentation was created with this: Status 09.11.2024
- Update 14.11.2024
| Area | Details | Remarks |
|---|---|---|
| Control | Rocrail | Version 2.1.5242+ (macOS "Sequoia" on Apple M4 CPU) |
| Computers | MacBook Pro (M2) | macOS 14.5 (Sonoma) |
| SVG | 13.11.2024 | dynthemes/SpDrS60, dynthemes/Roads, dynthemes/Accesories, userthemes/HL |
| Mobil Device | iPad (10.Generation) | 10,9" Multi-Touch Display; iPadOS 17.6.1 |
| iPad | RocControl | Version 24.11.14-2 |
Foreword 2:
- the use of this solution is at your own risk;
- regular backups of the Rocrail workspace are recommended.
A) Task
To test the RocControl software dynamic SVG symbols had to be constructed. All single test Rocrail plans were now brought together inside this Rocrail plan
This documentation will describe how to construct extensions of this plan and how to use this plan.
B) Solution Details
B1) Structure of the test plan
The Rocrail plan uses a Rocrail layer to test a certain kind of SVG symbols:
- 0Admin
- 1Basics
- 2Switches
- 3Signals
- 4Roads
- 5Accessories
- 6dummy
- 7MultiAspect
There are buttons available on each layer to test variations of the symbols:
- state "occupied"
- state "route lock"; optional with "shunting"
The button "id2state" helps to define some of the attribute values of certain objects during the construction phase of a layer.
B2) Layer description
B2.0) Layer 0Admin
Layer "0Admin" is useful to distribute test informations to each layer.
| Button | Meaning |
|---|---|
| "Textinhalt initialisieren" | resets the textfields of layer 0Admin to default values |
| text fields | setup the text content that should be distributed to the layers |
| "Textinhalt auf alle Ebenen verteilen" | distribute all text field content of layer 0Admin to each other layer |
Both buttons use the XMLScript "ac_distribute_text_content.xml" .
B2.1) Layer 1Basics
Layer 1Basics displays all objects of the SpDrS60 / SLIM-COLOR main symbols.
B2.2) Layer 2Switches
Layer 2Switches displays all states of all switch objects.
B2.3) Layer 3Signals
Layer 3Signals displays all states of all signal objects.
B2.4) Layer 4Roads
Layer 4Roads displays all road objects.
B2.5) Layer 5Accessories
Layer 5Accessories displays all accessory objects.
B2.6) Layer 6dummy
Layer 6dummy may be used for own tests.
B2.7) Layer 7MultiAspect
Layer 7MultiAspect displays a multi aspect signal.
B3) Layer construction
B3.0) Naming conventions
- Layers are numbered from 0 to 9 (one digit).
- All object IDs are named by
– a two letter object abbreviation
– a 3 digit object number starting from 001
- If the object should have a defined state
– the object ID must be expanded by a command or a state;
– examples: straight, turnout, left, right, …, red, green, …, on, off
| Examples | ||
|---|---|---|
| Object | normal | special |
| layer | 0Admin, 1Basics, … | - |
| text | tx… | txN_info01, txN_info02, txN_info03, txN_info04, … |
| block | bkN01, bkN02, … | bkN98, bkN99 |
| route | … | [bkN98-]-[bkN99+] |
| output | co… | coN_id_2_state, coN_occupied, coN_route_lock, coN_shunting, … |
| switch | swN01, swN02, … | swN01_straight, swN01_turnout, swN01_left, swN01_right, … |
| signal | sgN01, sgN02, … | sgN01_blank, sgN01_green, sgN01_red, sgN01_white, sgN01_yellow, … |
| sensor | fbN01, fbN02, … | fbN01_off, fbN01_on, … |
| track | tkN01, tkN02, … | - |
| staging block | sbN01, sbN02, … | - |
| fiddle yard | seltabN01 | - |
| turntable | ttN01 | - |
(N = layer number from 0 to 9 )
B4) XMLScripts
B4.1) ac_distribute_text_content
| actionid | parameters | description |
|---|---|---|
| ac_distribute_text_content | - | distribute all text field content of layer 0Admin to each other layer |
| ac_id_2_state | N bkN98 [bkN98-]-[bkN99+] | define some of the attribute values of certain objects during the construction phase of a layer; the operation is restricted to - layer N; referenced as %param1% - block bkN98; referenced as %param2% - route [bkN98-]-[bkN99+]; referenced as %param3% |
(N = layer number from 0 to 9 )
B5) Actions
B5.1) Action definitions
| actionid | description |
|---|---|
| ac_auto_on | the Auto Mode is set ton ON |
| ac_bkN98_occupied | locomotive lcN9 is placed to block bkN98 |
| ac_bkN99_occupied | locomotive lcN9 is placed to block bkN99 to set bkN98 to free |
| ac_bkN98_route_lock | locomotive lcN9 is started in block bkN98 using route [bkN98-]-[bkN99+] |
| ac_bkN98_route_unlock | route [bkN98-]-[bkN99+] is unlocked |
| ac_bkN98_shunting_on | shunting is set to ON at locomotive lcN9 |
| ac_bkN98_shunting_off | shunting is set to OFF at locomotive lcN9 |
(N = layer number from 0 to 9 )
Every layer requires this set of actions.
B5.2) Action calls
| callerid | action | parameters |
|---|---|---|
| coN_id_2_state | ac_id_2_state | N,bkN98,[bkN98-]-[bkN99+] |
| coN_occupied | ac_bkN98_occupied ac_bkN99_occupied | - |
| coN_route_lock | ac_auto_on ac_bkN98_occupied ac_bkN98_route_lock ac_bkN98_route_unlock | - |
| coN_shunting | ac_bkN98_shunting_off ac_bkN98_shunting_on | - |
(N = layer number from 0 to 9 )
C) Rocrail workspace
The download workspace "svg_dynthemes_test_wiki_20241114.zip" contains the following files:
| file | meaning |
|---|---|
| plan.xml | the Rocrail plan file |
| rocrail.ini | the Rocrail ini file |
| ac_id_2_state.xml | an XML script |
| ac_distribute_text_content.xml | an XML script |
back to the solution-details.
D) Outlook
You are welcome to implement your own ideas on the basis of this solution.
Have fun and good luck.