# !ViNCe config file

# Before modifying this file for the first time, you should
#   * create a directory ViNCe in <Choices$Dir>,
#   * copy this file to <Choices$Dir>.ViNCe,
# then you should modify the copy in <Choices$Dir>.ViNCe.

# password to use
password=

# server to use (host name or IP address)
server=

# X-display to use
display=1

# set to 1 to use 8bpp display, or 0 to use 16bpp
8bpp=1

# set dither8=1 to send raw 16bpp data as raw 8bpp dithered
dither8=1

# fullscreen mode configuration (for NCs), 'full' also set bgcolour
#full=AB9300
#ontop=1
#noborder=1
#anti=1

# open the window on top
#openontop=1

# try display, display+1, ... display+guess
guess=0

# scale the display (%)
scale=100

# set checkclientbitmap=1 to tell the server to check that
# data is sent unless the display has changed
checkclientbitmap=1

# set cursor=1 to display the clients own cursor
cursor=1

# print debug information to stderr (slows down the application)
#debug=1

# support tight-encoding
#tight=1

# save bitmap when done
#save=1

# what to do when the window is being closed
# 0 -> quit   1 -> iconbar (quit with the task manager, for instance)
closewindow=0

# specify if mouse tracking to set the focus should be done -- enabled
# by default (set to 0 if you use Vincent Lefvre's AutoFocus module)
#mousetracking=0

# set the mouse bounding box to the visible area of the window
#mousebbox=1

# set to 0 to disable display updates (display updates are slow on old
# RISC OS machines, and this option may be useful if you use ViNCe to
# share the keyboard and the mouse of the RISC OS machine while having
# a second monitor for the remote machine)
#displayupdates=0

# optimization value for window update (integer between 0 and 31),
# important when sending raw data to the screen is slow (e.g. for
# the users of the ViewFinder card).
# 1 should be a good value, but this may depend on the hardware.
#
# Technical information (in short): A window update consists of a list of
# rectangles to update. The current bounding box (if not empty) and the
# current rectangle will aggregate if the area of the resulting bounding
# box divided by 2^addrectshift is smaller or equal to the sum of the
# areas of the current bounding box and the current rectangle.
#
# If you want to see the difference between several values, you can enable
# debug information; you will get for each flushed rectangle:
#   * the area of the bounding box (the part of the sprite that is marked
#     for update),
#   * the sum of the areas of the accumulated rectangles (what you would
#     get if they weren't aggregated),
#   * the ratio (may be smaller than 1 if some accumulated rectangles
#     overlap). The smaller, the better.
# addrectshift=0 allows to obtain a very small ratio (<= 1) for any
# rectangle, but much overhead due to many rectangles to update.
# addrectshift=1 is a good compromise.
#
addrectshift=1

# use Wimp_BlockCopy (for rfbEncodingCopyRect encodings) as this is much
# faster with the ViewFinder card.
# Note: this is active only if scale=100 (otherwise it doesn't work).
fastcopy=1

# RISC OS key codes
#shiftkey=0
#ctrlkey=1
#altkey=2
#metakey=-1

# Hotkey to quit !ViNCe (you need Cerilica's DeepKeys module). This
# is the DeepKey information word. See DeepKeys.DeepK_Help and the
# "Low-level internal key numbers" page of the StrongHelp OS manual
# (or PRM 1-156) for more information. A program allowing to get
# the value corresponding to a hotkey should be provided in future
# !ViNCe versions. You can give the value either in base 10 or in
# base 16 (in which case, write "0x" before the value).
#hotkey_quit=0xc (LeftCtrl-RightCtrl-Escape)

# Hotkey to toggle display updates (you need Cerilica's DeepKeys module).
#hotkey_toggledisplay=0x3e000c (LeftCtrl-RightCtrl-d)

# Hotkey to toggle the mouse bounding box (you need Cerilica's DeepKeys
# module): entire screen / visible area of ViNCe's window.
#hotkey_togglembb=0x3e000c (LeftCtrl-RightCtrl-d)

# Hotkey to toggle fullscreen / window operation
# (you need Cerilica's DeepKeys module)
#hotkey_full = 0x1e000c (LeftCtrl-RightCtrl-Backspace)

# Set to 1 if you do not like the mouse wheel
#disable_scroll=1
