Support
Wiki Documentation
Support Forum
Mobile
- andRoc Android
- Rocweb Browser
- WIO-Control ESP32
- Rocview Tablet
DIY
User
Wiki writer
Special
Legal
Support
Wiki Documentation
Support Forum
Mobile
DIY
User
Wiki writer
Special
Legal
The official themes are located in the subdirectory svg/themes.
All other sub directories are user defined themes.
The official theme is SpDrS60.
For testing and problem reporting this theme should be used.
All other themes must follow the naming, connection and size convention of the SpDrS60 theme.
Attention: For RocWeb and andRoc the SVG paths must be setted in the RocWeb dialog of the Rocrail properties. |
if no suitable SVG file is found for an Object type, the track plan shows an Error symbol at the position. |
![]() |
SVG file not found |
Note:
Possible causes:
Further themes must be defined, e.g.User, Accessories
.
The SVG number, Accessory option and/or Accessory number required for some Object types are not defined or are wrong defined.
Select the desired themes and restart Rocview to activate them.
If you have defined your own SVG symbol for a certain item, place it in the "Setup" list before the Theme that has the default symbol.
That means the first Theme determines how a SVG is portrayed.
The button opens the dialog Theme properties to the first SVG theme.
Adjust the pointsize for item IDs to fit the ID length choosen. Default is 7.
The Rocview has to be restarted for changes to take affect.
The item ID color. Default is black.
Adjust the pointsize for Block ID and for Text objects with zero pointsize.
Best results for: 1)
The field is to adjust the text pointsize from -100% to +100%. This could be of help in case multiple Rocviews, on different platforms/resolutions, are connected to the same Server.
The Rocview has to be restarted for changes to take affect.
If this is set to 3 then the objects start with 100: e.g. sw100
If this is set to 0 or 1, the objects start without leading zeroes: e.g. sw1
The character used to connect the locomotive and train IDs.
Default is an underscore character.
Example with an equals character: (LocoID="V20_020", TrainID="HsDh")
Replace 'on the fly' all stroke="rgb(0,0,0)"
with the selected color.
Could be of use in case the panel background is a dark color.
To reduce processor resources these options can be disabled.
There are several parameters that determine the Symbol Illumination.
By activating this option the normal switch positions will be shown in Cyan.2)
For reserved routes this color will change in Yellow.
Raster switch types are not supported by this option.
Only the SpDrS60 theme has the needed SVGs.
To get the route IDs automatically set in the switch objects the router must be started again if the routes were generated with a revision older then 7884.
In case of manual routes use the Select dialog.
Overwrites block occupancy in case a route is reserved.
Track and road symbols can be mixed in one layout:
The road symbols have the same naming as the track symbols but are prefixed with road-.
If you wish to use your own symbols in a track plan you have to create these symbols SVG format.
The symbol size is set in the svg file, but make sure those values are a multiple of 32.
Turntables are not supported in SVG because of its very complex nature.
The file names are predetermined for each state of a symbol as listed here: Symbol Names
Note: all file names must not contain capital letters
Only M, L, C and z are evaluated. All coordinates are rounded to integers.
The following example (track with blue outline filled yellow ) shows which information is basically evaluated by Rocview:
<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"> <g> <path stroke="blue" stroke-width="1" fill="yellow" d="M 0,16 L 2,13 L 29,13 L 31,15 L 31,16 L 29,18 L 2,18 L 0,16 z " /> </g> </svg>
<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"> <g> <circle cx="16" cy="12" r="5" fill="red" stroke="blue"/> </g> </svg>
Note: If the radius is zero this SVG element will be skipped.
<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"> <g> <ellipse cx="16" cy="12" rx="8" ry="4" fill="red" stroke="blue"/> </g> </svg>
Note: If the radius rx or ry is zero this SVG element will be skipped.
<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg"> <g> <polygon points="0,0 31,0 31,31 0,31" fill="red" stroke="blue"/> </g> </svg>
<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg"> <g> <rect x="2" y="2" rx="5" width="20" height="20" stroke="blue" fill="red"/> </g> </svg>
Setting rx > 0 will draw a rounded rectangle.
<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg"> <g> <line x1="0" y1="0" x2="31" y2="31" stroke="black" stroke-width="8"/> </g> </svg>
line
-Element the in the www.w3.org specifikation defined attribut stroke-linecap
will be not supported. line
-Element allways round. 3)<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg"> <g> <polyline points="0,31 15,8 15,24 31,0" stroke="blue"/> </g> </svg>
A second Graphics Container4) can be added in the SVG definition which will be alternated every second.
Note: Rocweb cannot support multiple <g> containers, and will show all overlapped.
<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"> <g> <path stroke="blue" fill="yellow" d="M 0,16 L 2,13 L 29,13 L 31,15 L 31,16 L 29,18 L 2,18 L 0,16 z " /> </g> <g> <path stroke="blue" fill="grey" d="M 0,16 L 2,13 L 29,13 L 31,15 L 31,16 L 29,18 L 2,18 L 0,16 z " /> </g> </svg>
This extension can be used to preview SVG symbols in the file explorer:
Ubuntu shows SVG previews out of the box.
The Finder shows only strict formatted SVGs.
Starting with revision 2.1.381, the following SVG header format is also supported by Rocview and will enable preview in the macOS Finder:
<svg width="100%" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg"> ... </svg>
For information on the viewBox attribute see:
The former width/height are now part of the viewBox: "x y width height". (Rocview only evaluates the width and height values of the viewBox.)
The width attribute is set to 100% to enable (pre)viewers to scale up to the available space. (Rocview do not evaluate this value.)
If the following option is manually set in the rocview.ini, the conversion will be done automatically:
<gui convertsvg="true" ... > ... </gui>