This documentation is a revised edition of the
MICE documentation of
National Support Centre London
Revision by Jens Elkner (elkner@irb.cs.uni-magdeburg.de).

Other User documentation


The Whiteboard Window

The title of the conference is shown at the top, left of the frame. This is set up using a command-line parameter (-C) when wb is invoked.

The site that creates a page can give it a name of up to 32 letters. Complementing the # indication in the Participants Information window, there is a * against the page name in the wb window if the current page is incomplete.

The right side and the foot of the whiteboard are lined with tools. these tools are explained here:

Tools
Drawing Tools
These are described on the Whiteboard image itself.
  • Any tool can be assigned to the left and middle mouse buttons; the defaults are shown below.

    MOUSE

    To assign a button, simply use that button to select the tool

  • The right mouse button is dedicated to erase/unerase and cannot be reassigned. The erase can be reassigned to the left or middle buttons. This allows the use of a mouse with less than three buttons or a pen.
  • The erase tool works in two ways
    • click and release the button without moving the mouse to erase the most recently drawn object.
    • hold down the button and move the mouse to touch any object with the pointer.
Font
Click on this button to reveal a list of fonts from which you can choose when typing. The selected font is indicated.
Brush
Click on button to reveal a selection of brush sizes when drawing. The selected size is indicated.
Colour palette
Click on the colour of choice and the selected colour will appear boxed. On small screens the palette is a menu to save space in landscape orientation.
Undo
Undo is undelete, the same as shift-right mouse. The label was shortened to fit the button.
Page orientation
There are three views provided, landscape, seascape and portrait. The left margin of the image is shown on each of the icons. The selected view appears boxed.
Print
Click on this button to reveal a dialogue box in which to type a save command for the current page. The page is saved as PostScript, to a file or printer.
Blank Page
Click on this button to create a new blank page following the last page created. Wherever you are when you create a new page wb will move you on to the new page. If you are on page 2 of 10 pages currently created, the new page will be page 11 and you will be moved to it.
Clone Page
Performs as for Blank Page, but copies the contents of the current page onto the newly-created page before moving you to it.
Import PS
Wb will allow you to import arbitrary PostScript files. If you import a multiple page document, the input pages are displayed on new wb pages following the last current wb page. Files containing multiple pages MUST conform to the Adobe Document Structuring Conventions.

The reason for this is that remote sites may image the pages in arbitrary order and unstructured, multipage PostScript can only be rendered sequentially.

If wb is given a non-conforming multipage document, it will only image the first page. Such documents will always cause performance problems because the PostScript renderer must be killed and restarted each time the document is rendered. Also, they may cause wb to hang or not image subsequent pages.

You should try to use a tool that produces DSC conformant PostScript when preparing images for wb (e.g., idraw, Adobe Illustrator, SGI Showcase, etc.). If you have to use non-conformant files, you might try running them through distill (available from ftp.adobe.com in file still.ps) to turn it into DSC conformant PostScript.

wb keeps a cache of the PostScript pages it has recently rendered so that they don't have to be re-rendered as you flip between wb pages. This cache is in the form of pixmaps in the X server. These pixmaps can cause your X server to grow quite large:

  • At the default wb page size (612 x 792), each pixmap takes 60KB on a monochrome display & 480KB on a color display.
  • If wb is expanded to full screen, each pixmap takes ~1MB on a 1100 x 960 sun screen.
By default wb caches 16 pixmaps which is about 8MB of server space on a colour display with a default wb window. You can change the X resource wb.RasterCacheSize to some other number to increase or decrease the size of the cache.

The default maximum size for PostScript documents is 32K bytes. This can be increased by setting the -P flag on invocation. This flag is described in Starting wb. Large files may be reduced in size by filtering them through lzps which can achieve reductions to less than 50% of the original size. The command line is

                  lzps < input.ps > output.ps
Import Text
This feature allows the import of plain text to the whiteboard. There is no line wrapping of the source, so only the first 80 characters of each line (to a CRLF) will be displayed. If you import a large file, the input is displayed on a series of new wb pages following the last current wb page.
Page identification/hold
This button is labelled with the originator of the page and the page number in the form userid:pagenumber. When someone puts a mark on a new page, all participants are, by default, switched to viewing that page. To maintain your view of a particular page in these circumstances, click on this button. The button appears depressed and with a cross over it. To release the view, click again.
Keyboard input
Begin by selecting a suitable font and colour. There are two modes of typing to the board. You set the mode from the Participant Information window.

Useful control characters are:

Your cursor
Only you can see your mouse cursor. To point to something you must make a mark on the page - underline, circle or draw an arrow pointing to it. You can erase this pointer by clicking the right mouse button which removes the last object drawn.

Making cursors invisible to other participants was a conscious design decision based on research.

Hints on use
The following suggestions are offered from experience of using the tool. If you have other hints, please make them available by sending to mice-nsc-uk@cs.ucl.ac.uk.