Here are the latest official (VUNZ) copies of the vuw widgets.  This
version will work with tcl 7.3 / tk 3.6 and has compiled successfully
under SunOS using ANSI C from Sun.

OVERVIEW

These handy little widgets consist of 

	dial 		a "clock face" gauge with a rotating indicator hand
			which can be scaled as you wish to represent various
			integer values

	bargraph	a "gas gauge" (growing/shrinking bar) such as many
			mac applications use to indicate %age of file processed,
			count of bytes transferred etc.

	stripchart	the good old loadmeter chart, one vertical strip
			per sample

	pie		a pie chart with legend, shading, exploded segments,
			etc.  NOTE the pie chart is the least robust of the
			bunch and as of this writing does not work properly
			on monochrome displays

All these widgets have the superior feature of a timer/callback mechanism.
That is, you can 'start' them and have them call a tcl procedure every
N milliseconds.  The Tcl procedure, naturally, would usually check some
value, read a socket, do a calculation, whatever, and then update the
meter widget with a new value as a result.

For fun, try shoving a sin function at the stripchart widget with a
refresh rate (interval) of 20 ms or so!

The latest version out of NZ had actually removed that feature from the
Dial widget, but left it in all the others.  I have restored it to the
dial widget.  The original NZ code is mumble.c.ORIG.  The plain .c files
are the ones I have hacked on to

	a) make them compile properly with my SunOS ANSI C (they want
	   gcc as shipped) -- you could use gcc on the ORIG files and
	   they will probably compile fine

	b) restore the callback feature to the dial widget as mentioned
	   above -- remember that the Dial widget has been crippled in
	   the ORIG sources

INSTALLATION

To do this the way I did it (which you may not want to do, see below):

the tk.h and tkWindow.c files are to replace those in your tk3.6 source
directory.  You might want to diff them against your Berkeley versions
to make sure you understand what the vuw changes are.

*.DIST files are the UC Berkeley Tk 3.6 versions

You will also need to hack about your tk Makefile.  I include mine as
a reference.  Try diffing it against yours.  You may not like the
way I patched the vu widgets in.  I'm not sure I like it myself.
But it does work.

NOTE:  the way I built these widgets is not so much an extension 
as a patch to the heart of Tk (the Berkeley code).  I actually altered
the Berkeley source, so with my Makefile they are an intrusive patch.
Using the original NZ Makefile they are an extension and the wish you
build with them is a separate wish.  I build TclX on top of tk, and
I didn't want to change the arcane TclX Makefile labyrinth, so I decided
to change the base Tk instead.  You may want to do otherwise.  See
Makefile.ORIG for clues.

Then:
You will need to remake/reinstall tk3.6.  If you have tclX, you will need to
remake/reinstall tk3.6, then make clean and remake tclX.  Then, of course, if
you have even further extensions on top of that, you know what you
have to do.  Because you've done it a zillion times :-)

DOCUMENTATION

I don't yet have the new manpages from NZ.  I have included the old man
pages as a rough guide to the widget configuration options, but if I
were you I would crank up wish, create a widget, and use 
	.widgetname configure
to find out what this version can do.

-------------------------------------------------------------------------

I like these widgets a lot.  I'm trying to convince the author(s) to 
make a definitive release version to be posted on harbor.

If you have bug reports, comments, or suggestions, please send them
to jules@Comp.VUW.AC.NZ (the current maintainer).  You can cc me if
you like...

de
de@lick.ucsc.edu

"Sybase+Tk=Power&Fun..."

