summaryrefslogtreecommitdiffstats
path: root/x11vnc
diff options
context:
space:
mode:
authorrunge <runge>2007-04-19 03:46:35 +0000
committerrunge <runge>2007-04-19 03:46:35 +0000
commit2d0b184f8b99b5f60a8c4f94bfc42ebf96dbc9b3 (patch)
tree183909d81976af318eb9e8122e80409f6c4d8cf0 /x11vnc
parent65f77eb0a298f73fcd76c03f76920923315ea03a (diff)
downloadlibtdevnc-2d0b184f8b99b5f60a8c4f94bfc42ebf96dbc9b3.tar.gz
libtdevnc-2d0b184f8b99b5f60a8c4f94bfc42ebf96dbc9b3.zip
x11vnc: set to next release (0.9.1)
Diffstat (limited to 'x11vnc')
-rw-r--r--x11vnc/README190
-rw-r--r--x11vnc/x11vnc.1111
-rw-r--r--x11vnc/x11vnc.h2
-rw-r--r--x11vnc/x11vnc_defs.c2
4 files changed, 257 insertions, 48 deletions
diff --git a/x11vnc/README b/x11vnc/README
index 92f7bff..b5338b9 100644
--- a/x11vnc/README
+++ b/x11vnc/README
@@ -1,5 +1,5 @@
-x11vnc README file Date: Wed Apr 18 18:46:50 EDT 2007
+x11vnc README file Date: Wed Apr 18 22:27:25 EDT 2007
The following information is taken from these URLs:
@@ -403,7 +403,7 @@ vncviewer -via $host localhost:0 # must be TightVNC vncviewer.
The x11vnc package is the subset of the libvncserver package needed to
build the x11vnc program. Also, you can get a copy of my latest,
- bleeding edge [72]x11vnc-0.9.tar.gz tarball to build the most up to
+ bleeding edge [72]x11vnc-0.9.1.tar.gz tarball to build the most up to
date one.
Precompiled Binaries/Packages: See the [73]FAQ below for information
@@ -435,13 +435,13 @@ vncviewer -via $host localhost:0 # must be TightVNC vncviewer.
Building x11vnc:
If your OS has libjpeg.so and libz.so in standard locations you can
- build as follows (example given for the 0.8.4 release of x11vnc:
- replace with the version you downloaded):
+ build as follows (example given for the 0.9 release of x11vnc: replace
+ with the version you downloaded):
(un-tar the x11vnc+libvncserver tarball)
-# gzip -dc x11vnc-0.8.4.tar.gz | tar -xvf -
+# gzip -dc x11vnc-0.9.tar.gz | tar -xvf -
(cd to the source directory)
-# cd x11vnc-0.8.4
+# cd x11vnc-0.9
(run configure and then run make)
# ./configure
@@ -657,13 +657,14 @@ make
I don't have any formal beta-testers for the releases of x11vnc, so
I'd appreciate any additional testing very much.
- Thanks to those who suggested features and helped beta test x11vnc
- 0.8.4 released in Feb 2007!
+ Thanks to those who suggested features and helped beta test x11vnc 0.9
+ released in Apr 2007!
- Please help test and debug the 0.9 version for release sometime in
- Spring 2007.
+ Please help test and debug the 0.9.1 version for release sometime in
+ Summer 2007.
- The version 0.9 beta tarball is kept here: [91]x11vnc-0.9.tar.gz
+ The version 0.9.1 beta tarball is kept here:
+ [91]x11vnc-0.9.1.tar.gz
There are also some Linux, Solaris, Mac OS X, and other OS test
binaries [92]here. Please kick the tires and report bugs, performance
@@ -678,7 +679,7 @@ make
[97]Enhanced TightVNC Viewer (SSVNC) page.
- Here are some features that will appear in the 0.9 release:
+ Here are some features that will appear in the 0.9.1 release:
* [98]Viewer-side pixmap caching. This one will benefit from much
testing. A large area of pixels (at least 2-3 times as big as the
framebuffer itself; the bigger the better... default is 12X) is
@@ -690,6 +691,9 @@ make
"-ncache 12". The unix Enhanced TightVNC Viewer [99]ssvnc has a
nice [100]-ycrop option to help hide the pixel cache area from
view.
+
+
+ Here are some features that appeared in the 0.9 release:
* [101]VNC Service advertising via mDNS / ZeroConf / BonJour with
the [102]Avahi client library. Enable via "[103]-avahi".
* Implementations of UltraVNC's TextChat, SingleWindow, and
@@ -7320,7 +7324,7 @@ References
69. http://sourceforge.net/projects/libvncserver/
70. http://sourceforge.net/project/showfiles.php?group_id=32584&package_id=119006&release_id=483129
71. http://sourceforge.net/project/shownotes.php?release_id=483129&group_id=32584
- 72. http://www.karlrunge.com/x11vnc/x11vnc-0.9.tar.gz
+ 72. http://www.karlrunge.com/x11vnc/x11vnc-0.9.1.tar.gz
73. http://www.karlrunge.com/x11vnc/index.html#faq-binaries
74. http://www.tightvnc.com/download.html
75. http://www.realvnc.com/download-free.html
@@ -7339,7 +7343,7 @@ References
88. http://www.karlrunge.com/x11vnc/index.html#faq-solaris251build
89. http://www.karlrunge.com/x11vnc/index.html#faq-macosx
90. http://www.karlrunge.com/x11vnc/index.html#faq-ssl-tunnel-int
- 91. http://www.karlrunge.com/x11vnc/x11vnc-0.9.tar.gz
+ 91. http://www.karlrunge.com/x11vnc/x11vnc-0.9.1.tar.gz
92. http://www.karlrunge.com/x11vnc/bins
93. mailto:xvml-beta@karlrunge.com
94. http://www.karlrunge.com/x11vnc/index.html#faq-ssl-tunnel-int
@@ -10519,7 +10523,7 @@ x11vnc: a VNC server for real X displays
Here are all of x11vnc command line options:
% x11vnc -opts (see below for -help long descriptions)
-x11vnc: allow VNC connections to real X11 displays. 0.9 lastmod: 2007-04-18
+x11vnc: allow VNC connections to real X11 displays. 0.9.1 lastmod: 2007-04-18
x11vnc options:
-display disp -auth file -N
@@ -10568,35 +10572,38 @@ x11vnc options:
-alphacut n -alphafrac fraction -alpharemove
-noalphablend -nocursorshape -cursorpos
-nocursorpos -xwarppointer -noxwarppointer
- -buttonmap string -nodragging -wireframe [str]
- -nowireframe -nowireframelocal -wirecopyrect mode
- -nowirecopyrect -debug_wireframe -scrollcopyrect mode
- -noscrollcopyrect -scr_area n -scr_skip list
- -scr_inc list -scr_keys list -scr_term list
- -scr_keyrepeat lo-hi -scr_parms string -fixscreen string
- -debug_scroll -noxrecord -grab_buster
- -nograb_buster -debug_grabs -debug_sel
- -pointer_mode n -input_skip n -allinput
- -speeds rd,bw,lat -wmdt string -debug_pointer
- -debug_keyboard -defer time -wait time
- -wait_ui factor -nowait_bog -slow_fb time
- -readtimeout n -nap -nonap
- -sb time -nofbpm -fbpm
- -nodpms -dpms -forcedpms
- -clientdpms -noserverdpms -noultraext
- -noxdamage -xd_area A -xd_mem f
- -sigpipe string -threads -nothreads
- -fs f -gaps n -grow n
- -fuzz n -debug_tiles -snapfb
- -rawfb string -freqtab file -pipeinput cmd
- -macnodim -macnosleep -macnosaver
- -macnowait -macwheel n -macnoswap
- -macnoresize -maciconanim n -macmenu
- -gui [gui-opts] -remote command -query variable
- -QD variable -sync -noremote
- -yesremote -unsafe -safer
- -privremote -nocmds -allowedcmds list
- -deny_all
+ -buttonmap string -nodragging -ncache n
+ -ncache_cr -ncache_no_moveraise -ncache_no_dtchange
+ -ncache_no_rootpixmap -ncache_keep_anims -ncache_old_wm
+ -ncache_pad n -wireframe [str] -nowireframe
+ -nowireframelocal -wirecopyrect mode -nowirecopyrect
+ -debug_wireframe -scrollcopyrect mode -noscrollcopyrect
+ -scr_area n -scr_skip list -scr_inc list
+ -scr_keys list -scr_term list -scr_keyrepeat lo-hi
+ -scr_parms string -fixscreen string -debug_scroll
+ -noxrecord -grab_buster -nograb_buster
+ -debug_grabs -debug_sel -pointer_mode n
+ -input_skip n -allinput -speeds rd,bw,lat
+ -wmdt string -debug_pointer -debug_keyboard
+ -defer time -wait time -wait_ui factor
+ -nowait_bog -slow_fb time -readtimeout n
+ -nap -nonap -sb time
+ -nofbpm -fbpm -nodpms
+ -dpms -forcedpms -clientdpms
+ -noserverdpms -noultraext -noxdamage
+ -xd_area A -xd_mem f -sigpipe string
+ -threads -nothreads -fs f
+ -gaps n -grow n -fuzz n
+ -debug_tiles -snapfb -rawfb string
+ -freqtab file -pipeinput cmd -macnodim
+ -macnosleep -macnosaver -macnowait
+ -macwheel n -macnoswap -macnoresize
+ -maciconanim n -macmenu -gui [gui-opts]
+ -remote command -query variable -QD variable
+ -sync -noremote -yesremote
+ -unsafe -safer -privremote
+ -nocmds -allowedcmds list -deny_all
+
libvncserver options:
-rfbport port TCP port for RFB protocol
@@ -10630,7 +10637,7 @@ libvncserver-tight-extension options:
% x11vnc -help
-x11vnc: allow VNC connections to real X11 displays. 0.9 lastmod: 2007-04-18
+x11vnc: allow VNC connections to real X11 displays. 0.9.1 lastmod: 2007-04-18
(type "x11vnc -opts" to just list the options.)
@@ -12754,6 +12761,99 @@ Options:
text selection, and some menu traversals. It overrides
any -pointer_mode setting.
+-ncache n Client-side caching scheme. Framebuffer memory "n"
+ (an integer) times that of the full display is allocated
+ below the actual framebuffer to cache screen contents
+ for rapid retrieval. So a W x H frambuffer is expanded
+ to a W x (n+1)*H one. Use 0 to disable. Default: XXX.
+
+ For this and the other -ncache* options below you can
+ abbreviate "-ncache" with "-nc". Also, "-nonc"
+ is the same as "-ncache 0"
+
+ This is an experimental option, currently implemented
+ in an awkward way in that in the VNC Viewer you can
+ see the cache contents if you scroll down, etc. So you
+ will have to set things up so you can't see that region.
+ If this method is successful, the changes required for
+ clients to do this less awkwardly will be investigated.
+
+ Note that this mode consumes a huge amount of memory,
+ both on the x11vnc server side and on the VNC Viewer
+ side. If n=2 then the amount of RAM used is roughly
+ tripled for both x11vnc and the VNC Viewer. As a rule
+ of thumb, note that 1280x1024 at depth 24 is about 5MB
+ of pixel data.
+
+ For reasonable response when cycling through 4 to 6
+ large (e.g. web browser) windows a value n of 6 to 12
+ is recommended. (that's right: ~10X more memory...)
+
+ Because of the way window backingstore and saveunders
+ are implemented, n must be even. It will be incremented
+ by 1 if it is not.
+
+ This mode also works for native MacOS X, but may not
+ be as effective as the X version. This is due to a
+ number of things, one is the drop-shadow compositing
+ that leaves extra areas that need to be repaired (see
+ -ncache_pad). Another is the window iconification
+ animations need to be avoided (see -macicontime).
+ It appears the that the 'Scale' animation mode gives
+ better results than the 'Genie' one. Also, window event
+ detection not as accurate as the X version.
+
+-ncache_cr In -ncache mode, try to do copyrect opaque window
+ moves/drags instead of wireframes (this can induce
+ painting errors). The wireframe will still be used when
+ moving a window whose save-unders has not yet been set
+ or has been invalidated.
+
+ Some VNC Viewers provide better response than others
+ with this option. On Unix, realvnc viewer gives
+ smoother drags than tightvnc viewer. Response may also
+ be choppy if the server side machine is too slow.
+
+ Sometimes on very slow modem connections, this actually
+ gives an improvement because no pixel data at all
+ (not even the box animation) is sent during the drag.
+
+-ncache_no_moveraise In -ncache mode, do not assume that moving a window
+ will cause the window manager to raise it to the top
+ of the stack. The default is to assume it does, and
+ so at the beginning of any wireframe, etc, window moves
+ the window will be pushed to top in the VNC viewer.
+
+-ncache_no_dtchange In -ncache mode, do not try to guess when the desktop
+ (viewport) changes to another one (i.e. another
+ workarea). The default is to try to guess and when
+ detected try to make the transistion more smoothly.
+
+-ncache_no_rootpixmap In -ncache mode, do not try to snapshot the desktop
+ background to use in guessing or reconstructing window
+ save-unders.
+
+-ncache_keep_anims In -ncache mode, do not try to disable window
+ manager animations and other effects (that usually
+ degrade ncache performance or cause painting errors).
+ The default is to try to disable them on KDE (but not
+ GNOME) when VNC clients are connected.
+
+ For other window managers or desktops that provide
+ animations, effects, compositing, translucency,
+ etc. that interfere with the -ncache method you will
+ have to disable them manually.
+
+-ncache_old_wm In -ncache mode, enable some heuristics for old style
+ window managers such as fvwm and twm.
+
+-ncache_pad n In -ncache mode, pad each window with n pixels for the
+ caching rectangles. This can be used to try to improve
+ the situation with dropshadows or other compositing
+ (e.g. MacOS X window manager), although it could make
+ things worse. The default is 0 on Unix and 24 on
+ MacOS X.
+
-wireframe [str] Try to detect window moves or resizes when a mouse
-nowireframe button is held down and show a wireframe instead of
the full opaque window. This is based completely on
diff --git a/x11vnc/x11vnc.1 b/x11vnc/x11vnc.1
index 0b17389..9fb2013 100644
--- a/x11vnc/x11vnc.1
+++ b/x11vnc/x11vnc.1
@@ -2,7 +2,7 @@
.TH X11VNC "1" "April 2007" "x11vnc " "User Commands"
.SH NAME
x11vnc - allow VNC connections to real X11 displays
- version: 0.9, lastmod: 2007-04-18
+ version: 0.9.1, lastmod: 2007-04-18
.SH SYNOPSIS
.B x11vnc
[OPTION]...
@@ -2544,6 +2544,115 @@ slow setups, but you lose all visual feedback for drags,
text selection, and some menu traversals. It overrides
any \fB-pointer_mode\fR setting.
.PP
+\fB-ncache\fR \fIn\fR
+.IP
+Client-side caching scheme. Framebuffer memory \fIn\fR
+(an integer) times that of the full display is allocated
+below the actual framebuffer to cache screen contents
+for rapid retrieval. So a W x H frambuffer is expanded
+to a W x (n+1)*H one. Use 0 to disable. Default: XXX.
+.IP
+For this and the other \fB-ncache*\fR options below you can
+abbreviate "\fB-ncache\fR" with "\fB-nc\fR". Also, "\fB-nonc\fR"
+is the same as "\fB-ncache\fR \fI0\fR"
+.IP
+This is an experimental option, currently implemented
+in an awkward way in that in the VNC Viewer you can
+see the cache contents if you scroll down, etc. So you
+will have to set things up so you can't see that region.
+If this method is successful, the changes required for
+clients to do this less awkwardly will be investigated.
+.IP
+Note that this mode consumes a huge amount of memory,
+both on the x11vnc server side and on the VNC Viewer
+side. If n=2 then the amount of RAM used is roughly
+tripled for both x11vnc and the VNC Viewer. As a rule
+of thumb, note that 1280x1024 at depth 24 is about 5MB
+of pixel data.
+.IP
+For reasonable response when cycling through 4 to 6
+large (e.g. web browser) windows a value n of 6 to 12
+is recommended. (that's right: ~10X more memory...)
+.IP
+Because of the way window backingstore and saveunders
+are implemented, n must be even. It will be incremented
+by 1 if it is not.
+.IP
+This mode also works for native MacOS X, but may not
+be as effective as the X version. This is due to a
+number of things, one is the drop-shadow compositing
+that leaves extra areas that need to be repaired (see
+\fB-ncache_pad).\fR Another is the window iconification
+animations need to be avoided (see \fB-macicontime).\fR
+It appears the that the 'Scale' animation mode gives
+better results than the 'Genie' one. Also, window event
+detection not as accurate as the X version.
+.PP
+\fB-ncache_cr\fR
+.IP
+In \fB-ncache\fR mode, try to do copyrect opaque window
+moves/drags instead of wireframes (this can induce
+painting errors). The wireframe will still be used when
+moving a window whose save-unders has not yet been set
+or has been invalidated.
+.IP
+Some VNC Viewers provide better response than others
+with this option. On Unix, realvnc viewer gives
+smoother drags than tightvnc viewer. Response may also
+be choppy if the server side machine is too slow.
+.IP
+Sometimes on very slow modem connections, this actually
+gives an improvement because no pixel data at all
+(not even the box animation) is sent during the drag.
+.PP
+\fB-ncache_no_moveraise\fR
+.IP
+In \fB-ncache\fR mode, do not assume that moving a window
+will cause the window manager to raise it to the top
+of the stack. The default is to assume it does, and
+so at the beginning of any wireframe, etc, window moves
+the window will be pushed to top in the VNC viewer.
+.PP
+\fB-ncache_no_dtchange\fR
+.IP
+In \fB-ncache\fR mode, do not try to guess when the desktop
+(viewport) changes to another one (i.e. another
+workarea). The default is to try to guess and when
+detected try to make the transistion more smoothly.
+.PP
+\fB-ncache_no_rootpixmap\fR
+.IP
+In \fB-ncache\fR mode, do not try to snapshot the desktop
+background to use in guessing or reconstructing window
+save-unders.
+.PP
+\fB-ncache_keep_anims\fR
+.IP
+In \fB-ncache\fR mode, do not try to disable window
+manager animations and other effects (that usually
+degrade ncache performance or cause painting errors).
+The default is to try to disable them on KDE (but not
+GNOME) when VNC clients are connected.
+.IP
+For other window managers or desktops that provide
+animations, effects, compositing, translucency,
+etc. that interfere with the \fB-ncache\fR method you will
+have to disable them manually.
+.PP
+\fB-ncache_old_wm\fR
+.IP
+In \fB-ncache\fR mode, enable some heuristics for old style
+window managers such as fvwm and twm.
+.PP
+\fB-ncache_pad\fR \fIn\fR
+.IP
+In \fB-ncache\fR mode, pad each window with n pixels for the
+caching rectangles. This can be used to try to improve
+the situation with dropshadows or other compositing
+(e.g. MacOS X window manager), although it could make
+things worse. The default is 0 on Unix and 24 on
+MacOS X.
+.PP
\fB-wireframe\fR \fI[str],\fR \fB-nowireframe\fR
.IP
Try to detect window moves or resizes when a mouse
diff --git a/x11vnc/x11vnc.h b/x11vnc/x11vnc.h
index 8fbe05e..8689a96 100644
--- a/x11vnc/x11vnc.h
+++ b/x11vnc/x11vnc.h
@@ -136,7 +136,7 @@
/* these are for delaying features: */
#define xxNO_SSL_OR_UNIXPW
-#define NO_NCACHE
+#define xxNO_NCACHE
/*
* Beginning of support for small binary footprint build for embedded
diff --git a/x11vnc/x11vnc_defs.c b/x11vnc/x11vnc_defs.c
index 98a2719..7b09821 100644
--- a/x11vnc/x11vnc_defs.c
+++ b/x11vnc/x11vnc_defs.c
@@ -15,7 +15,7 @@ int xtrap_base_event_type = 0;
int xdamage_base_event_type = 0;
/* date +'lastmod: %Y-%m-%d' */
-char lastmod[] = "0.9 lastmod: 2007-04-18";
+char lastmod[] = "0.9.1 lastmod: 2007-04-18";
/* X display info */