1GTKWAVERC(5)              GTKWave Configuration File              GTKWAVERC(5)
2
3
4

NAME

6       gtkwaverc - GTKWave Configuration File
7

SYNTAX

9       option <value>
10
11       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

DESCRIPTION

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

OPTIONS

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
27       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
35       alt_wheel_mode <value>
36              Default is on.  Scrollwheel alone pans along a quarter at a time
37              rather than a full page, so  you  don't  get  lost.   Ctrl+wheel
38              zooms  in/out  around  the mouse cursor position, not the marker
39              position.  Alt+wheel edges left/right based on the currently se‐
40              lected signal.  This makes measuring deltas easier.
41
42       analog_redraw_skip_count <value>
43              Specifies  how many overlapping analog segments can be drawn for
44              a given X position onscreen.  (Default: 20)  If there  are  gaps
45              in analog traces, this value is too low.
46
47       append_vcd_hier <value>
48              Allows  the  specification  of a prefix hierarchy for VCD files.
49              This can be done in "pieces," so that multiple layers of hierar‐
50              chy  are prepended to symbol names with the most significant ad‐
51              dition occurring first (see .gtkwaverc in the  examples/vcd  di‐
52              rectory). The intended use of this is to have the ability to add
53              "project" prefixes which allow easier  selection  of  everything
54              from the tree hierarchy.
55
56       atomic_vectors <value>
57              Speeds  up  vcd loading and takes up less memory. This option is
58              deprecated; it is currently the default.
59
60       autocoalesce <value>
61              A nonzero value enables autocoalescing of VCD vectors  when  ap‐
62              plicable. This may be toggled dynamically during wave viewer us‐
63              age.
64
65       autocoalesce_reversal <value>
66              causes split vectors to be reconstructed in reverse order  (only
67              if autocoalesce is also active).
68
69       autoname_bundles <value>
70              A  nonzero value indicates that GTKWave will create its own bun‐
71              dle names rather than prompting the user for them.
72
73       clipboard_mouseover <value>
74              A nonzero value indicates that when mouseover  is  enabled,  all
75              values  generated  for the tooltips will be automatically copied
76              into the clipboard so they may be  pasted  into  other  programs
77              such as text editors, etc.
78
79       color_0 <value>
80              trace color when 0.
81
82       color_1 <value>
83              trace color when 1.
84
85       color_1fill <value>
86              trace color (inside of box) when 1.
87
88       color_back <value>
89              background color.
90
91       color_baseline <value>
92              middle mouse button marker color.
93
94       color_black <value>
95              color value for "black" in signal window.
96
97       color_brkred <value>
98              brick red color for comments.
99
100       color_dash <value>
101              trace color when don't care ("-").
102
103       color_dashfill <value>
104              trace color (inside of box) when don't care ("-").
105
106       color_dkblue <value>
107              color value for "dark blue" in signal window.
108
109       color_dkgray <value>
110              color value for "dark gray" in signal window.
111
112       color_gmstrd <value>
113              color value for trace groupings.
114
115       color_grid <value>
116              grid  color  (use Alt-G/Shift-Alt-G to show/hide grid).  This is
117              also the color used for highlight_wavewindow when enabled.
118
119       color_grid2 <value>
120              grid color for secondary pattern search.
121
122       color_high <value>
123              trace color when high ("H").
124
125       color_highfill <value>
126              trace color (inside of box) when high ("H").
127
128       color_low <value>
129              trace color when low ("L").
130
131       color_ltblue <value>
132              color for shadowed traces.
133
134       color_ltgray <value>
135              color value for "light gray" in signal window.
136
137       color_mark <value>
138              color of the named markers.
139
140       color_mdgray <value>
141              color value for "medium gray" in signal window.
142
143       color_mid <value>
144              trace color when floating ("Z").
145
146       color_normal <value>
147              color value for "normal" GTK state in signal window.
148
149       color_time <value>
150              text color for timebar.
151
152       color_timeb <value>
153              text color for timebar's background.
154
155       color_trans <value>
156              trace color when transitioning.
157
158       color_u <value>
159              trace color when undefined ("U").
160
161       color_ufill <value>
162              trace color (inside of box) when undefined ("U").
163
164       color_umark <value>
165              color of the unnamed (primary) marker.
166
167       color_value <value>
168              text color for vector values.
169
170       color_vbox <value>
171              vector color (horizontal).
172
173       color_vtrans <value>
174              vector color (verticals/transitions).
175
176       color_w <value>
177              trace color when weak ("W").
178
179       color_wfill <value>
180              trace color (inside of box) when weak ("W").
181
182       color_white <value>
183              color value for "white" in signal window.
184
185       color_x <value>
186              trace color when undefined ("X") (collision for VHDL).
187
188       color_xfill <value>
189              trace color (inside of box) when undefined ("X") (collision  for
190              VHDL).
191
192       constant_marker_update <value>
193              A  nonzero  value indicates that the values for traces listed in
194              the signal window are to be updated  constantly  when  the  left
195              mouse  button  is  being  held  down rather than only when it is
196              first pressed then when released (which is the default).
197
198       context_tabposition <value>
199              Use zero for tabbed viewing with named tabs at the top.  Nonzero
200              places numerically indexed tabs at the left.
201
202       convert_to_reals <value>
203              Converts all integer and parameter VCD declarations to real-val‐
204              ued ones when set to a nonzero/yes value. The positive aspect of
205              this  is that integers and parameters will take up less space in
206              memory and will automatically display  in  decimal  format.  The
207              negative  aspect  of  this  is that integers and parameters will
208              only be displayable as decimals and can't be bit  reversed,  in‐
209              verted, etc.
210
211       cursor_snap <value>
212              A nonzero value indicates the number of pixels the marker should
213              snap to for the nearest signal transition.
214
215       disable_ae2_alias <value>
216              A nonzero value indicates that the AE2 loader is to  ignore  the
217              aliasdb keyword and is not to construct facility aliases.
218
219       disable_auto_comphier <value>
220              A  nonzero  value  indicates  that the loaders that support com‐
221              pressed hierarchies should not automatically turn on compression
222              if the threshold count of signals (500000) has been reached.
223
224       disable_empty_gui <value>
225              A  nonzero  value indicates that if gtkwave is invoked without a
226              dumpfile name, then an empty  gtkwave  session  is  to  be  sup‐
227              pressed.   Default is a zero value: to bring up an empty session
228              which needs a file loaded or dragged into it.
229
230       disable_mouseover <value>
231              A nonzero value indicates that signal/value tooltip pop up  bub‐
232              bles  on  mouse  button  presses should be disabled in the value
233              window. A zero value indicates that value tooltips should be ac‐
234              tive (default is disabled).
235
236       disable_tooltips <value>
237              A  nonzero value indicates that tooltip pop up bubbles should be
238              disabled. A zero value indicates that tooltips should be  active
239              (default).
240
241       do_initial_zoom_fit <value>
242              A  nonzero  value  indicates  that the trace should initially be
243              crunched to fit the screen. A zero value indicates that the ini‐
244              tial zoom should be zero (default).
245
246       dragzoom_threshold <value>
247              A  nonzero  value indicates the number of pixels in the x direc‐
248              tion the marker must move in order for a dragzoom  to  be  trig‐
249              gered.  This is largely to handle noisy input devices.
250
251       dynamic_resizing <value>
252              A  nonzero  value indicates that dynamic resizing should be ini‐
253              tially enabled (default). A zero value  indicates  that  dynamic
254              resizing should be initially disabled.
255
256       editor <"value">
257              This  is  used  to  specify a string (quotes mandatory) for when
258              gtkwave invokes a text editor (e.g.,  Open  Source  Definition).
259              Examples  are:  editor  "vimx -g +%d %s", editor "gedit +%d %s",
260              editor "emacs +%d %s", and for OSX, editor "mate -l %d %s".  The
261              %d  may be combined with other characters in a string such as +,
262              etc.  The %s argument must stand by itself.  Note that  if  this
263              rc  variable  is  not  set,  then  the environment variable GTK‐
264              WAVE_EDITOR will be consulted next, then finally gedit  will  be
265              used (if found).
266
267       enable_fast_exit <value>
268              Allows  exit  without  bringing up a confirmation requester. The
269              default is nonzero/yes.
270
271       enable_ghost_marker <value>
272              lets the user turn on/off the ghost marker during primary marker
273              dragging. Default is enabled.
274
275       enable_horiz_grid <value>
276              A  nonzero  value  indicates  that when grid drawing is enabled,
277              horizontal lines are to be drawn. This is the default.
278
279       enable_vcd_autosave <value>
280              causes the vcd loader to  automatically  generate  a  .sav  file
281              (vcd_autosave.sav  )  in the cwd if a save file is not specified
282              on the command line. Note that this mirrors the  VCD  $var  defs
283              and  no  attempt  is  made to coalesce split bitvectors back to‐
284              gether.
285
286       enable_vert_grid <value>
287              A nonzero value indicates that when  grid  drawing  is  enabled,
288              vertical  lines  are to be drawn. This is the default. Note that
289              all  possible  combinations   of   enable_horiz_grid   and   en‐
290              able_vert_grid values are acceptable.
291
292       fill_waveform <value>
293              A  zero  value  indicates that the waveform should not be filled
294              for 1/H values. This is the default.
295
296       fontname_logfile <value>
297              When followed by an argument, this indicates the name of the X11
298              font  that you wish to use for the logfile browser. You may gen‐
299              erate appropriate fontnames using the xfontsel program.
300
301       fontname_signals <value>
302              When followed by an argument, this indicates the name of the X11
303              font  that  you wish to use for signals. You may generate appro‐
304              priate fontnames using the xfontsel program.
305
306       fontname_waves <value>
307              When followed by an argument, this indicates the name of the X11
308              font  that you wish to use for waves. You may generate appropri‐
309              ate fontnames using the xfontsel program. Note that  the  signal
310              font  must  be taller than the wave font or the viewer will com‐
311              plain then terminate.
312
313       force_toolbars <value>
314              When enabled, this forces everything above the signal  and  wave
315              windows  to  be rendered as toolbars. This allows for them to be
316              detached which allows for more usable wave viewer space. By  de‐
317              fault this is off.
318
319       hide_sst <value>
320              Hides  the Signal Search Tree widget for GTK2.4 and greater such
321              that it is not embedded into the  main  viewer  window.   It  is
322              still reachable as an external widget through the menus.
323
324       hier_delimeter <value>
325              This allows characters other than '/' to be used to delimit lev‐
326              els in the hierarchy. Only the first character in the  value  is
327              significant.
328
329       hier_grouping <value>
330              For  the tree widgets, this allows the hierarchies to be grouped
331              in a single place rather than spread among the netnames.
332
333       hier_ignore_escapes <value>
334              A nonzero value indicates that the signal pane  ignores  escapes
335              in  identifiers  when  determining  the hierarchy maximum depth.
336              Default is disabled so that escapes are examined.
337
338       hier_max_level <value>
339              Sets the maximum hierarchy depth (from the right side)  to  dis‐
340              play  for  trace  names.  Note that a value of zero displays the
341              full hierarchy name.
342
343       highlight_wavewindow <value>
344              When enabled, this causes traces highlighted in the signal  win‐
345              dow also to be highlighted in the wave window.
346
347       hpane_pack <value>
348              A  nonzero  value  indicates  that the horizontal pane should be
349              constructed using the gtk_paned_pack functions (default and rec‐
350              ommended).  A  zero  value  indicates that gtk_paned_add will be
351              used instead.
352
353       ignore_savefile_pane_pos <value>
354              If nonzero, specifies that the pane position  attributes  (i.e.,
355              signal  window  width size, SST is expanded, etc.) are to be ig‐
356              nored during savefile loading and is to be skipped  during  sav‐
357              ing.  Default is that the attribute is used.
358
359       ignore_savefile_pos <value>
360              If  nonzero,  specifies that the window position attribute is to
361              be ignored during savefile loading and is to be  skipped  during
362              saving.  Default is that the position attribute is used.
363
364
365       ignore_savefile_size <value>
366              If  nonzero,  specifies  that the window size attribute is to be
367              ignored during savefile loading and is to be skipped during sav‐
368              ing.  Default is that the size attribute is used.
369
370       initial_signal_window_width <value>
371              Sets  the  creation width for the signal pane on GUI initializa‐
372              tion.  Also sets another potential minimum value for dynamic re‐
373              sizing.
374
375       initial_window_x <value>
376              Sets  the  size  of the initial width of the wave viewer window.
377              Values less than or equal to zero will  set  the  initial  width
378              equal to -1 which will let GTK determine the minimum size.
379
380       initial_window_xpos <value>
381              Sets  the  size  of  the initial x coordinate of the wave viewer
382              window. -1 will let the window manager determine the position.
383
384       initial_window_y <value>
385              Sets the size of the initial height of the wave  viewer  window.
386              Values  less  than  or  equal to zero will set the initial width
387              equal to -1 which will let GTK determine the minimum size.
388
389       initial_window_ypos <value>
390              Sets the size of the initial y coordinate  of  the  wave  viewer
391              window. -1 will let the window manager determine the position.
392
393       keep_xz_colors <value>
394              When  nonzero,  indicates that the original color scheme for non
395              0/1 signal values is to be used when Color Format overrides  are
396              in effect.  Default is off.
397
398       left_justify_sigs <value>
399              When  nonzero, indicates that the signal window signal name jus‐
400              tification should default to left, else the justification is  to
401              the right (default).
402
403       lxt_clock_compress_to_z <value>
404              For  LXT  (not LXT2) allows clocks to compress to a 'z' value so
405              that regular/periodic value changes may be noted.
406
407       lz_removal <value>
408              When nonzero, suppresses the display of leading  zeros  on  non-
409              filtered traces.  This has no effect on filtered traces.
410
411       max_fsdb_trees <value>
412              sets the maximum number of hierarchy and signal trees to process
413              for an FSDB file.  Default = 0 = unlimited.  The intent of  this
414              is  to work around sim environments that accidentally call fsdb‐
415              DumpVars multiple times.
416
417       page_divisor <value>
418              Sets the scroll amount for page left and right operations.  (The
419              buttons,  not  the hscrollbar.) Values over 1.0 are taken as 1/x
420              and values equal to and  less  than  1.0  are  taken  literally.
421              (i.e.,  2  gives  a half-page scroll and .67 gives 2/3). The de‐
422              fault is 1.0.
423
424       ps_maxveclen <value>
425              sets the maximum number of characters that can be printed for  a
426              value in the signal window portion of a postscript file (not in‐
427              cluding the net name itself). Legal values are 4 through 66 (de‐
428              fault).
429
430       ruler_origin <value>
431              sets the zero origin for alternate time tick marks.
432
433       ruler_step <value>
434              sets the left/right step value for the alternate time tick marks
435              from the origin.  When this value is zero, alternate  time  tick
436              marks are disabled.
437
438       scale_to_time_dimension <value>
439              The  value  can  be  any  of the characters m, u, n, f, p, or s,
440              which indicates which time dimension to convert the time  values
441              to.  The  default  for this is * which means that time dimension
442              conversion is disabled.
443
444       show_base_symbols <value>
445              A nonzero value (default) indicates that the numeric  base  sym‐
446              bols for hexadecimal ('$'), binary ('%'), and octal ('#') should
447              be rendered. Otherwise they will be omitted.
448
449       show_grid <value>
450              A nonzero value (default) indicates that a grid should be  drawn
451              behind  the  traces.  A  zero  indicates  that no grid should be
452              drawn.
453
454       splash_disable <value>
455              Turning this off enables the splash screen with the GTKWave mas‐
456              cot when loading a trace. Default is on.
457
458       sst_dbl_action_type <value>
459              Allows double-clicking to be active in the SST signals pane with
460              the following actions possible: insert (default),  replace,  ap‐
461              pend, prepend, none.  The value specified for the action is case
462              insensitive and only the first letter is required.  Invalid  ac‐
463              tion types default to none.
464
465       sst_dynamic_filter <value>
466              When  true (default) allows the SST dialog signal filter to fil‐
467              ter signals while keys are being pressed, otherwise  enter  must
468              be pressed to cause the filter to go active.
469
470       sst_expanded <value>
471              When true allows the SST dialog (when not hidden) to come up al‐
472              ready expanded.
473
474       strace_repeat_count <value>
475              Determines how many times that edge search  and  pattern  search
476              will  iterate  on  a search.  This allows, for example, skipping
477              ahead 10 clock edges instead of 1.
478
479       use_big_fonts <value>
480              A nonzero value indicates that any text rendered into  the  wave
481              window  will  use fonts that are four points larger in size than
482              normal. This can enhance readability.  A  zero  value  indicates
483              that normal font sizes should be used.
484
485       use_fat_lines <value>
486              A  nonzero value indicates that any lines rendered into the wave
487              window will be two pixels wide instead  of  a  single  pixel  in
488              width. This can enhance readability. A zero value indicates that
489              normal line widths should be used.
490
491       use_frequency_delta <value>
492              allows you to switch between the delta time and  frequency  dis‐
493              play in the upper right corner of the main window when measuring
494              distances between markers.  Default behavior is that  the  delta
495              time is displayed (off).
496
497       use_gestures <value>
498              if  supported  by  the  GTK version will enable gestures such as
499              swipe in the wave window. The default is that  this  feature  is
500              enabled if a touch screen is available (value is "maybe").  Val‐
501              ues of on or off are also permissible.
502
503       use_full_precision <value>
504              does not round time values when the number of  ticks  per  pixel
505              onscreen  is  greater  than  10 when active. The default is that
506              this feature is disabled.
507
508       use_maxtime_display <value>
509              A nonzero value indicates that the maximum  time  will  be  dis‐
510              played  in  the upper right corner of the screen. Otherwise, the
511              current primary (unnamed) marker time will  be  displayed.  This
512              can  be  toggled at any time with the Toggle Max-Marker menu op‐
513              tion.
514
515       use_nonprop_fonts <value>
516              Allows accelerated redraws of the signalwindow that can be  done
517              because the font width is constant. Default is off.
518
519       use_pango_fonts <value>
520              Uses  anti-aliased  pango fonts (GTK2) rather than bitmapped X11
521              ones. Default is on.
522
523       use_roundcaps <value>
524              A nonzero value indicates that vector  traces  should  be  drawn
525              with  rounded  caps  rather than perpendicular ones. The default
526              for this is zero.
527
528       use_scrollbar_only <value>
529              A nonzero value indicates that the page, shift, fetch, and  dis‐
530              card  buttons  should  not  be  drawn  (i.e., time manipulations
531              should be through the scrollbar only  rather  than  front  panel
532              buttons). The default for this is zero.
533
534       use_scrollwheel_as_y <value>
535              A  nonzero  value  indicates  that the scroll wheel on the mouse
536              should be used to scroll the signals up  and  down  rather  than
537              scrolling the time value from left to right.
538
539       use_standard_clicking <value>
540              This  option  no  longer  has  any effect in gtkwave: normal GTK
541              click semantics are used in the signalwindow.
542
543       use_standard_trace_select <value>
544              A nonzero value keeps the currently selected traces  from  dese‐
545              lecting  on  mouse  button  press.  This allows drag and drop to
546              function more smoothly.  As this behavior is not  how  GTK  nor‐
547              mally functions, it is by default disabled.
548
549       use_toolbutton_interface <value>
550              A  nonzero value indicates that a toolbar with buttons should be
551              at the top of the screen instead of the traditional  style  gtk‐
552              wave button groups.  Default is on.
553
554       vcd_explicit_zero_subscripts <value>
555              indicates  that  signal  names  should  be  stored internally as
556              name.bitnumber when enabled. When disabled, a more "normal"  or‐
557              dering  of name[bitnumber] is used. Note that when disabled, the
558              Bundle Up and Bundle Down options are  disabled  in  the  Signal
559              Search  Regexp,  Signal Search Hierarchy, and Signal Search Tree
560              options. This is necessary as the internal data  structures  for
561              signals  are represented with one "less" level of hierarchy than
562              when enabled and those functions would not work  properly.  This
563              should  not  be  an issue if atomic_vectors are enabled. Default
564              for vcd_explicit_zero_subscripts is disabled.
565
566       vcd_preserve_glitches <value>
567              indicates that any repeat equal values for a net  spanning  dif‐
568              ferent  time values in the VCD/FST file are not to be compressed
569              into a single value change but should remain in order  to  allow
570              glitches  to  be  present  for  this  case. Default for vcd_pre‐
571              serve_glitches is disabled.
572
573       vcd_preserve_glitches_real <value>
574              indicates that any repeat equal values for a real  net  spanning
575              different  time  values  in  the VCD/FST file are not to be com‐
576              pressed into a single value change but should  remain  for  this
577              case.  Default  for  vcd_preserve_glitches is disabled.  The in‐
578              tended use is for when viewing  analog  interpolated  data  such
579              that  removing duplicate values would incorrectly deform the in‐
580              terpolation.
581
582       vcd_warning_filesize <value>
583              produces a warning message if the VCD filesize is  greater  than
584              the argument's size in MB.  Set to zero to disable this.
585
586       vector_padding <value>
587              indicates  the  number of pixels of extra whitespace that should
588              be added to any strings for the purpose of calculating  text  in
589              vectors.  Permissible  values are 0 to 16 with the default being
590              4.
591
592
593       vlist_compression <value>
594              indicates the value to pass  to  zlib  during  vlist  processing
595              (which  is  used  in the VCD recoder).  -1 disables compression,
596              0-9 correspond to the value zlib expects.  4 is default.
597
598       vlist_prepack <value>
599              indicates that the VCD recoder should  pre-compress  data  going
600              into  the  value  change vlists in order to reduce memory usage.
601              This is done before potential zlib packing.  Default is off.
602
603       vlist_spill <value>
604              indicates that the VCD recoder should spill all generated vlists
605              to  a  tempfile on disk in order to reduce memory usage. Default
606              is off.
607
608       wave_scrolling <value>
609              a nonzero value enables scrolling by dragging the marker off the
610              left  or  right  sides of the wave window. A zero value disables
611              it.
612
613       zoom_base <value>
614              allows setting of the zoom base with a  value  between  1.5  and
615              10.0. Default is 2.0.
616
617       zoom_center <value>
618              a  nonzero  value  enables center zooming, a zero value disables
619              it.
620
621       zoom_dynamic <value>
622              a nonzero value enables dynamic full zooming when using the par‐
623              tial VCD (incremental) loader, a zero value disables it.
624
625       zoom_dynamic_end <value>
626              a  nonzero  value enables dynamic zoom to the end when using the
627              partial VCD (incremental) loader, a zero value disables it.
628
629       zoom_pow10_snap <value>
630              corresponds to the Zoom Pow10 Snap menu option. Default for this
631              is disabled (zero).
632

AUTHORS

634       Anthony Bybell <bybell@rocketmail.com>
635

SEE ALSO

637       gtkwave(1)
638
639
640
641Anthony Bybell                      3.3.81                        GTKWAVERC(5)
Impressum