| META TOPICPARENT | name="ProjectWonderlandMicrophoneAdmin" |
Home | Changes | Index | Search | Go <-- This creates the navigation links to : Home | Help | Index | etc. -->
VNC Viewer Administration
<-- Your JavaDesktop? article goes here. Please try to include at least one sentence describing this topic. -->
<-- Also please try to include at least one sentence describing where each link goes. -->
<-- Please make sure some other page points to your new article so that others can find it! -->
<-- For more on how to write Javapedia articles please read the WritingArticles? page. -->
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:
| Property | Type | Description | Default | Required? |
| server | string | the IP address or host name of the VNC server | 192.168.0.1 | Y |
| username | string | the username required to access the VNC server | username | N |
| password | string | the VNC server password | password | Y |
| readOnly | boolean | whether the VNC session is read only | false | N |
| preferredWidth | double | the preferred width in pixels | 1024 | N |
| preferredHeight | double | the preferred height in pixels | 768 | N |
| pixelScale | float | scale factor used to scale the VNC window | 1.0 | N |
| decorated | boolean | whether to display a border around the application | true | N |
|