Installing  and Running TChart


Running TChart
Immediate Mode
Environment Variables
Visibility of Display Objects and Short-cut Keys


For deployment:
  1. copy the application executable to the <production host><App> directory.
  2. create a sub-directory <App>/platforms.
  3. copy the Qt library from the Qt  plugins/platforms directory to <App>/platforms.
  4. create a sub-directory <App>/plugins
  5. copy TChart plugins to <App>/plugins, e.g.,
  6. copy all "required" Qt libraries to a a suitable library directory.
  7. in the library directory create generic soft links to the sub-release specific Qt libraries.
  8. if an archive retrieval plugin is installed:
    1. create a sub-directory <App>/plugins
    2. copy the shared plugin-libraires to <App>/plugins


Running TChart

If you are looking at this from the TChart on-line help, you are already beyond this point.
If you peeked at the HTML files in the distribution, however, this section may be of interest to you.

The most up-to-data list of command line switches can be obtained by running TChart with switch   -h.

Command Line Switches


Running   TChart -h shows the Usage message:

TChart usage message

-a <archiver> archiver name.
If this switch is missing archive retrieveal is disabled.
If this switch is present, TChart will attempt to load the plugin <archiver>ArchiveRetriever
-c <directory> configuration directory. If this switch is missing  the user's home directory is used.
-d <integer> debug/log level - only interesting to developers.
-f <file> <file> is a PV list file in either TChart (.tcp) or StripTool (.stp) format.
-g <directory> global configuration directory (which contains global configuration file dir.cfg)
-h show the usage message.
-p <PVs> sets immediate mode with comma-separated PV list
-s <suffix> configuration file suffix  (use configuration file tchart_<suffix>.cfg)
-v show TChart version information
-x start up in execute mode. If not present, start up in demo mode (can be changed with File >> Preferences).
-w write data to disk in immediate mode

Immediate Mode

TChart can be started in "immediate mode" either with a PV list or with a PV list file.

TChart -p <comma-separated PV names> [-w]
TChart -f <PV file name> [-w]

This immediately starts a strip chart for the given PV names. If the -w switch is omitted, no data are written to disk.
TChart reads PV list files in both StripTool (.stp) or TChart format (.tcp).
The current PV list and X-axis range can be saved to a .tcp file from the Traces >> Save traces to file  menu.

Environment Variables

TChart recognizes the following environment variables:

TCHARTSETS the directory where saved PV files are stored (default:   <user home>/.tchart
TCHART_BROWSER the startup command for spawning a local web-browser

Short-cut Keys

The 'Preferences' dialog can be called up at any time using the short-cut key  P.

Short-cut keys are supplied for the following menu functions:

Function Short-cut  key Menu
Toggle visibility of data labels D View
Toggle visibility of  legend L View
Toggle visibility of  main menu mar M View
Recall (restore saved Y-axis ranges) R Zoom
Reset  (restore original Y-axis ranges) CTRL-R Zoom
Save current Y-axis ranges S Zoom
Show X-axis range dialog X Traces
Show Y-axis ranges dialog Y Traces

Short-cut keys are case-insensitive.