You can control many aspects of WAVE 's appearance and behavior by
setting its resources. If you are not familiar with this concept, refer to an
introductory book on using the X Window System, such as Quercia and O'Reilly's
X Window System User's Guide. Since WAVE is built using the XView
all of the resources listed in the man page for xview
can be used with WAVE (type `man xview' for details).
If your system doesn't have an XView man page, refer to the copy provided
with the WAVE distribution
In addition, the WAVE -specific resources listed below may also be set.
The standard way to change default values of X11 resources is to
define them in a file named .Xdefaults (note the initial `.') in your home directory. WAVE does this when you use
in the View panel.
If you use WAVE on workstations with different display capabilities, you can
create custom resource settings for each one by moving these resource
definitions from .Xdefaults to .Xdefaults-hostname (where
hostname specifies the system to which the display is attached).
- This resource specifies if WAVE is allowed to render dotted lines. WAVE
normally draws annotation marker bars as dotted lines, and may use dotted
lines for other display elements on black-and-white displays for clarity.
Some X servers do not properly render dotted lines, however; if you
observe irregular or missing annotation marker bars, change the value of
this resource from `True' to `False' (by editing .Xdefaults).
- This resource specifies the name of a file that contains a table of
annotation definitions. The environment variable ANNTAB can also be used
to specify this filename; the resource overrides the environment variable
if both are set. The file contains one-line entries of the form
15 % Funny looking beat
in which the first field specifies the (numeric) annotation code in
the range between 1 and ACMAX inclusive (see /usr/include/wfdb/ecgcodes.h for a list of predefined codes and for
the definition of ACMAX); the second field (`%' in the
example) is a mnemonic (used in annotation display and entry), and the
remainder of the entry is a description of the intended use of the
annotation code (which appears next to the mnemonic in the Type
field and menu of the Annotation Template window). Lines in the
annotation table that begin with `#' are treated as comments
and ignored. It is not necessary to specify an annotation table when
editing an existing annotation file unless previously undefined
annotation types are to be added to it during the editing process,
although it is generally harmless to do so.
- This resource specifies the display resolution in dots per inch in the form
mmxnn, where mm is the horizontal resolution and nn is the vertical resolution. Normally, the resolution is known to the X
server, and it is unnecessary to specify this resource. If your X server is
misinformed, WAVE 's calibrated display scales will be incorrect; the best
solution is to specify the resolution using a server option such as the -dpi option supported by MIT's X11 servers, since this will solve problems
common to any other applications that require calibrated scales as well. Not
all X11 servers support such an option, however, so this option is available
as a work-around. The command-line option -dpi overrides the resource
if both are specified.
- This resource specifies the graphics mode used by WAVE ; it can be
overridden using the -g, -m, -O, or -S options. The
legal values are 1 (monochrome mode), 2 (overlay greyscale mode), 4
(shared color mode), 6 (shared grey mode), and 8 (overlay color mode).
- These resources specify the colors to be used on greyscale or color
displays. The Color.* resources are used only if the display is
color-capable and neither greyscale nor monochrome mode has been
specified. element is one of Background, Grid, Cursor, Annotation, or Signal. The defaults are:
- In monochrome mode, the background is normally white, and all other
elements are normally black. The reverse can be obtained by setting this
resource to `black'. (There is at least one X server for which this
These resources specify the colors to be used in the Scope
window on greyscale or color displays. The Foreground color is
used for the waveform and the time display; by default, it matches the
color used for signals in the signal window (see the previous item).
Some X servers do not allow the background color of the Scope
window to be set, because of the color map animation and stippled
erasing techniques used.
- This resource can be used to invert the foreground and background of
the Scope window when WAVE is running in monochrome mode.
This does not work for all X servers.
- These resources specify the preferred dimensions (in millimeters) for the
signal window. The defaults are 120 and 250 respectively.
- This resource specifies the font used to display annotations and time marks in
the signal window. The default is `fixed'.
- This resource specifies the name of the text editor invoked by WAVE to
permit you to edit WAVE 's log and analysis menu files. The default is
textedit (the OpenLook visual editor). You may override this resource
by using the environment variable EDITOR, which is also used by many
other UNIX applications that invoke editors.
- These resources specify which of the Show: options at the top of the
View window are enabled by default. showoption is one of Subtype, Chan, Num, Aux, Markers, SignalNames,
Baselines, or Level. The values of these
resources are `True' or `False'.
- These resources specify the positions of the initial choices in the
corresponding View menus, where the top item on each menu is in
position 0, the one below it is in position 1, etc. menuname is
one of TimeScale, AmplitudeScale, SignalMode, AnnotationMode, AnnotationOverlap, TimeMode, or GridMode.
For example, to set the initial time scale to 50 mm/sec (the item at position
13 in the Time Scale:
menu), set Wave.View.TimeScale to 13.
- This resource specifies the initial grid display mode to be used at highly
compressed time scales (125 mm/minute or less). The possible values are the
same as those for Wave.View.GridMode. The default is 0 (no grid);
recommended alternatives are 5 (1 m x 0.5 mV) or 6 (1 m x 0.1 mV).
- This resource specifies the initial time scale to be used for low-rate
records (those sampled at 10 Hz per signal or less). The possible values are
the same as those for Wave.View.TimeScale. The default is 5
(corresponding to 5 mm per minute).
In addition to the usual ways of setting X resources, it is possible
to set any of those listed above, as well as any of the generic XView
resources, by using the -xrm or -default options on the
command line when starting WAVE . For example, you can set the background
color of the signal window using a command such as
wave -r 100s -xrm Wave.SignalWindow.Color.Background:lightblue
George B. Moody (firstname.lastname@example.org)