|*||switching in and out of full-screen mode|
|*||quitting the viewer|
|*||generating key events, e.g. sending ctrl-alt-del|
|*||accessing the options dialog and various other dialogs|
By default, key presses in the popup menu get sent to the VNC server and dismiss the popup. So to get an F8 through to the VNC server simply press it twice.
A full-screen mode is supported. This is particularly useful when connecting to a remote screen which is the same size as your local one. If the remote screen is bigger, you can scroll by bumping the mouse against the edge of the screen.
Unfortunately this mode doesnt work completely with all window managers, since it breaks the X window management conventions.
You can get a list of parameters by giving -h as a command-line option to vncviewer. Parameters can be turned on with -param or off with -param=0. Parameters which take a value can be specified as -param value. Other valid forms are param=value -param=value --param=value. Parameter names are case-insensitive.
Many of the parameters can also be set graphically via the options dialog box. This can be accessed from the popup menu or from the "Connection details" dialog box.
-display Xdisplay Specifies the X display on which the VNC viewer window should appear.
-geometry geometry Standard X position and sizing specification.
-listen [port] Causes vncviewer to listen on the given port (default 5500) for reverse connections from a VNC server. WinVNC supports reverse connections initiated using the Add New Client menu option or the -connect command-line option. Xvnc supports reverse connections with a helper program called vncconfig.
-passwd password-file If you are on a filesystem which gives you access to the password file used by the server, you can specify it here to avoid typing it in. It will usually be "~/.vnc/passwd".
-Shared When you make a connection to a VNC server, all other existing connections are normally closed. This option requests that they be left open, allowing you to share the desktop with someone already using it.
-ViewOnly Specifies that no keyboard or mouse events should be sent to the server. Useful if you want to view a desktop without interfering; often needs to be combined with -Shared.
-FullScreen Start in full-screen mode.
-AutoSelect Use automatic selection of encoding and pixel format (default is on). Normally the viewer tests the speed of the connection to the server and chooses the encoding and pixel format appropriately. Turn it off with -AutoSelect=0.
-FullColour, -FullColor Tells the VNC server to send full-colour pixels in the best format for this display. By default a low colour mode is used until AutoSelect decides the link is fast enough. However if the servers native pixel format is colourmapped (as opposed to truecolour) then the servers format is used by default.
-LowColourLevel level Selects the reduced colour level to use on slow links. level can range from 0 to 2, 0 meaning 8 colours, 1 meaning 64 colours (the default), 2 meaning 256 colours.
-PreferredEncoding encoding This option specifies the preferred encoding to use from one of "ZRLE", "hextile" or "raw".
-UseLocalCursor Render the mouse cursor locally if the server supports it (default is on). This can make the interactive performance feel much better over slow links.
-WMDecorationWidth w, -WMDecorationHeight h The total width and height taken up by window manager decorations. This is used to calculate the maximum size of the VNC viewer window. Default is width 6, height 24.
-log logname:dest:level Configures the debug log settings. dest can currently be stderr or stdout, and level is between 0 and 100, 100 meaning most verbose output. logname is usually * meaning all, but you can target a specific source file if you know the name of its "LogWriter". Default is *:stderr:30.
-MenuKey keysym-name This option specifies the key which brings up the popup menu. The key is specified as an X11 keysym name (these can be obtained by removing the XK_ prefix from the entries in "/usr/include/X11/keysymdef.h"). Default is F8.
Tristan Richardson, RealVNC Ltd.
VNC was originally developed by the RealVNC team while at Olivetti Research Ltd / AT&T Laboratories Cambridge. It is now being maintained by RealVNC Ltd. See http://www.realvnc.com for details.
|RealVNC Ltd||VNCVIEWER (1)||03 Mar 2005|