File: readme

package info (click to toggle)
wbd 1.0ucl4-7
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 296 kB
  • ctags: 476
  • sloc: ansic: 4,131; tcl: 1,663; makefile: 91
file content (167 lines) | stat: -rw-r--r-- 5,092 bytes parent folder | download | duplicates (4)
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