Rocview Workspaces

ContentRocview

  • Workspaces





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

  1. Start Rocview.
  2. Select “File → Open Workspace…”.
  3. 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.
  4. 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.
  5. If everything worked out: Play and enjoy.


Open a Recent Workspace

  1. Start Rocview.
  2. Select “File → Recent Workspaces →”.
  3. Choose the wanted WorkSpace from the list.


Create a New Workspace

For testing downloaded plans:

  1. Select File → “Rocview Properties” and un-check “Use Workspace at startup” box and click OK.
  2. Close Rocview and Rocrail.
  3. Find the location where the Rocrail files are stored.
  4. Create a new sub-directory.
  5. 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.
  6. Start Rocview.
  7. Select File → “Rocview Properties” and change the “Default Workspace” (3 dots on the right hand side) to the new sub-directory.
  8. 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.
  9. Select File → “Open workspace …”.
  10. 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.


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.


DDX & Linux

As default the Rocview runs in user context and so starting the Rocrail server will be not with super user privileges.
Start Rocview with sudo to get the Rocrail server running with super user privileges.



Personal Tools