WaVeVieW - (c) 2004 Tom Schouten
This program is free software. See the file COPYING for details.

wvvw is a wave (array) viewer widget for pure data.

features:
* fast. especially compared to native pd graphs and gui objects.
* the widget runs in its own thread and should not cause drops.
* it can handle large arrays (peak cache).
* idiosyncratic. minimalist interface: mouse + single key hotkeys.



building

./configure 
make 
make install



running

load with -lib or move the object into the pd extern path.
(installed to $(prefix)/lib/pd/extra by default)


documentation

[vwwv <array>] creates a view widget in the main wvvw window.
you can have more than one active widget, they will be stacked
vertically in the display window.

the vwwv object supports these messages:
* array <array>			set the current array
* refresh			refresh the wave display
* select <start> <length>	set selection
* view <start> <length>		set view
* needle <position>		set set the needle ( < 0 = disable )

the widget responds to these commands:
* left mouse button	set selection start
* right mouse button	set selection end
* middle mouse button	zoom (vertical axis) and move (horizontal axis)
* mouse wheel		amplitude gain
* 'f'			full view
* 's'			selection view
* 'a'			select all
* 'r'			refresh peak cache
* 'F'			fullscreen

if you press a key that is not an internal command, it
will be sent to the outlet as a pd message:

<keysym> <selection_start> <selection_length>



(f)aq

* why only one window?		
	simpler to implement. less clutter.

* why no gop?
	i have no idea how to implement this.

* closing the window exits pd?	
	yes. this is a glut limitation.

* how can i arrange the wigets?	
	you can't. first come, first serve.



that's about it.

enjoy,
tom