Tornado API Reference : GUI Tcl Library (UNIX)

barchart

NAME

barchart - bar charting object

TCL PROCEDURES

chartCreate - create a new Tcl chart
chartSetQuantities - establish a set of quantities to display in a chart
chartPost - post a chart
chartTitleSet - set the title of a chart window
chartDestroy - destroy a chart
chartUnpost - removed a chart from the display
chartSetValues - set the values of the quantities contained in a chart

DESCRIPTION

This library contains all the bar chart Tcl functions for the UNIX GUI.

SEE ALSO

barchart


GUI Tcl Library (UNIX) : Tcl Procedures

chartCreate

NAME

chartCreate - create a new Tcl chart

LOCALE

UNIX GUI

SYNOPSIS

chartCreate name [-destroy proc] [-scale] [-valuefmt fmt] [-size w h] [-eltsize h]

DESCRIPTION

A new chart is created with the specified name. The size of the chart window may be specified in pixels with the -size specification. The vertical size allotted to each element in the chart may be specified by -eltsize. To display values in the chart, it must first be configured with chartSetQuantities and chartSetValues, then posted to the screen with chartPost.

If -scale is given, the maximum and minimum values of the quantities of the chart is be drawn beneath the chart bars.

If -valuefmt is given, fmt is used as a printf( ) style format for displaying the value of the quantity inside the bar itself.

If -destroy is given, proc is used as the name of a Tcl procedure that is invoked if the chart is destroyed by the user. The procedure is invoked with one argument: the name of the chart.

SEE ALSO

barchart, chartSetQuantities, chartSetValues, chartPost, chartDestroy


GUI Tcl Library (UNIX) : Tcl Procedures

chartSetQuantities

NAME

chartSetQuantities - establish a set of quantities to display in a chart

LOCALE

UNIX GUI

SYNOPSIS

chartSetQuantities name {{qname qmin qmax}...}

DESCRIPTION

The named chart is directed to display the list of quantities given. Each item in the quantity list is itself a three-element list containing the quantity name and its minimum and maximum value. Any previous quantities the chart contained are discarded. The initial values of the quantities are each set to qmin.

SEE ALSO

barchart, chartSetValues, chartCreate, chartPost


GUI Tcl Library (UNIX) : Tcl Procedures

chartPost

NAME

chartPost - post a chart

LOCALE

UNIX GUI

SYNOPSIS

chartPost name

DESCRIPTION

The named chart is posted (made visible on the display). It is not an error to attempt to post a nonexistent chart.

SEE ALSO

barchart, chartUnpost, chartCreate


GUI Tcl Library (UNIX) : Tcl Procedures

chartTitleSet

NAME

chartTitleSet - set the title of a chart window

LOCALE

UNIX GUI

SYNOPSIS

chartTitleSet name title

DESCRIPTION

The titlebar text of the named chart is set to title.

SEE ALSO

barchart, chartCreate, chartPost


GUI Tcl Library (UNIX) : Tcl Procedures

chartDestroy

NAME

chartDestroy - destroy a chart

LOCALE

UNIX GUI

SYNOPSIS

chartDestroy name

DESCRIPTION

The named chart is destroyed, and removed from the screen if visible.

SEE ALSO

barchart, chartUnpost, chartCreate


GUI Tcl Library (UNIX) : Tcl Procedures

chartUnpost

NAME

chartUnpost - removed a chart from the display

LOCALE

UNIX GUI

SYNOPSIS

chartUnpost name

DESCRIPTION

The named chart is removed from the display. It is not an error to attempt to unpost a nonexistent chart.

SEE ALSO

barchart, chartPost, chartCreate


GUI Tcl Library (UNIX) : Tcl Procedures

chartSetValues

NAME

chartSetValues - set the values of the quantities contained in a chart

LOCALE

UNIX GUI

SYNOPSIS

chartSetValues name {{value [min max mark1 mark2]}... }

DESCRIPTION

Within the named chart, the quantities are assigned values from the supplied value list, in the order the quantities were assigned to the chart by chartSetQuantities. Excess values are ignored and quantities that are not assigned values by this command are undisturbed. The chart is redrawn to reflect the new values immediately. Each item in the value list is itself a list. The first element is the new value of the bar; the remaining four entries (min, max, mark1, mark2) are optional. If specified, they provide new minimum and maximum scale values for the bar, and new values for the "marks" (the little triangles that go above (mark1) and below (mark2) the bar).

SEE ALSO

barchart, chartSetQuantities, chartCreate