User Tools

Site Tools


symbols-theme-props-en

This is an old revision of the document!


SVG Themes

Introduction

spdrs60.jpg SVG Themes are used for visualising Rocrail objects as graphical symbols in Rocview like tracks, blocks, signals and so on.


Basics

Installing one or more SVG Themes are required for Rocview's normal operation.
The only up to date and complete theme is the SpDrS60 Theme which is always maintained in case of new objects or changes in existing ones, and is set as primary default after installing Rocrail.
All other themes can be used as primary theme to replace a subset of the main SpDrS60 Theme; Secondary themes will supplement missing symbols of primary themes.
The SpDrS60 Theme should be set at least as one of the secondary themes.

  • A primary theme is listed on top of all other themes: See Symbol directories.
  • Only symbols, not covered by themes listed above a selected theme, can be supplemented.
  • To replace some symbols of other themes the wanted theme should be pushed up in the list to make it more primary.
  • All changes in the theme list will require a Rocview restart.

Designing country specific signal aspects in a new theme and place this theme as first one in the Symbol directories to replace the default aspects could make sense. In this case it is advised to check the signal documentation and symbol naming: Multi aspect signals.

Analyser

The Analyser will use always the SpDrS60 Theme as virtual reference for size, orientation and shape for calculating all possible routes.
In other words: If the graphical representation in Rocview does show a different layout in detail then when using the SpDrS60 as primary theme the analyser results will/can be unexpected or faulty from the Rocview point of view but must be considered as right.
The size, orientation and shape of a primary theme must resemble the SpDrS60 Theme for functional results.

Properties

Theme properties are optional and are placed directly in the Theme directory inside a properties.xml file. Settings made via the theme properties file are not changed by user settings made within Rocview. After a restart of Rocview the default settings from the theme properties file are restored.

Example

<theme id="SLIM" slim="true">
  <panel red="225" green="225" blue="225" border="false"/>
  <block showid="true" red="0" green="0" blue="0"/>
</theme>
  • The background color of the panel is lightgrey, RGB(225,225,225), without a border. Borders are only visible in modview mode.
    Block symbols show their own ID and show the reservation/occupancy ID in black, RGB(0,0,0).


Settings

The button [Properties] in den SVG theme setup opens this dialog.



When invoked, the dialog is filled with the data of the Properties file (properties.xml) of the first SVG theme.

ID

The name of the SVG theme.
Will only be displayed if the XML node <theme …> of the properties file contains an identifier "id". (for example, <theme id = "SpDrS60">)
Changes to the identifier or entries in an empty field will be not saved.

SLIM

  • 1. Check box activate SLIM themes.
  • 2. Check box activate the color for the SLIM theme.

Track splan

  • Check box activates a track plan frame.
    The [Background] button opens the standard "Color" dialog of the OS for selecting the color of a track plan or the free area of a module plan.
    The background of the Check box text "Border" shows the Track plan color, but changes only after closing and reopening the dialog.

Block

  • 1. Check box activates the identifier in the Block symbol.
    The [Color] button opens the standard "Color" dialog of the OS for selecting the color of the text in the Block symbol.
    The background of the Check box text "Show ID" shows the color, but changes only after closing and reopening the dialog.
    For the color "black", the check box text will be "swallow".
  • 2. Check box activates the display of a Short circuit area.
    The [Background] button opens the standard "Color" dialog of the OS for selecting the color of a defined grid area to display the Short circuit in the track plan.
    The background of the Check box text "Short circuit" shows the color, but changes only after closing and reopening the dialog.


Click on [OK] to save the data in the properties file.
If no properties file exists in the SVG topic, it will be created with the entered data.
Without settings in the dialog, the XML nodes in the file remain empty.

Attributes

symbols-theme-props-en.1552691698.txt.gz · Last modified: 2019/03/16 00:14 by rainerk