1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167
|
Wbd Shared Multicast Whiteboard
===============================
Wbd is a wb-compatible shared whiteboard. Its home page is
<http://bashful.lboro.ac.uk/ROPA/wbd.html>.
The development of wbd was partly funded by the ESPRIT ROPA
Award Scheme as part of the "Tools for the Construction of
Value-Added Services on High-Speed Networks" project at
LUTCHI Research Centre, Loughborough University.
Please see the file COPYRIGHT for details of the terms
under which this software has been released.
WARNING!
========
This is an alpha-quality release.
The rate-limiting / ack-implosion-avoidance system is very
new and probably very buggy. The alternative was to leave it
out which seemed like an even worse idea :-)
Both wb and wbd can be easily convinced to crash by sending
them dud data, so running this early release of wbd in an
international conference isn't recommended!
Screen redrawing is quite slow and wbd is generally
unoptimised.
Building
========
Building wbd requires Tcl7.6 and Tk4.2. Wbd was developed
using the p2 revisions of those libraries, but will likely
build correctly with any of the stable versions.
To build wbd you must first edit the Makefile to identify
where your tcl and tk libraries live and to uncomment the
correct set of build commands for your platform. I have
included examples for IRIX 5.3, SunOS 4.1.4, SunOS 5.5.1,
Linux, and NetBSD 1.2.
With those matters taken care of, wbd should build with a
single "make".
Installing
==========
By default wbd compiles to a standalone executable so you can
simply copy the 'wbd' binary to its final home.
Wbd calls two external programs, so if you don't already have
them you will also need to build and install them:
xgrabsc - to grab screen images. (X11 contrib.)
gs - to render postscript. (Ghostscript!)
Usage
=====
Command line arguments:
Usage: wbd [-N username] [-C confname] [-maxhops n]
[-p|-l|+l] [-r|+r] [-geometry wxh+x+y]
[-P filesize] [-R bandwidth] [-help] address/port
-N username Set the announced username.
-C confname Set the conference window name.
-maxhops n Set the TTL to n.
-t n Set the TTL to n, (as -maxhops).
-p,-l,+l Portrait/Landscape mode,
-r,+r Disable/Enable writing to the whiteboard.
-geometry g Set the window's geometry to g (wxh+x+y).
-P size Set the Postscript file size limit to size.
-R bw Set the bandwidth limit to bw (bits/s).
-help Display this message.
Wbd generally behave like wb. The major exceptions are:
Mouse Buttons:
Mod. Left Middle Right
---- ---- ------ -----
None | Draw Paste text Delete
Shift | Show control panel Undelete
Delete only works on one object at a time; you can't sweep
through a whole area.
The control panel is not always displayed. To show it do
Shift + Left-Mouse-Button.
Text is input via a text tool, which must be selected before
you start typing.
The Grab button lets you grab part of the screen and imports
it as postscript. Warning - this can create LOTS of data and
eat lots of bandwidth!!!
The postscript file size limitations of wb are present in wbd
but not enforced. When you try to import a large file wbd will
ask you to confirm or cancel it.
The Dump button (in the Control Panel) lets you save all the
data in wbd to a file. Reload (also in the Control Panel)
reads in these dump files and puts the data on new pages.
The control panel doesn't let you hide particular authors'
work. It also doesn't show activity as well as wb's panel,
though it usually shows more data.
Limitations
===========
Due to limitations in the standard version of Tk:
1) Rotated characters aren't displayed properly.
2) Postscript and screen-grab data isn't printed by Print.
Printing also doesn't like my text fonts.
Also, for other reasons:
3) Wbd only handles single-page postscript files.
4) Item (2) doesn't matter because printing has been totally
disabled in this version.
Enabling Printing
=================
Wbd is currently configured to build stand-alone, without any
extensions to Tk, but as this broke printing completely I have
commented out the print buttons.
Printing may be reenabled by removing the -DSTAND_ALONE flag
from the Makefile, shortening the list of TCL_FILES in the
Makefile to include only wbdxbm.tcl, wbddlg.tcl and wbd.tcl
and editing wbd.tcl to uncomment the Print buttons (six lines
in BuildPanel, three in BuildInfo). When built with these
options wbd is not standalone - Tcl and Tk must be installed
on your system for it to run.
Printing will have the problems noted in Limitations above.
Credits
=======
Wbd's Tcl initialisation files are compiled into C using the
included "tcl2c" which originally comes from Ron Frederick's
(Xerox) nv distribution.
Julian Highfield,
23rd July 1997.
LUTCHI Research Centre,
Loughborough University.
J.C.Highfield@lboro.ac.uk
|