Contents
Previous
Next
IndexYou can change the initial default values of several Robochart parameters, and define custom capabilities, by creating a configuration file. If you place this file in your home directory with the name .rchart, Robochart will automatically load it when starting up. Or, you can give the full pathname of a specific configuration file on the command line with the "-c" option when starting Robochart, in which case ~/.rchart is ignored.
Robochart automatically saves your current configuration when you exit the program (unless it's been modified externally). You can also update it by choosing Save Config from the Options menu. Most settings are adjusted when you use the Options and Print windows. However, a few configuration commands can only be entered manually into your configuration file. If Robochart is running when you edit the configuration file, choose Reload Config from the Options menu for the changes to take effect. If you want to restore all configuration settings to built-in defaults, delete your ~/.rchart file before starting Robochart.
Configuration files are text files, and can be created or changed
with any text editor. Empty lines, and lines starting with a "#" (comments), are ignored. Commands appear one per line, and consist
of one or more keywords and parameters, separated by white
space (spaces and/or tabs). Keywords must appear exactly as
listed below. Commands can appear in any order; if a command is
duplicated, only the last one to appear will have an effect.
The following commands are recognized (and updated by the indicated window):
autolink {off | zoomin | on}
border line-type [line-type]
{off |
solid | dashed | thin | thick} (Selection Options).
color {text | line | fill} index value [plotter-pen]
0 through 7; value is a color
name or code (see Section 9),
and plotter-pen is the HPGL pen number to select for this color code.
command number scope: command line
1 through 9, and scope is
"c" (current), "s" (selected), "l" (level), or "p" (page) (Program Options).
date format-string
.DATE.. Refer to the system man page for
strftime() for format-string options.
defaults {off | pershape | global}
direction {landscape | portrait | auto}
flow source line-type [line-type] dest form
{solid |
dashed | thin | thick}, and form is {straight | curved}.
The last four flow type commands in your configuration file also define
(in reverse order) the quick flow button settings (Selection Options).
flow {center | ljust}
flow color line-color [text-color]
0-7) (Selection Options).
font family style size
grid {off | size}
loadlist {on | off}
margin top bottom left right
paper command; default is inches) (Print window).
numbering {off | specified | all}
numbering family style size
object {center | ljust}
object color border-color [text-color [fill-color]]
0-7, or N for no fill) (Selection Options).
object type width height
paper size
{A | B | C
| D | E | A0 | A1 | A2 | A3 | A4 | auto}, or is in the form
widthxheight {in | mm} (Print window).
print {postscript | epsf | hpgl | ascii | mif | image |
autohtml | html} [corner]
corner option
applies to HPGL outputs and sets the coordinate system origin at a corner of the page instead of the center, as needed by many small-format
HPGL plotters. Use this option if your HPGL diagrams are plotting
mostly off-page (Print window).
print color
printer name
printer | command line
scale {auto | percent}
shadows {none | opaque | objects | flows}
shape ID type atm [width height options]
lmap offset id [id ...]
pmap id [id ...]
link delimiters
undo limit
The file named in environment variable RCHT_FONTS (the
default name is rcfonts) defines the selection of fonts available to
Robochart. You can modify a copy of this file (and change
RCHT_FONTS to point to the copy) to make additional fonts on
your system available to Robochart, or to restrict or change the
font selections. The font file is a text file
that can be modified with any text editor; empty lines and comments (lines starting with a "#") are ignored. Each font entry consists of two consecutive lines in the following format:
family style size PSname
X name
where:
Times), used for the Font
Options window. It can be up to 15 characters, with no
embedded spaces.
P (plain), B (bold), I (italic), or BI (bold-italic).
Times-Bold).
Refer to your printer manual for the available font names.
The character "~" can be used to indicate no corresponding
PostScript font (if you try to print this font, Robochart will
use Courier).
PostScript printers typically list their available fonts on a test page
printed out at power-up. The basic PostScript fonts are listed in
Appendix A of the PostScript Language Reference Manual, a.k.a
the Red Book.
If * precedes a font entry's family name, that entry is used as the default label font. If + precedes the name, that entry is used as the default numbering font. These defaults can be overridden from the configuration file. Both * and + can precede the same entry.
The utility program rcfntck should be run after editing a font file to check its syntax before starting Robochart. Rcfntck does not check that the named fonts are actually available on your system.
The Robochart user interface can be customized using X resources. There are many ways to define resources, including adding them to ~/.Xdefaults, or putting them in a file Rchart in either /usr/lib/X11/app-defaults or the directory named in environment variable XAPPLRESDIR.
Rchart*fontList: variable
Rchart*XmForm*background: azure
Rchart*XmFileSelectionBox.pattern: *.cht
Refer to your X and Motif manuals for additional information on setting Motif widget resources.
The following application-specific resources, and default values, are provided:
! sound bell when popping up alert box? Rchart.alertBell: True ! number of edits between checkpoint saves (0=disable) Rchart.checkpoint: 0 ! min pixels pointer must move to start a drag Rchart.minDrag: 3 ! max pixels pointer can move for a double-click Rchart.multiclickSpace: 6 ! max time in milliseconds between clicks for a double-click Rchart.multiClickTime: 200 ! enable menu accelerator keys in main window menu bar? Rchart.menuAccel: False ! popup alert boxes at the pointer position? Rchart.popupAtPtr: True ! set width and height of drawing area in pixels Rchart.region: 4096 ! ascii code for prefix key used to enter special characters Rchart.specialKey: 11
In addition, editing keys can be defined or altered using the
mainTranslations resource.
The actions available for translation are defined in
action.txt.
! number of edits between checkpoint saves (0=disable) Rchart.CheckpointFrequency: 0 ! translation of Function keys F2-F10 into Meta keys Rchart.FKeys: sfliorjzd ! initial filename pattern for Open Diagram window Rchart.LoadPat: "" ! set width and height of drawing area in pixels Rchart.Region: 4096 ! ascii code for prefix key used to enter special characters Rchart.SpecialKey: 11 ! max pixels pointer can move for a double-click Mouse.Multiclick.Space: 6 ! max time in 1/10 secs between clicks for a double-click OpenWindows.MultiClickTimeout: 4 ! min pixels to activate a submenu OpenWindows.DragRightDistance: 100 ! min pixels pointer must move to start a drag OpenWindows.DragThreshold: 5 ! scrollbar position relative to window OpenWindows.ScrollbarPlacement: Right
Robochart uses several environment variables to customize
its operation. The scripts configured by the Install program
initialize these variables based on your responses to
installation prompts. Individual users can override these settings
by predefining appropriate variables (typically from their ~/.login
files) before starting Robochart.
To set a variable from the C-shell (or a csh script), use the setenv
command, e.g.:
setenv RCHT_SERVER jupiter.
The equivalent Bourne shell (or sh script) command is:
RCHT_SERVER=jupiter; export RCHT_SERVER.
Robochart programs use the following variables (default shown in brackets):
lpr -P" for SunOS 4.x, and "lp
-d " for SunOS 5.x].
-iflicense
-mono
-stcolor
-color
-c config_file
-tooltalk
-keepmask
-noredirect
Contents
Next
Index