Differences

This shows you the differences between two versions of the page.

--- route-generate-en [2025/10/06 16:37] – rjversluis
+++ route-generate-en [2025/10/11 12:53] (current) – hermannk
@@ Line 5: / Line 5: @@
  \\
-**Rocview -> Track plan -> Generate via route...** \\
+With Rocrail 2.1.6171 a dialog to define "via-routes" has been introduced. \\
-{{:route:route-generate-en.png?600}}\\
+The dialog can be opened by clicking to "Rocview Menu -> Track plan -> Generate via route..." \\
+{{:route:generate_via_route_menue-en.png?}} - {{:route:generate_via_route_dialog-en.png?}}\\
 \\
-=====Define=====
-For generating a via route the plus sides are not evaluated.\\
+=====Parameters=====
 ====From block====
 Starting point of the route. Read also: __**[[:direction-en|Direction in Rocrail]]**__ \\
-The ''+'' option has to be activated if the train is **departing** from the ''+'' side of the starting block. \\
+The ''+'' option has to be activated if the locomotive should **depart** from the ''+'' side of the starting block. \\
+| {{:route:generate_via_route_from_block-en.png?219|}} | 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-en|Direction in Rocrail]]**__. \\
-The ''+'' option has to be activated if the train is **entering** the destination block at the ''+'' side. \\
+The ''+'' option has to be activated if the locomotive should **enter** the destination block at the ''+'' side. \\
+| {{:route:generate_via_route_to_block-en.png?219|}} | 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).\\
+| {{:route:generate_via_route_via_blocks_1-en.png?306|}} | {{:route:generate_via_route_via_blocks_2-en.png?306|}} | {{:route:generate_via_route_dialog-en.png?218|}} \\ 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=====
+{{:route:generate_via_route_dialog-en.png?218|}} \\
+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.\\
+| {{:route:generate_via_route_route_general-en.png?427|}} | 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 [[route:route-generate-en#messages| Messages]] for problematic situations. \\
  \\
-=====Generate=====
-If a route could be generated the Route dialog will popup with only the new generated route.\\
-Closing the Route dialog with OK will take over the new route.\\
+====</> button====
+The </> button shows the temporary XML code of the generated route. \\
+| {{:route:generate_via_route_xml_code.png?|}} | 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====
+| {{:route:generate_via_route_no_fitting_route-en.png?330|}} | If no fitting route can be calculated \\ the user will be informed by a dialog. |
+ \\
+====Overwrite existing route====
+| {{:route:generate_via_route_overwrite-en.png?359|}} | 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 --- \\