GTKWAVERC(5) GTKWave Configuration File GTKWAVERC(5)NAMEgtkwaverc - GTKWave Configuration File
SYNTAX
option <value>
The configuration file is a series of option and value pairs. Comment
lines marked with an initial '#' character are permissible. Blank
lines are ignored.
DESCRIPTION
Configuration file for gtkwave(1). The search path for the configura‐
tion file (if unspecified) is the current working directory followed by
the user's home directory.
OPTIONS
accel <"pathvalue" accelerator>
This allows replacement of menu accelerator keys. See the .gtk‐
waverc file in the source distribution for examples on pathvalue
and accelerator syntax. The special accelerator value of (null)
means that no accelerator is bound to the menu item.
alt_hier_delimeter <value>
This allows another character in addition to the hier_delimeter
to be used to delimit levels in the hierarchy for VCD. Only the
first character in the value is significant. Note that this is
normally off. The intended use is to resolve the hierarchies of
netlist based models that often contain slashes to delimit hier‐
archy inside of $var statements.
alt_wheel_mode <value>
Default is on. Scrollwheel alone pans along a quarter at a time
rather than a full page, so you don't get lost. Ctrl+wheel
zooms in/out around the mouse cursor position, not the marker
position. Alt+wheel edges left/right based on the currently
selected signal. This makes measuring deltas easier.
analog_redraw_skip_count <value>
Specifies how many overlapping analog segments can be drawn for
a given X position onscreen. (Default: 20) If there are gaps
in analog traces, this value is too low.
append_vcd_hier <value>
Allows the specification of a prefix hierarchy for VCD files.
This can be done in "pieces," so that multiple layers of hierar‐
chy are prepended to symbol names with the most significant
addition occurring first (see .gtkwaverc in the examples/vcd
directory). The intended use of this is to have the ability to
add "project" prefixes which allow easier selection of every‐
thing from the tree hierarchy.
atomic_vectors <value>
Speeds up vcd loading and takes up less memory. This option is
deprecated; it is currently the default.
autocoalesce <value>
A nonzero value enables autocoalescing of VCD vectors when
applicable. This may be toggled dynamically during wave viewer
usage.
autocoalesce_reversal <value>
causes split vectors to be reconstructed in reverse order (only
if autocoalesce is also active).
autoname_bundles <value>
A nonzero value indicates that GTKWave will create its own bun‐
dle names rather than prompting the user for them.
color_0 <value>
trace color when 0.
color_1 <value>
trace color when 1.
color_back <value>
background color.
color_baseline <value>
middle mouse button marker color.
color_black <value>
color value for "black" in signal window.
color_brkred <value>
brick red color for comments.
color_dash <value>
trace color when don't care ("-").
color_dashfill <value>
trace color (inside of box) when don't care ("-").
color_dkblue <value>
color value for "dark blue" in signal window.
color_dkgray <value>
color value for "dark gray" in signal window.
color_gmstrd <value>
color value for trace groupings.
color_grid <value>
grid color (use Alt-G/Shift-Alt-G to show/hide grid). This is
also the color used for highlight_wavewindow when enabled.
color_grid2 <value>
grid color for secondary pattern search.
color_high <value>
trace color when high ("H").
color_low <value>
trace color when low ("L").
color_ltblue <value>
color for shadowed traces.
color_ltgray <value>
color value for "light gray" in signal window.
color_mark <value>
color of the named markers.
color_mdgray <value>
color value for "medium gray" in signal window.
color_mid <value>
trace color when floating ("Z").
color_normal <value>
color value for "normal" GTK state in signal window.
color_time <value>
text color for timebar.
color_timeb <value>
text color for timebar's background.
color_trans <value>
trace color when transitioning.
color_u <value>
trace color when undefined ("U").
color_ufill <value>
trace color (inside of box) when undefined ("U").
color_umark <value>
color of the unnamed (primary) marker.
color_value <value>
text color for vector values.
color_vbox <value>
vector color (horizontal).
color_vtrans <value>
vector color (verticals/transitions).
color_w <value>
trace color when weak ("W").
color_wfill <value>
trace color (inside of box) when weak ("W").
color_white <value>
color value for "white" in signal window.
color_x <value>
trace color when undefined ("X") (collision for VHDL).
color_xfill <value>
trace color (inside of box) when undefined ("X") (collision for
VHDL).
constant_marker_update <value>
A nonzero value indicates that the values for traces listed in
the signal window are to be updated constantly when the left
mouse button is being held down rather than only when it is
first pressed then when released (which is the default).
context_tabposition <value>
Use zero for tabbed viewing with named tabs at the top. Nonzero
places numerically indexed tabs at the left.
convert_to_reals <value>
Converts all integer and parameter VCD declarations to real-val‐
ued ones when set to a nonzero/yes value. The positive aspect of
this is that integers and parameters will take up less space in
memory and will automatically display in decimal format. The
negative aspect of this is that integers and parameters will
only be displayable as decimals and can't be bit reversed,
inverted, etc.
cursor_snap <value>
A nonzero value indicates the number of pixels the marker should
snap to for the nearest signal transition.
disable_ae2_alias <value>
A nonzero value indicates that the AE2 loader is to ignore the
aliasdb keyword and is not to construct facility aliases.
disable_empty_gui <value>
A nonzero value indicates that if gtkwave is invoked without a
dumpfile name, then an empty gtkwave session is to be sup‐
pressed. Default is a zero value: to bring up an empty session
which needs a file loaded or dragged into it.
disable_mouseover <value>
A nonzero value indicates that signal/value tooltip pop up bub‐
bles on mouse button presses should be disabled in the value
window. A zero value indicates that value tooltips should be
active (default is disabled).
disable_tooltips <value>
A nonzero value indicates that tooltip pop up bubbles should be
disabled. A zero value indicates that tooltips should be active
(default).
do_initial_zoom_fit <value>
A nonzero value indicates that the trace should initially be
crunched to fit the screen. A zero value indicates that the ini‐
tial zoom should be zero (default).
dynamic_resizing <value>
A nonzero value indicates that dynamic resizing should be ini‐
tially enabled (default). A zero value indicates that dynamic
resizing should be initially disabled.
editor <"value">
This is used to specify a string (quotes mandatory) for when
gtkwave invokes a text editor (e.g., Open Source Definition).
Examples are: editor "vimx -g +%d %s", editor "gedit +%d %s",
editor "emacs +%d %s", and for OSX, editor "mate -l %d %s". The
%d may be combined with other characters in a string such as +,
etc. The %s argument must stand by itself. Note that if this
rc variable is not set, then the environment variable GTK‐
WAVE_EDITOR will be consulted next, then finally gedit will be
used (if found).
enable_fast_exit <value>
Allows exit without bringing up a confirmation requester. The
default is nonzero/yes.
enable_ghost_marker <value>
lets the user turn on/off the ghost marker during primary marker
dragging. Default is enabled.
enable_horiz_grid <value>
A nonzero value indicates that when grid drawing is enabled,
horizontal lines are to be drawn. This is the default.
enable_vcd_autosave <value>
causes the vcd loader to automatically generate a .sav file
(vcd_autosave.sav ) in the cwd if a save file is not specified
on the command line. Note that this mirrors the VCD $var defs
and no attempt is made to coalesce split bitvectors back
together.
enable_vert_grid <value>
A nonzero value indicates that when grid drawing is enabled,
vertical lines are to be drawn. This is the default. Note that
all possible combinations of enable_horiz_grid and
enable_vert_grid values are acceptable.
fontname_logfile <value>
When followed by an argument, this indicates the name of the X11
font that you wish to use for the logfile browser. You may gen‐
erate appropriate fontnames using the xfontsel program.
fontname_signals <value>
When followed by an argument, this indicates the name of the X11
font that you wish to use for signals. You may generate appro‐
priate fontnames using the xfontsel program.
fontname_waves <value>
When followed by an argument, this indicates the name of the X11
font that you wish to use for waves. You may generate appropri‐
ate fontnames using the xfontsel program. Note that the signal
font must be taller than the wave font or the viewer will com‐
plain then terminate.
force_toolbars <value>
When enabled, this forces everything above the signal and wave
windows to be rendered as toolbars. This allows for them to be
detached which allows for more usable wave viewer space. By
default this is off.
hide_sst <value>
Hides the Signal Search Tree widget for GTK2.4 and greater such
that it is not embedded into the main viewer window. It is
still reachable as an external widget through the menus.
hier_delimeter <value>
This allows characters other than '/' to be used to delimit lev‐
els in the hierarchy. Only the first character in the value is
significant.
hier_grouping <value>
For the tree widgets, this allows the hierarchies to be grouped
in a single place rather than spread among the netnames.
hier_max_level <value>
Sets the maximum hierarchy depth (from the right side) to dis‐
play for trace names. Note that a value of zero displays the
full hierarchy name.
highlight_wavewindow <value>
When enabled, this causes traces highlighted in the signal win‐
dow also to be highlighted in the wave window.
hpane_pack <value>
A nonzero value indicates that the horizontal pane should be
constructed using the gtk_paned_pack functions (default and rec‐
ommended). A zero value indicates that gtk_paned_add will be
used instead.
ignore_savefile_pane_pos <value>
If nonzero, specifies that the pane position attributes (i.e.,
signal window width size, SST is expanded, etc.) are to be
ignored during savefile loading and is to be skipped during sav‐
ing. Default is that the attribute is used.
ignore_savefile_pos <value>
If nonzero, specifies that the window position attribute is to
be ignored during savefile loading and is to be skipped during
saving. Default is that the position attribute is used.
ignore_savefile_size <value>
If nonzero, specifies that the window size attribute is to be
ignored during savefile loading and is to be skipped during sav‐
ing. Default is that the size attribute is used.
initial_signal_window_width <value>
Sets the creation width for the signal pane on GUI initializa‐
tion. Also sets another potential minimum value for dynamic
resizing.
initial_window_x <value>
Sets the size of the initial width of the wave viewer window.
Values less than or equal to zero will set the initial width
equal to -1 which will let GTK determine the minimum size.
initial_window_xpos <value>
Sets the size of the initial x coordinate of the wave viewer
window. -1 will let the window manager determine the position.
initial_window_y <value>
Sets the size of the initial height of the wave viewer window.
Values less than or equal to zero will set the initial width
equal to -1 which will let GTK determine the minimum size.
initial_window_ypos <value>
Sets the size of the initial y coordinate of the wave viewer
window. -1 will let the window manager determine the position.
keep_xz_colors <value>
When nonzero, indicates that the original color scheme for non
0/1 signal values is to be used when Color Format overrides are
in effect. Default is off.
left_justify_sigs <value>
When nonzero, indicates that the signal window signal name jus‐
tification should default to left, else the justification is to
the right (default).
lxt_clock_compress_to_z <value>
For LXT (not LXT2) allows clocks to compress to a 'z' value so
that regular/periodic value changes may be noted.
page_divisor <value>
Sets the scroll amount for page left and right operations. (The
buttons, not the hscrollbar.) Values over 1.0 are taken as 1/x
and values equal to and less than 1.0 are taken literally.
(i.e., 2 gives a half-page scroll and .67 gives 2/3). The
default is 1.0.
ps_maxveclen <value>
sets the maximum number of characters that can be printed for a
value in the signal window portion of a postscript file (not
including the net name itself). Legal values are 4 through 66
(default).
ruler_origin <value>
sets the zero origin for alternate time tick marks.
ruler_step <value>
sets the left/right step value for the alternate time tick marks
from the origin. When this value is zero, alternate time tick
marks are disabled.
scale_to_time_dimension <value>
The value can be any of the characters m, u, n, f, p, or s,
which indicates which time dimension to convert the time values
to. The default for this is * which means that time dimension
conversion is disabled.
show_base_symbols <value>
A nonzero value (default) indicates that the numeric base sym‐
bols for hexadecimal ('$'), binary ('%'), and octal ('#') should
be rendered. Otherwise they will be omitted.
show_grid <value>
A nonzero value (default) indicates that a grid should be drawn
behind the traces. A zero indicates that no grid should be
drawn.
splash_disable <value>
Turning this off enables the splash screen with the GTKWave mas‐
cot when loading a trace. Default is on.
sst_dynamic_filter <value>
When true (default) allows the SST dialog signal filter to fil‐
ter signals while keys are being pressed, otherwise enter must
be pressed to cause the filter to go active.
sst_expanded <value>
When true allows the SST dialog (when not hidden) to come up
already expanded.
strace_repeat_count <value>
Determines how many times that edge search and pattern search
will iterate on a search. This allows, for example, skipping
ahead 10 clock edges instead of 1.
use_big_fonts <value>
A nonzero value indicates that any text rendered into the wave
window will use fonts that are four points larger in size than
normal. This can enhance readability. A zero value indicates
that normal font sizes should be used.
use_frequency_delta <value>
allows you to switch between the delta time and frequency dis‐
play in the upper right corner of the main window when measuring
distances between markers. Default behavior is that the delta
time is displayed (off).
use_full_precision <value>
does not round time values when the number of ticks per pixel
onscreen is greater than 10 when active. The default is that
this feature is disabled.
use_maxtime_display <value>
A nonzero value indicates that the maximum time will be dis‐
played in the upper right corner of the screen. Otherwise, the
current primary (unnamed) marker time will be displayed. This
can be toggled at any time with the Toggle Max-Marker menu
option.
use_nonprop_fonts <value>
Allows accelerated redraws of the signalwindow that can be done
because the font width is constant. Default is off.
use_pango_fonts <value>
Uses anti-aliased pango fonts (GTK2) rather than bitmapped X11
ones. Default is on.
use_roundcaps <value>
A nonzero value indicates that vector traces should be drawn
with rounded caps rather than perpendicular ones. The default
for this is zero.
use_scrollbar_only <value>
A nonzero value indicates that the page, shift, fetch, and dis‐
card buttons should not be drawn (i.e., time manipulations
should be through the scrollbar only rather than front panel
buttons). The default for this is zero.
use_scrollwheel_as_y <value>
A nonzero value indicates that the scroll wheel on the mouse
should be used to scroll the signals up and down rather than
scrolling the time value from left to right.
use_standard_clicking <value>
This option no longer has any effect in gtkwave: normal GTK
click semantics are used in the signalwindow.
use_standard_trace_select <value>
A nonzero value keeps the currently selected traces from dese‐
lecting on mouse button press. This allows drag and drop to
function more smoothly. As this behavior is not how GTK nor‐
mally functions, it is by default disabled.
use_toolbutton_interface <value>
A nonzero value indicates that a toolbar with buttons should be
at the top of the screen instead of the traditional style gtk‐
wave button groups. Default is on.
vcd_explicit_zero_subscripts <value>
indicates that signal names should be stored internally as
name.bitnumber when enabled. When disabled, a more "normal"
ordering of name[bitnumber] is used. Note that when disabled,
the Bundle Up and Bundle Down options are disabled in the Signal
Search Regexp, Signal Search Hierarchy, and Signal Search Tree
options. This is necessary as the internal data structures for
signals are represented with one "less" level of hierarchy than
when enabled and those functions would not work properly. This
should not be an issue if atomic_vectors are enabled. Default
for vcd_explicit_zero_subscripts is disabled.
vcd_preserve_glitches <value>
indicates that any repeat equal values for a net spanning dif‐
ferent time values in the VCD/FST file are not to be compressed
into a single value change but should remain in order to allow
glitches to be present for this case. Default for vcd_pre‐
serve_glitches is disabled.
vcd_preserve_glitches_real <value>
indicates that any repeat equal values for a real net spanning
different time values in the VCD/FST file are not to be com‐
pressed into a single value change but should remain for this
case. Default for vcd_preserve_glitches is disabled. The
intended use is for when viewing analog interpolated data such
that removing duplicate values would incorrectly deform the
interpolation.
vcd_warning_filesize <value>
produces a warning message if the VCD filesize is greater than
the argument's size in MB. Set to zero to disable this.
vector_padding <value>
indicates the number of pixels of extra whitespace that should
be added to any strings for the purpose of calculating text in
vectors. Permissible values are 0 to 16 with the default being
4.
vlist_compression <value>
indicates the value to pass to zlib during vlist processing
(which is used in the VCD recoder). -1 disables compression,
0-9 correspond to the value zlib expects. 4 is default.
vlist_prepack <value>
indicates that the VCD recoder should pre-compress data going
into the value change vlists in order to reduce memory usage.
This is done before potential zlib packing. Default is off.
vlist_spill <value>
indicates that the VCD recoder should spill all generated vlists
to a tempfile on disk in order to reduce memory usage. Default
is off.
wave_scrolling <value>
a nonzero value enables scrolling by dragging the marker off the
left or right sides of the wave window. A zero value disables
it.
zoom_base <value>
allows setting of the zoom base with a value between 1.5 and
10.0. Default is 2.0.
zoom_center <value>
a nonzero value enables center zooming, a zero value disables
it.
zoom_dynamic <value>
a nonzero value enables dynamic full zooming when using the par‐
tial VCD (incremental) loader, a zero value disables it.
zoom_dynamic_end <value>
a nonzero value enables dynamic zoom to the end when using the
partial VCD (incremental) loader, a zero value disables it.
zoom_pow10_snap <value>
corresponds to the Zoom Pow10 Snap menu option. Default for this
is disabled (zero).
AUTHORS
Anthony Bybell <bybell@rocketmail.com>
SEE ALSOgtkwave(1)Anthony Bybell 3.3.51 GTKWAVERC(5)
