The Source for Java Technology Collaboration


Home | Changes | Index | Search | Go

Whiteboard Administration


Summary

The whiteboard allows avatars to draw and erase simple lines in multiple colors.

TBD

Adding a Whiteboard to your world

The whiteboard application is loaded into Wonderland using WFS. A sample WFS property file is provided in the wonderland-modules project on java.net:

https://lg3d-wonderland.dev.java.net/source/browse/*checkout*/lg3d-wonderland/modules/whiteboard/Whiteboard-wlc.xml?content-type=text%2Fplain

To install the Whiteboard, copy the WFS property file to the WFS directory on your Wonderland server. For example, to install the viewer in the default Wonderland MPK20 world, copy Whiteboard-wlc.xml to lg3d-wonderland/src/worlds/default-wfs/building-wld/DemoFloor-wld. The default property file loads the viewer at the starting point in the world. It should appear in front of your avatar when you enter the world.

The size of the whiteboard is specified by the following properties:

<void property="preferredWidth">
    <double>1024</double>
</void> 
<void property="preferredHeight">
    <double>768</double>
</void> 

These are preferred values; the Whiteboard will stretch the document to fit the specified width and height.

Once you've installed the file in the WFS directory, restart the Wonderland server, or use the Wonderland Manager application to reload WFS.

Deployment Tips

To have the Whiteboard appear properly (upright), it is necessary to rotate it about the +y (up) axis about 4.71 radians. The XML snippet below gives an example or properly setting the rotation property. The rotation property is part of the core set of properties for cells, see the WFS Reference Guide for more information.

<void property="rotation">
    <void index="0">
        <!-- set to 1.0 to rotate around x-axis -->
        <double>0.0</double>
    </void>
    <void index="1">
        <!-- set to 1.0 to rotate around y-axis -->
        <double>1.0</double>
     </void>
     <void index="2">
         <!-- set to 1.0 to rotate around z-axis -->
         <double>0.0</double>
     </void>
     <void index="3">
         <!-- angle of rotation around selected axis in radians pi radians (3.14) = 180 degrees -->
         <double>4.71</double>
     </void>
</void>

Application Properties

The Whiteboard can be pre-configured by setting the following properties in the WFS property file:

Property Type Description Default Required?
preferredWidth double the preferred width in pixels 640 N
preferredHeight double the preferred height in pixels 480 N

Topic ProjectWonderlandWhiteboardAdmin . { Edit | Ref-By | Printable | Diffs r2 < r1 | More }
 XML java.net RSS

Revision r2 - 01 Aug 2008 - 16:42:18 - Main.jslott
Parents: WebHome > ProjectWonderland