Innovative Model Railroad Control System

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======Rocview Workspaces======
[[:english#rocview|{{  :viewer.png}}]][[:english|{{  :rocrail-logo-35.png}}]]
[[:english|Content]] -> [[:english#rocview|Rocview ]]
  * **Workspaces**
 \\
 \\
{{:recent-ws.png}}\\
 \\
===== Preface =====
The idea behind Workspaces is to provide an easy way to start controlling a layout without bothering about the Rocrail server.\\
For many novice users the Client/Server concept of Rocrail is experienced as a barrier to even try the software. Workspaces could lower that barrier in a positive way.\\
:!: Workspaces can only be used if both Rocview and the Rocrail server will run on the same computer. Rocview will try to start the server and this is only possible on the same computer.\\

 \\

===== Workspace definition =====
A Workspace is a directory containing all files needed by the Rocrail server to control a layout:
  * rocrail.ini
  * Layout XML's
  * Locos XML 
  * OCC XML  (memory dump of occupancy and placing)
  * Images
 
\\

===== Open a Workspace =====
  - Start Rocview.
  - Select "**File -> Open Workspace...**".
  - Rocview will start the Rocrail server as asynchronous background process with the selected "Workspace" as parameter. \\ //A warning message will be shown if the Rocrail server is not found, and opening of the Workspace is canceled.//
  - Rocview waits until the Rocrail server is ready to accept connections from Rocview's. \\ //On some operating systems (Linux, OSX, ...) the Rocrail server will not be visible in a terminal window, on other operating systems (Windows, ...) the familiar terminal window opens.//
  - If everything worked out: Play and enjoy.

 \\

===== Open a Recent Workspace =====
  - Start Rocview.
  - Select "**File -> Recent Workspaces ->**".
  - Choose the wanted WorkSpace from the list.

 \\

===== Create a New Workspace =====
====From scratch==== 
:!: A new Workspace should not be created in the Rocrail installation directory tree.
  - Rocview -> File -> Open Workspace...
  - Create a new folder with this dialog.
  - Select the created folder and open it.
The Rocrail Server will be started in the new created folder and Rocview will connect to the server.\\
Rocview will show an empty plan and is ready to edit it.\\

====For testing downloaded plans====
  - Select File -> "Rocview Properties" and un-check "Use Workspace at startup" box and click OK.
  - Close Rocview and Rocrail.
  - Find the location where the Rocrail files are stored.
  - Create a new sub-directory.
  - Copy the "new layout plan.xml" and *.ini file into this folder. If no *.ini file exist, rename the layout plan to "plan.xml", then an *.ini file will be created that links the 2 files together in Rocrail.
  - Start Rocview.
  - Select File -> "Rocview Properties" and change the "Default Workspace" (3 dots on the right hand side) to the new sub-directory.
  - Select File -> "Rocrail Properties" and change the "Track plan file" (3 dots on the right hand side) to the new plan name in the new sub-directory.
  - Select File -> "Open workspace ...".
  - Select the newly created workspace folder (sub-directory from step 4) and open it.





\\

===== Features =====
  * Auto detect modular layout in Rocview to switch to ModView mode.
  * [[:rocgui-gen-en#default_workspace|Default Workspace]].
 \\



===== Other scenarios =====
It is also possible to share files among workspaces:
  * Share the layout and use different loco tables.
  * Share a loco table to use with different layouts.

 \\

===== Command line options =====
Command line options for Rocview:
^ Option ^ Parameter ^ Description ^
| ''-sp'' | ''[serverpath]'' | Use this if the server is not found in the Rocview's working directory. | \\

 \\
=====Workspace on a NAS=====
A Workspace on a NAS makes it comfortable to use concurrently different PCs on the same data set.\\
Tips to avoid slowing down the Server caused by file I/O:
  - Disable trace writing: __**[[:rocrailini-trace-en#trace_file|Remove trace filename]]**__, or set the __**[[:rocrailini-trace-en#path|Trace Path]]**__ to a local directory. (Must be set full qualified.)
  - Disable runtime occupancy recording: __**[[:rocrailini-gen-en#block_occupancy|Remove occupancy filename]]**__.

====macOS Auto Mount====
To auto mount a NAS directory, just add this directory to the user login items.\\
{{:rocview:macos-loginitems.jpg?400}}\\
 \\