Table of Contents

Generate via route

ContentObjectsRoutes


With Rocrail 2.1.6171 a dialog to define "via-routes" has been introduced.
The dialog can be opened by clicking to "Rocview Menu → Track plan → Generate via route…"
-


Parameters

From block

Starting point of the route. Read also: Direction in Rocrail
The + option has to be activated if the locomotive should depart from the + side of the starting block.

The "From block" field can be filled by the keyboard
or by a click selection of the opened list of blocks.


To block

End point of the route. Read also: Direction in Rocrail.
The + option has to be activated if the locomotive should enter the destination block at the + side.

The "To block" field can be filled by the keyboard
or by a click selection of the opened list of blocks.


Via Blocks

Select the via blocks and make sure the blocks are in the correct order.
It is a comma separated list of block ID's without white space (blanks).


Using the "…" button for just one via block will help to generate the via block list in the required order.

Hint: as an additional feature the field "Via Blocks" can be left empty to generate a route from one block to a next block.
This is useful to generate alternative routes with different command sets for example.

Buttons


The dialog includes the standard buttons "?" (Help, link to this Wiki), "Cancel" and "OK".
The buttons "Cancel" and "OK" just close the dialog.

Generated route

If a route could be generated the Route dialog will popup with the new generated route.

The ID will get the extension "_via_[list of blocks]"

The ID may be edited by the user.

The "Description" field is with filled a verbal description of the generated route for example
"from [bk04] via [bk03,bk02] to [bk01]"

"Automatic generated" will be unchecked

Attention: in case of alternative routes between two blocks
the user should check the command list of the generated route
and modify the command list appropriately!

Clicking the OK button will save the generated route.
In addition the list of route IDs of the attribute "routeids" of the affected elements is updated with the newly generated route ID. This ensures that the affected plan elements will be properly illuminated.

Clicking the Cancel button will not save the generated route.

see Messages for problematic situations.

</> button

The </> button shows the temporary XML code of the generated route.

The code shows the list of commands.

The code shows the list of elements that will receive a new "routeids" entry.


Messages

In certain problematic situations the user will be informed by a dialog.

No fitting route available

If no fitting route can be calculated
the user will be informed by a dialog.


Overwrite existing route

If the calculated route does already exist
the user will be informed by a dialog.

"No" will leave the existing route unchanged.
"Yes" will overwrite the existing route.

By modifying the route ID
the last generated via-route
can be saved as an additional route.


Examples

— will come soon —