Home | Changes | Index | Search | Go

VNC Viewer Administration

Summary

Adding a VNC Viewer to your world

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

https://wonderland-modules.dev.java.net/source/browse/*checkout*/wonderland-modules/trunk/src/modules/apps/2d/tightvncviewer/VNC-wlc.xml?content-type=text%2Fplain

To install the VNC Viewer, 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 VNC-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.

Next, edit the file and customize the following properties:

The IP address or host name of the VNC server:

<void property="server">
    <string>192.168.0.1</string>
 </void> 

The VNC Viewer uses the default VNC port: 5900. If your VNC server is running on a non-standard port, change the port property:

<void property="port">
    <int>5900</int>
</void>

Specify the user name and password:

<void property="username">
    <string>username</string>
</void>
<void property="password">
    <string>password</string>
</void>

The size of the application is specified in units of pixels. Generally, it makes sense to use the actually resolution of the remote desktop as a starting point. The VNC Viewer will resize to maintain the correct aspect ratio of the remote desktop. Set the preferred size using the following properties:

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

If you need to scale the VNC Viewer to be larger than normal size, use the pixelScale property rather than increasing the preferred size properties. Using pixelScale to scale the VNC session is faster because it uses the hardware scaling capabilities of your graphics card.

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

Things to be aware of when deploying the VNC Viewer application.

Application Properties

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