1GTKWAVERC(5) GTKWave Configuration File GTKWAVERC(5)
2
6 gtkwaverc - GTKWave Configuration File
7
9 option <value>
10 The configuration file is a series of option and value pairs. Comment
12 lines marked with an initial '#' character are permissible. Blank
13 lines are ignored.
14
16 Configuration file for gtkwave(1). The search path for the configura‐
17 tion file (if unspecified) is the current working directory followed by
18 the user's home directory.
19
21 accel <"pathvalue" accelerator>
22 This allows replacement of menu accelerator keys. See the .gtk‐
23 waverc file in the source distribution for examples on pathvalue
24 and accelerator syntax. The special accelerator value of (null)
25 means that no accelerator is bound to the menu item.
26 alt_hier_delimeter <value>
28 This allows another character in addition to the hier_delimeter
29 to be used to delimit levels in the hierarchy for VCD. Only the
30 first character in the value is significant. Note that this is
31 normally off. The intended use is to resolve the hierarchies of
32 netlist based models that often contain slashes to delimit hier‐
33 archy inside of $var statements.
34 analog_redraw_skip_count <value>
36 Specifies how many overlapping analog segments can be drawn for
37 a given X position onscreen. (Default: 20) If there are gaps
38 in analog traces, this value is too low.
39 append_vcd_hier <value>
41 Allows the specification of a prefix hierarchy for VCD files.
42 This can be done in "pieces," so that multiple layers of hierar‐
43 chy are prepended to symbol names with the most significant
44 addition occurring first (see .gtkwaverc in the examples/vcd
45 directory). The intended use of this is to have the ability to
46 add "project" prefixes which allow easier selection of every‐
47 thing from the tree hierarchy.
48 atomic_vectors <value>
50 Speeds up vcd loading and takes up less memory. This option is
51 deprecated; it is currently the default.
52 autocoalesce <value>
54 A nonzero value enables autocoalescing of VCD vectors when
55 applicable. This may be toggled dynamically during wave viewer
56 usage.
57 autocoalesce_reversal <value>
59 causes split vectors to be reconstructed in reverse order (only
60 if autocoalesce is also active).
61 autoname_bundles <value>
63 A nonzero value indicates that GTKWave will create its own bun‐
64 dle names rather than prompting the user for them.
65 color_0 <value>
67 trace color when 0.
68 color_1 <value>
70 trace color when 1.
71 color_back <value>
73 background color.
74 color_baseline <value>
76 middle mouse button marker color.
77 color_black <value>
79 color value for "black" in signal window.
80 color_brkred <value>
82 brick red color for comments.
83 color_dash <value>
85 trace color when don't care ("-").
86 color_dashfill <value>
88 trace color (inside of box) when don't care ("-").
89 color_dkblue <value>
91 color value for "dark blue" in signal window.
92 color_dkgray <value>
94 color value for "dark gray" in signal window.
95 color_gmstrd <value>
97 color value for trace groupings.
98 color_grid <value>
100 grid color (use Alt-G/Shift-Alt-G to show/hide grid).
101 color_grid2 <value>
103 grid color for secondary pattern search.
104 color_high <value>
106 trace color when high ("H").
107 color_low <value>
109 trace color when low ("L").
110 color_ltblue <value>
112 color for shadowed traces.
113 color_ltgray <value>
115 color value for "light gray" in signal window.
116 color_mark <value>
118 color of the named markers.
119 color_mdgray <value>
121 color value for "medium gray" in signal window.
122 color_mid <value>
124 trace color when floating ("Z").
125 color_normal <value>
127 color value for "normal" GTK state in signal window.
128 color_time <value>
130 text color for timebar.
131 color_timeb <value>
133 text color for timebar's background.
134 color_trans <value>
136 trace color when transitioning.
137 color_u <value>
139 trace color when undefined ("U").
140 color_ufill <value>
142 trace color (inside of box) when undefined ("U").
143 color_umark <value>
145 color of the unnamed (primary) marker.
146 color_value <value>
148 text color for vector values.
149 color_vbox <value>
151 vector color (horizontal).
152 color_vtrans <value>
154 vector color (verticals/transitions).
155 color_w <value>
157 trace color when weak ("W").
158 color_wfill <value>
160 trace color (inside of box) when weak ("W").
161 color_white <value>
163 color value for "white" in signal window.
164 color_x <value>
166 trace color when undefined ("X") (collision for VHDL).
167 color_xfill <value>
169 trace color (inside of box) when undefined ("X") (collision for
170 VHDL).
171 constant_marker_update <value>
173 A nonzero value indicates that the values for traces listed in
174 the signal window are to be updated constantly when the left
175 mouse button is being held down rather than only when it is
176 first pressed then when released (which is the default).
177 context_tabposition <value>
179 Use zero for tabbed viewing with named tabs at the top. Nonzero
180 places numerically indexed tabs at the left.
181 convert_to_reals <value>
183 Converts all integer and parameter VCD declarations to real-val‐
184 ued ones when set to a nonzero/yes value. The positive aspect of
185 this is that integers and parameters will take up less space in
186 memory and will automatically display in decimal format. The
187 negative aspect of this is that integers and parameters will
188 only be displayable as decimals and can't be bit reversed,
189 inverted, etc.
190 cursor_snap <value>
192 A nonzero value indicates the number of pixels the marker should
193 snap to for the nearest signal transition.
194 disable_empty_gui <value>
196 A nonzero value indicates that if gtkwave is invoked without a
197 dumpfile name, then an empty gtkwave session is to be sup‐
198 pressed. Default is a zero value: to bring up an empty session
199 which needs a file loaded or dragged into it.
200 disable_mouseover <value>
202 A nonzero value indicates that signal/value tooltip pop up bub‐
203 bles on mouse button presses should be disabled in the value
204 window. A zero value indicates that value tooltips should be
205 active (default is disabled).
206 disable_tooltips <value>
208 A nonzero value indicates that tooltip pop up bubbles should be
209 disabled. A zero value indicates that tooltips should be active
210 (default).
211 do_initial_zoom_fit <value>
213 A nonzero value indicates that the trace should initially be
214 crunched to fit the screen. A zero value indicates that the ini‐
215 tial zoom should be zero (default).
216 dynamic_resizing <value>
218 A nonzero value indicates that dynamic resizing should be ini‐
219 tially enabled (default). A zero value indicates that dynamic
220 resizing should be initially disabled.
221 enable_fast_exit <value>
223 Allows exit without bringing up a confirmation requester. The
224 default is nonzero/yes.
225 enable_ghost_marker <value>
227 lets the user turn on/off the ghost marker during primary marker
228 dragging. Default is enabled.
229 enable_horiz_grid <value>
231 A nonzero value indicates that when grid drawing is enabled,
232 horizontal lines are to be drawn. This is the default.
233 enable_vcd_autosave <value>
235 causes the vcd loader to automatically generate a .sav file
236 (vcd_autosave.sav ) in the cwd if a save file is not specified
237 on the command line. Note that this mirrors the VCD $var defs
238 and no attempt is made to coalesce split bitvectors back
239 together.
240 enable_vert_grid <value>
242 A nonzero value indicates that when grid drawing is enabled,
243 vertical lines are to be drawn. This is the default. Note that
244 all possible combinations of enable_horiz_grid and
245 enable_vert_grid values are acceptable.
246 fontname_logfile <value>
248 When followed by an argument, this indicates the name of the X11
249 font that you wish to use for the logfile browser. You may gen‐
250 erate appropriate fontnames using the xfontsel program.
251 fontname_signals <value>
253 When followed by an argument, this indicates the name of the X11
254 font that you wish to use for signals. You may generate appro‐
255 priate fontnames using the xfontsel program.
256 fontname_waves <value>
258 When followed by an argument, this indicates the name of the X11
259 font that you wish to use for waves. You may generate appropri‐
260 ate fontnames using the xfontsel program. Note that the signal
261 font must be taller than the wave font or the viewer will com‐
262 plain then terminate.
263 force_toolbars <value>
265 When enabled, this forces everything above the signal and wave
266 windows to be rendered as toolbars. This allows for them to be
267 detached which allows for more usable wave viewer space. By
268 default this is off.
269 hide_sst <value>
271 Hides the Signal Search Tree widget for GTK2.4 and greater such
272 that it is not embedded into the main viewer window. It is
273 still reachable as an external widget through the menus.
274 hier_delimeter <value>
276 This allows characters other than '/' to be used to delimit lev‐
277 els in the hierarchy. Only the first character in the value is
278 significant.
279 hier_grouping <value>
281 For the tree widgets, this allows the hierarchies to be grouped
282 in a single place rather than spread among the netnames.
283 hier_max_level <value>
285 Sets the maximum hierarchy depth (from the right side) to dis‐
286 play for trace names. Note that a value of zero displays the
287 full hierarchy name.
288 hpane_pack <value>
290 A nonzero value indicates that the horizontal pane should be
291 constructed using the gtk_paned_pack functions (default and rec‐
292 ommended). A zero value indicates that gtk_paned_add will be
293 used instead.
294 ignore_savefile_pos <value>
296 If nonzero, specifies that the window position attribute is to
297 be ignored during savefile loading and is to be skipped during
298 saving. Default is that the position attribute is used.
299 ignore_savefile_size <value>
301 If nonzero, specifies that the window size attribute is to be
302 ignored during savefile loading and is to be skipped during sav‐
303 ing. Default is that the size attribute is used.
304 initial_signal_window_width <value>
306 Sets the creation width for the signal pane on GUI initializa‐
307 tion. Also sets another potential minimum value for dynamic
308 resizing.
309 initial_window_x <value>
311 Sets the size of the initial width of the wave viewer window.
312 Values less than or equal to zero will set the initial width
313 equal to -1 which will let GTK determine the minimum size.
314 initial_window_xpos <value>
316 Sets the size of the initial x coordinate of the wave viewer
317 window. -1 will let the window manager determine the position.
318 initial_window_y <value>
320 Sets the size of the initial height of the wave viewer window.
321 Values less than or equal to zero will set the initial width
322 equal to -1 which will let GTK determine the minimum size.
323 initial_window_ypos <value>
325 Sets the size of the initial y coordinate of the wave viewer
326 window. -1 will let the window manager determine the position.
327 left_justify_sigs <value>
329 When nonzero, indicates that the signal window signal name jus‐
330 tification should default to left, else the justification is to
331 the right (default).
332 lxt_clock_compress_to_z <value>
334 For LXT (not LXT2) allows clocks to compress to a 'z' value so
335 that regular/periodic value changes may be noted.
336 page_divisor <value>
338 Sets the scroll amount for page left and right operations. (The
339 buttons, not the hscrollbar.) Values over 1.0 are taken as 1/x
340 and values equal to and less than 1.0 are taken literally.
341 (i.e., 2 gives a half-page scroll and .67 gives 2/3). The
342 default is 1.0.
343 ps_maxveclen <value>
345 sets the maximum number of characters that can be printed for a
346 value in the signal window portion of a postscript file (not
347 including the net name itself). Legal values are 4 through 66
348 (default).
349 scale_to_time_dimension <value>
351 The value can be any of the characters m, u, n, f, p, or s,
352 which indicates which time dimension to convert the time values
353 to. The default for this is * which means that time dimension
354 conversion is disabled.
355 show_base_symbols <value>
357 A nonzero value (default) indicates that the numeric base sym‐
358 bols for hexadecimal ('$'), binary ('%'), and octal ('#') should
359 be rendered. Otherwise they will be omitted.
360 show_grid <value>
362 A nonzero value (default) indicates that a grid should be drawn
363 behind the traces. A zero indicates that no grid should be
364 drawn.
365 splash_disable <value>
367 Turning this off enables the splash screen with the GTKWave mas‐
368 cot when loading a trace. Default is on.
369 sst_dynamic_filter <value>
371 When true (default) allows the SST dialog signal filter to fil‐
372 ter signals while keys are being pressed, otherwise enter must
373 be pressed to cause the filter to go active.
374 sst_expanded <value>
376 When true allows the SST dialog (when not hidden) to come up
377 already expanded.
378 strace_repeat_count <value>
380 Determines how many times that edge search and pattern search
381 will iterate on a search. This allows, for example, skipping
382 ahead 10 clock edges instead of 1.
383 use_big_fonts <value>
385 A nonzero value indicates that any text rendered into the wave
386 window will use fonts that are four points larger in size than
387 normal. This can enhance readability. A zero value indicates
388 that normal font sizes should be used.
389 use_frequency_delta <value>
391 allows you to switch between the delta time and frequency dis‐
392 play in the upper right corner of the main window when measuring
393 distances between markers. Default behavior is that the delta
394 time is displayed (off).
395 use_full_precision <value>
397 does not round time values when the number of ticks per pixel
398 onscreen is greater than 10 when active. The default is that
399 this feature is disabled.
400 use_maxtime_display <value>
402 A nonzero value indicates that the maximum time will be dis‐
403 played in the upper right corner of the screen. Otherwise, the
404 current primary (unnamed) marker time will be displayed. This
405 can be toggled at any time with the Toggle Max-Marker menu
406 option.
407 use_nonprop_fonts <value>
409 Allows accelerated redraws of the signalwindow that can be done
410 because the font width is constant. Default is off.
411 use_pango_fonts <value>
413 Uses anti-aliased pango fonts (GTK2) rather than bitmapped X11
414 ones. Default is on.
415 use_roundcaps <value>
417 A nonzero value indicates that vector traces should be drawn
418 with rounded caps rather than perpendicular ones. The default
419 for this is zero.
420 use_scrollbar_only <value>
422 A nonzero value indicates that the page, shift, fetch, and dis‐
423 card buttons should not be drawn (i.e., time manipulations
424 should be through the scrollbar only rather than front panel
425 buttons). The default for this is zero.
426 use_scrollwheel_as_y <value>
428 A nonzero value indicates that the scroll wheel on the mouse
429 should be used to scroll the signals up and down rather than
430 scrolling the time value from left to right.
431 use_standard_clicking <value>
433 This option no longer has any effect in gtkwave: normal GTK
434 click semantics are used in the signalwindow.
435 use_toolbutton_interface <value>
437 A nonzero value indicates that a toolbar with buttons should be
438 at the top of the screen instead of the traditional style gtk‐
439 wave button groups. Default is on.
440 vcd_explicit_zero_subscripts <value>
442 indicates that signal names should be stored internally as
443 name.bitnumber when enabled. When disabled, a more "normal"
444 ordering of name[bitnumber] is used. Note that when disabled,
445 the Bundle Up and Bundle Down options are disabled in the Signal
446 Search Regexp, Signal Search Hierarchy, and Signal Search Tree
447 options. This is necessary as the internal data structures for
448 signals are represented with one "less" level of hierarchy than
449 when enabled and those functions would not work properly. This
450 should not be an issue if atomic_vectors are enabled. Default
451 for vcd_explicit_zero_subscripts is disabled.
452 vcd_preserve_glitches <value>
454 indicates that any repeat equal values for a net spanning dif‐
455 ferent time values in the vcd file are not to be compressed into
456 a single value change but should remain in order to allow
457 glitches to be present for this case. Default for vcd_pre‐
458 serve_glitches is disabled.
459 vcd_warning_filesize <value>
461 produces a warning message if the VCD filesize is greater than
462 the argument's size in MB. Set to zero to disable this.
463 vector_padding <value>
465 indicates the number of pixels of extra whitespace that should
466 be added to any strings for the purpose of calculating text in
467 vectors. Permissible values are 0 to 16 with the default being
468 4.
469 vlist_compression <value>
472 indicates the value to pass to zlib during vlist processing
473 (which is used in the VCD recoder). -1 disables compression,
474 0-9 correspond to the value zlib expects. 4 is default.
475 vlist_prepack <value>
477 indicates that the VCD recoder should pre-compress data going
478 into the value change vlists in order to reduce memory usage.
479 This is done before potential zlib packing. Default is off.
480 vlist_spill <value>
482 indicates that the VCD recoder should spill all generated vlists
483 to a tempfile on disk in order to reduce memory usage. Default
484 is off.
485 wave_scrolling <value>
487 a nonzero value enables scrolling by dragging the marker off the
488 left or right sides of the wave window. A zero value disables
489 it.
490 zoom_base <value>
492 allows setting of the zoom base with a value between 1.5 and
493 10.0. Default is 2.0.
494 zoom_center <value>
496 a nonzero value enables center zooming, a zero value disables
497 it.
498 zoom_dynamic <value>
500 a nonzero value enables dynamic full zooming when using the par‐
501 tial VCD (incremental) loader, a zero value disables it.
502 zoom_dynamic_end <value>
504 a nonzero value enables dynamic zoom to the end when using the
505 partial VCD (incremental) loader, a zero value disables it.
506 zoom_pow10_snap <value>
508 corresponds to the Zoom Pow10 Snap menu option. Default for this
509 is disabled (zero).
510
512 Anthony Bybell <bybell@nc.rr.com>
513
515 gtkwave(1)
516Anthony Bybell 3.3.14 GTKWAVERC(5)