configure

The configure (config) command invokes the List or Wave widget configure command for the current default List or Wave window. To change the default window, use the view command.

Syntax

configure

list|wave [-window <wname>] [<option> <value>]

[-delta [all | collapse | none]] [-gateduration [<duration_open>]]
[-gateexpr [<expression>]] [-usegating [<value>]]
[-strobeperiod [<period>]] [-strobestart [<start_time>]]
[-usesignaltriggers [<value>]] [-usestrobe [<value>]]

[-childrowmargin [<pixels>]] [-gridcolor [<color>]] [-namecolwidth [<width>]] [-rowmargin [<pixels>]] [-signalnamewidth [<value>]] [-timecolor [<color>]]
[-valuecolwidth [<width>]] [-vectorcolor [<color>]]

Description

The command works in three modes:

• without options or values it returns a list of all attributes and their current values
• with just an option argument (without a value) it returns the current value of that attribute
• with one or more option-value pairs it changes the values of the specified attributes to the new values

The returned information has five fields for each attribute:

• the command-line switch
• the Tk widget resource name
• the Tk class name
• the default value
• and the current value

Arguments

list|wave

Specifies either the List or Wave widget to configure. Required.

-window <wname>

Specifies the name of the List or Wave window to target for the configure command. (The view command allows you to create more than one List or Wave window). Optional. If no window is specified the default window is used; the default window is determined by the most recent invocation of the view command.

<option> <value>

   -bg <color>

        Specifies the window background color. Optional.

   -fg <color>

        Specifies the window foreground color. Optional.

   -selectbackground <color>

        Specifies the window background color when selected. Optional.

   -selectforeground <color>

        Specifies the window foreground color when selected. Optional.

   -font <font>

        Specifies the font used in the widget. Optional.

   -height <pixels>

        Specifies the height in pixels of each row. Optional.

Arguments, List window only

-delta [all | collapse | none]

The all option displays a new line for each time step on which items change; collapse displays the final value for each time step; and none turns off the display of the delta column. To use delta, usesignaltriggers must be set to 1 (on). Optional.

-gateduration [<duration_open>]

The duration for gating to remain open beyond when -gateexpr (below) becomes false, expressed in x number of timescale units. Extends gating beyond the back edge (the last list row in which the expression evaluates to true). Optional. The default value for normal synchronous gating is zero. If -gateduration is set to a non-zero value, a simulation value will be displayed after the gate expression becomes false (if you don't want the values displayed, set -gateduration to zero).

-gateexpr [<expression>]

Specifies the expression for trigger gating. Optional. (Use the -usegating argument to enable trigger gating.) The expression is evaluated when the List window would normally have displayed a row of data. See the "GUI_expression_format" for information on expression syntax.

-usegating [<value>]

Enables triggers to be gated on (a value of 1) or off (a value of 0) by an overriding expression. Default is off. Optional. (Use the -gatexpr argument to specify the expression.) See "Setting List window display properties" for additional information on using gating with triggers.

-strobeperiod [<period>]

Specifies the period of the list strobe. (When using a time unit, the time value and unit must be placed in curly braces.) Optional.

-strobestart [<start_time>]

Specifies the start time of the list strobe. Optional.

-usesignaltriggers [<value>]

If 1, uses signals as triggers; if 0, not. Optional.

-usestrobe [<value>]

If 1, uses the strobe to trigger; if 0, not. Optional.

Arguments, Wave window only

-childrowmargin [<pixels>]

Specifies the distance in pixels between child signals. Optional.

-gridcolor [<color>]

Specifies the background grid color; the default is grey50. Optional.

-namecolwidth [<width>]

Specifies in pixels the width of the name column in the Wave window. Optional.

-rowmargin [<pixels>]

Specifies the distance in pixels between top-level signals.

-signalnamewidth [<value>]

Controls the number of hierarchical regions displayed as part of a signal name shown in the waveform window. Optional. Default of 0 displays the full path. 1 displays only the leaf path element, 2 displays the last two path elements, and so on.

-timecolor [<color>]

Specifies the time axis color; the default is green. Optional.

-valuecolwidth [<width>]

Specifies in pixels the width of the value column in the Wave window.

-vectorcolor [<color>]

Specifies the vector waveform color; the default is yellow. Optional.

Note: To get a more readable listing of all attributes and current values, use the lecho command, which pretty-prints a Tcl list.

Examples

config list -strobeperiod

Displays the current value of the strobeperiod attribute.

config list -strobeperiod {50 ns} -strobestart 0 -usestrobe 1

Sets the strobe waveform and turns it on.

config wave -vectorcolor blue

Sets the wave vector color to blue.

config wave -signalnamewidth 1

Sets display in current Wave window to show only leaf path of each signal.

See also

view

Model Technology Incorporated Voice: (503) 641-1340 Fax: (503)526-5410 www.model.com sales@model.com