Provided by: gtkwave_3.3.24-1_i386 bug

NAME

       gtkwaverc - 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
       configuration 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
              .gtkwaverc 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
              hierarchy inside of $var statements.

       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
              hierarchy   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 everything 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
              bundle 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).

       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-
              valued 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
              suppressed.   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
              bubbles  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
              initial zoom should be zero (default).

       dynamic_resizing <value>
              A  nonzero  value  indicates  that  dynamic  resizing  should be
              initially enabled (default). A zero value indicates that dynamic
              resizing should be initially disabled.

       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
              generate 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
              appropriate 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
              appropriate  fontnames using the xfontsel program. Note that the
              signal font must be taller than the wave font or the viewer will
              complain 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
              levels  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
              display for trace names. Note that a value of zero displays  the
              full hierarchy name.

       hpane_pack <value>
              A  nonzero  value  indicates  that the horizontal pane should be
              constructed using  the  gtk_paned_pack  functions  (default  and
              recommended).  A zero value indicates that gtk_paned_add will be
              used instead.

       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
              saving.  Default is that the size attribute is used.

       initial_signal_window_width <value>
              Sets  the  creation  width  for   the   signal   pane   on   GUI
              initialization.   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.

       left_justify_sigs <value>
              When nonzero, indicates  that  the  signal  window  signal  name
              justification  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
              symbols 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
              mascot when loading a trace. Default is on.

       sst_dynamic_filter <value>
              When true (default) allows  the  SST  dialog  signal  filter  to
              filter  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
              display  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
              displayed 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
              discard 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_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
              gtkwave 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
              different  time  values in the vcd 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_preserve_glitches is disabled.

       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
              partial 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@nc.rr.com>

SEE ALSO

       gtkwave(1)