User Tools

Site Tools


rocgui-menu-en

This is an old revision of the document!


Menu

File


Connect to...

If the Rocview is not connected to a server or it should be connected to a different one it can be setup with this dialog.

Go offline

Disconnect from the Rocrail server to be able to edit locally offline.

Rocview properties...

Modify Rocview settings explained in chapter Configuration.
This menu item is in the Rocview menu under Mac OS X.

Rocrail properties...

Most settings are explained in chapter Rocrail configuration.

Note: This option is only available if Rocview is currently connected to a Rocrail server.

Rocrail Trace

Opens a Sub menu to chose the User Trace level of the Rocrail server.

Track plan title...

Changes the track plan title for the current layout.

Demo Workspace

Opens the Demo Workspace, saved with the installation.

Open Workspace

Opens a Rocrail Workspace

Recent Workspaces

The last 10 Workspaces are listed for activation.

Export/Import a Workspace

Exporting and importing Workspaces can be used as a copy for a new computer, or as backup.

Export...

Export the current active Workspace with all its sub-directories.
The backup directory is excluded.

Import...

Import a Workspace and open it.


New, Open...

To create or open a track plan, respectively.
See: Create / modify a Track plan

Note: These options are only available if Rocview runs offline, i.e. is not connected to a Rocrail server.

Save

Saves the current track plan.

Tip: The track plan is automatically saved if Rocview and Rocrail are quit.

Save as...

Saves the current track plan under a different name.

Note: If the plan is saved under name different from the current one the path to the file has to be adjusted manually in the rocrail.ini or from the Rocrail properties menu and the server has to be restarted.

Save level as...

The level active / visible in the track plan can be saved as an XML file (level name.xml). A file dialog opens in which the suggested name and the location can be changed.

Note: Level names should not contain characters that interfere with path names, like "/", ".", etc.

Import level...

A file dialog opens for selecting an XML Plan file to import a level.

Note: In order to prevent multiple layers from being mixed in the target plan, import files must not contain a complete track plan, but only one level.
For the import of multiple layers, they must be stored individually in separate files.
Steps:
1. Open the track plan containing the desired level(s) in Rocrail.
2. Select the required level by clicking the corresponding tab.
3. Save level as XML with save level as ... . (E.g., level name.xml)

Print...

Please consider the environment before printing.

Print the selected level or Modular Plan.

Analyse

Analyses the current track plan.

Upload...

:!: The current plan on the server will not be saved after an upload to make it possible to update it.

The Rocrail server saves the received file with the name specified in the plan file in its local work directory.
The new plan will be used after it is changed in the General Tab and the server is restarted.

This option should be used by advanced users only!
This option is only available if Rocview is currently connected to a Rocrail server.

Shutdown Rocrail and exit

Exits Rocview and subsequently the Rocrail server.

Note: This option is only available if Rocview is currently connected to a Rocrail server and the server does not run in Console Mode or runs in a previously opened Workspace.

Exit

Disconnect from server, if connected, and exit Rocview.


Edit


Undo...

The Undo Dialog is only available if there are deleted objects in edit mode.


Find and replace...

The Find and replace Dialog is available so common attributes, dialog fields, can be changed with one click.


Automatic


Auto mode

Flips Auto mode on/off.

Home Location

With the home action all locomotives with a Home location set, and which are not already at the home location, will get a command to run to the home location.
The Finder will be used to find a path to the Home location.

Start all locs

Start all locomotives available, or depending of the Start all filter, in the table.
In auto mode available.

Resume all locs

Start all locomotives stopped in a previous session.
In auto mode available.

Note: This option is only available if the locs are stopped with this function: Stop all locs

Simulate sensors

Allow with a mouse click to flip the sensor state.
This is default but can be disabled to avoid accidents by an unwanted click in automatic mode.

Activate actions

Enable or disable processing actions and XmlScript.

Stop all locs

Signal all running trains to stop in the current or next block. See also: Resume all locs (from previous session)
In auto mode available.
This has no effect on the staging automation.

Reset

Global Automatic Reset.

:!: Before using a reset command all locs should be stopped with Stop all locs command.

Soft reset

All active objects will get a (soft) reset signal, and current block reservations will be preserved.
In auto mode available.

Reset all

All active objects will get a (hard) reset signal; block reservations will be reset too!
In auto mode available.


Track Plan


Operate

This is the default mode enabling to operate objects of the plan like switches, signals and so on.
In this mode, the track plan cannot be modified.

Edit Panel

The edit mode enables editing the current track plan.
This will also activate the Add item dialog.

In this mode some mouse and keyboard actions are differently mapped as in Operate mode to be able to edit the plan.
Also some context menus are different in this mode.

Edit Module Plan

Mode for editing modular layouts.
Only available if the Plan Type is set to Module plan.

Add item

Opens the "Add item" dialog for adding new symbols to the track plan by Drag&Drop.

  • With the left column a category can be selected.
  • The symbols are scaled to the used plan panel scale.
  • The symbols look&feel are dependent of the selected Theme(s).
  • The Accessory category includes default only the symbols for output, text and railroad crossing.
    The Accessory Theme must be added on the Rocview SVG Tab to get also the Building symbols.
  • For the Road category the Roads Theme must be added on the Rocview SVG Tab.

Add track panel

Adds a new track panel with a title and the wanted level.

Delete track diagram

This function is only provided in the context menu of the track plan.
Only the current showed track plan level will removed after a validation.

Panel properties

Displays the properties (name and track plan level) of the current track plan.

Plan tree

Open the Plan tree dialog.

Tables

All object tables are listed and accessable in this sub menu.

Control


Enable communication

Enable/Disable controller communication. Supported libraries: (so far)

  • cbus
  • ecos
  • p50x (tamsmc, opendcc)
  • virtual (Info line only; No impact on functionality.)
  • xpressnet

Emergency break

This will issue an Emergency Break command and switch auto mode off.
If a Command Station does not support Emergency Break it will be translated into a Power Off command.
:!: In combination with server option Force unlock at Ebreak this could lead to chaos.

Start of Day (SoD)-> Init field

To make sure all switches and signals have the right position this command flips them all twice.
All defined signals will be sent a command with the last known state, or 'RED' If no state is available.
See also: Command Line Options and Console Mode

Sensor counters

At init field the following counters are reset:

  • wheel counter
  • sensor counter

Start of Day (SoD)-> Query Sensors

Request the status of all sensors.
Supported Command Stations:

  • CBUS
  • LocoNet
  • Xpressnet
  • BiDiB

End of Day (EoD)

For fully automatically shutdown and power off the complete system.
After selecting this menu item a password is asked for powering of the system which only sudoers and administrators are allowed to do.
If no password is provided the power off is skipped.
After the Rocrail server got this EoD command the following steps will be taken:

  1. Switch off the automatic mode.
  2. Wait until all locos are in idle state. The default EoD Timeout is 60 seconds.
  3. The clients will receive a shutdown event and will automatically close.
  4. All connected Command Stations become a halt command with optionally a shutdown request.
  5. If a password is provided a system power off will be initiated. If successful the PC will shutdown and power off.

Transmit short IDs

Some Command Stations accept Short IDs for use with throttles.

Fast Clock

Shows a resizable Fast Clock.

MIC (Mouse Control)

Throttle

Switch Control

Routes Control

Programming


Special stationary and mobile programming dialogs.


Bookmarks

The menu lists the last ten bookmarks as ID and tab name.

The first menu item opens the dialog edit bookmarks .

View



Clear messages

Deletes all messages displayed in the areas Server and Controller.

Language

To select the desired language of the user interface. After reselection, a dialog prompts to restart Rocview.

Zoom

Opens the Sub menu:

The displayed size of the track plan objects can be set.

Fit

The zoom value is set automatically for all objects of the choosen Track plan level.

Zoom...

Opens the Zoom dialog:

A slider movement or the buttons [50], [75], [100] act directly or after entry in the Combo box.
If the slider has the input focus, the mouse wheel or cursor keys can also be used. (Windows & Linux)

Loco panel

See Track plan below.

Loco widgets

Activates Loco Widgets.

Track plan

Either the Loco panel (see above) or the track plan can be set hidden for Multiple Rocview instances purpose.

Trace

Shows/hides the window areas with Server and Controller messages.
Disable this option to save resources.

Sort locos by address

When this option is set the sorting is based on the decoder address instead of the identifier "#__".

Loco view filter

Select the visible loco types.

Select Loco Columns

(wxWidgets 3.02 or higher.)
Select the columns to be visible in the Loco Tab.

Columns in the left list are disabled in the loco tab.

Block menu

Select the menu items in the block context menu.

Show IDs

Show the object IDs in the layout.

Show Counters

The sensor counters are shown formatted as: counter,carcount,wheelcount

ID Counters

Show locked switches

Set switch background to light red in case it is locked.
See Switch Wiring

Show pending switches

Set switch background to red in case it is pending.
See Switch Wiring

Show grid

Tooltip

Toolbar configuration...

Opens the dialog Toolbar configuration to choose the symbols in the toolbar.

Full screen

Activates full screen mode.

Note: On Mac OSX the menu is no longer reachable; Use CMD+U to switch back to normal screen mode.

Track plan color

To change the background color of the track plan temporarily. After a reboot, the original color is restored.

Tip: To permanently change the color of the track plan the context menu of the track plan panel can be used.

Cascade

Only available in case of Multi Window view and operating system Windows.


Help


Guide...

Launches the standard browser and opens Rocrail's online manual (this wiki). An active internet connection is required.

Forum...

Launches the standard browser and opens Rocrail's user forum. An active internet connection is required.

Translations...

Launches the standard browser and opens a website containing Rocrail's translations. Requires an active internet connection and a separate subscription.

Support...

Opens the Support dialog , which also shows the validity period of the support key.

Issue...

Create all needed documents for reporting a problem. See: Create an Issue.

Trace...

@Box...

See: @Box

Info...

The Info dialog with Revision information of Rocview and the connected server.


Ubuntu & Menu Icons

To enable menu icons install the "dconf-tools":

sudo apt-get install dconf-tools

Call dconf with the following parameters:

dconf write /org/gnome/desktop/interface/menus-have-icons true
Tested with Ubuntu 12.04 and 13.10.
1)
Click menu name to follow link
rocgui-menu-en.1542991720.txt.gz · Last modified: 2018/11/23 17:48 by rainerk