x11vnc: scrolling: grabserver, autorepeat throttling, mouse wheel, fix onetile

ChangeLog

+2005-05-24  Karl Runge <runge@karlrunge.com>
+	* x11vnc: scrollcopyrect: GrabServer detection, autorepeat throttling..
+	* prepare_x11vnc_dist.sh: grep out new libvncserver-config line.
+
 2005-05-23  Karl Runge <runge@karlrunge.com>
 	* configure.ac: malloc(0) is never used, so we don't need the check
 

prepare_x11vnc_dist.sh

@@ -7,6 +7,7 @@ cd "$(dirname "$0")"
 mv configure.ac configure.ac.LibVNCServer
 
 cat configure.ac.LibVNCServer | \
+egrep -v 'AC_CONFIG_COMMANDS.*libvncserver-config' | \
 sed -e "s/LibVNCServer, [^,)]*\([(,]\)*/x11vnc, $VERSION\1/g" \
     -e "s/\(contrib\|examples\|vncterm\|libvncclient\|test\|client_examples\)\/Makefile//g" \
     -e "s/LibVNCServer.spec/x11vnc.spec/g" \

x11vnc/ChangeLog

+2005-05-24  Karl Runge <runge@karlrunge.com>
+	* more -scrollcopyrect: GrabServer detection, autorepeat throttling,
+	  hack to clean screen 3,4,5 Alt_L in a row, mouse wheel detect.
+	* fix bug wrt switching to single_copytile, add Darwin to shm limit.
+
 2005-05-17  Karl Runge <runge@karlrunge.com>
 	* more -scrollcopyrect, -scr_term hacks for terminals.
 	* -wait_ui, -nowait_bog tunables.  push cursor sooner.

x11vnc/README

 
-x11vnc README file                         Date: Tue May 17 14:39:38 EDT 2005
+x11vnc README file                         Date: Tue May 24 23:49:07 EDT 2005
 
 The following information is taken from these URLs:
 
@@ -4238,7 +4238,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.7.2 lastmod: 2005-05-17
+x11vnc: allow VNC connections to real X11 displays. 0.7.2 lastmod: 2005-05-24
 
 x11vnc options:
   -display disp            -auth file             
@@ -4289,7 +4289,8 @@ x11vnc options:
   -noscrollcopyrect        -scr_area n            
   -scr_skip list           -scr_inc list          
   -scr_keys list           -scr_term list         
-  -scr_parms string        -debug_scroll          
+  -scr_keyrepeat lo-hi     -scr_parms string      
+  -debug_scroll            -noxrecord             
   -pointer_mode n          -input_skip n          
   -speeds rd,bw,lat        -debug_pointer         
   -debug_keyboard          -defer time            
@@ -4335,7 +4336,7 @@ libvncserver options:
 
 % x11vnc -help
 
-x11vnc: allow VNC connections to real X11 displays. 0.7.2 lastmod: 2005-05-17
+x11vnc: allow VNC connections to real X11 displays. 0.7.2 lastmod: 2005-05-24
 
 Typical usage is:
 
@@ -4357,8 +4358,12 @@ the name of the machine running x11vnc and N is XXXX - 5900, i.e. usually
 
 By default x11vnc will not allow the screen to be shared and it will exit
 as soon as the client disconnects.  See -shared and -forever below to override
-these protections.  See the FAQ on how to tunnel the VNC connection through
-an encrypted channel such as ssh(1).
+these protections.  See the FAQ for details how to tunnel the VNC connection
+through an encrypted channel such as ssh(1).  In brief:
+
+       ssh -L 5900:localhost:5900 far-host 'x11vnc -localhost -display :0'
+
+       vncviewer -encodings 'copyrect tight zrle hextile' localhost:0
 
 For additional info see: http://www.karlrunge.com/x11vnc/
                     and  http://www.karlrunge.com/x11vnc/#faq
@@ -5215,7 +5220,7 @@ Options:
                        to Keystroke generated scrolls (e.g. Up arrow).  If it
                        is prefixed with "MOUSE:" it only applies to Mouse
                        induced scrolls (e.g. dragging on a scrollbar).
-                       Default: ##Soffice.bin
+                       Default: ##Soffice.bin,##StarOffice
 
 -scr_inc list          Opposite of -scr_skip: this list is consulted first
                        and if there is a match the window will be monitored
@@ -5246,14 +5251,14 @@ Options:
                        never induce scrolling by themselves.
 
 -scr_term list         Yet another cosmetic kludge.  Apply shell/terminal
-                       heuristics to applications matching comma separated list
-                       (same as -scr_skip/-scr_inc).  For example an annoying
-                       transient under scroll detection is if you hit Enter in
-                       a terminal shell with full text window, the solid text
-                       cursor block will be scrolled up.  So for a short time
-                       there are two (or more) block cursors on the screen.
-                       There are similar scenarios, (e.g. an output line is
-                       duplicated).
+                       heuristics to applications matching comma separated
+                       list (same as for -scr_skip/-scr_inc).  For example an
+                       annoying transient under scroll detection is if you
+                       hit Enter in a terminal shell with full text window,
+                       the solid text cursor block will be scrolled up.
+                       So for a short time there are two (or more) block
+                       cursors on the screen.  There are similar scenarios,
+                       (e.g. an output line is duplicated).
 
                        These transients are induced by the approximation of
                        scroll detection (e.g. it detects the scroll, but not
@@ -5268,6 +5273,19 @@ Options:
                        the annoying artifacts.  Use "none" to disable.
                        Default: "term"
 
+-scr_keyrepeat lo-hi   If a key is held down (or otherwise repeats rapidly) and
+                       this induces a rapid sequence of scrolls (e.g. holding
+                       down an Arrow key) the "scrollcopyrect" detection
+                       and overhead may not be able to keep up.  A time per
+                       single scroll estimate is performed and if that estimate
+                       predicts a sustainable scrollrate of keys per second
+                       between "lo" and "hi" then repeated keys will be
+                       DISCARDED to maintain the scrollrate. For example your
+                       key autorepeat may be 25 keys/sec, but for a large
+                       window or slow link only 8 scrolls per second can be
+                       sustained, then roughly 2 out of every 3 repeated keys
+                       will be discarded during this period. Default: "4-20"
+
 -scr_parms string      Set various parameters for the scrollcopyrect mode.
                        The format is similar to that for -wireframe and packed
                        with lots of parameters:
@@ -5314,6 +5332,10 @@ Options:
                        heuristics.  "-ds" is an alias.  Specify it multiple
                        times for more output.
 
+-noxrecord             Disable any use of the RECORD extension.  This is
+                       currently used by the -scrollcopyrect scheme and to
+                       monitor X server grabs.
+
 -pointer_mode n        Various pointer motion update schemes. "-pm" is
                        an alias.  The problem is pointer motion can cause
                        rapid changes on the screen: consider the rapid changes
@@ -5529,8 +5551,8 @@ Options:
                        usage should be very rare, i.e. doing something strange
                        with /dev/fb0.
 
--pipeinput cmd         Another experimental option: it lets you supply
-                       an extern command in "cmd" that x11vnc will pipe
+-pipeinput cmd         Another experimental option: it lets you supply an
+                       external command in "cmd" that x11vnc will pipe
                        all of the user input events to in a simple format.
                        In -pipeinput mode by default x11vnc will not process
                        any of the user input events.  If you prefix "cmd"
@@ -5789,7 +5811,10 @@ Options:
                        scr_inc:list    set -scr_inc to "list"
                        scr_keys:list   set -scr_keys to "list"
                        scr_term:list   set -scr_term to "list"
+                       scr_keyrepeat:str set -scr_keyrepeat to "str"
                        scr_parms:str   set -scr_parms parameters.
+                       noxrecord       disable all use of RECORD extension.
+                       xrecord         enable  use of RECORD extension.
                        pointer_mode:n  set -pointer_mode to n. same as "pm"
                        input_skip:n    set -input_skip to n.
                        speeds:str      set -speeds to str.
@@ -5905,14 +5930,15 @@ Options:
                        noclear_mods clear_keys noclear_keys remap repeat
                        norepeat fb nofb bell nobell sel nosel primary noprimary
                        cursorshape nocursorshape cursorpos nocursorpos cursor
-                       show_cursor noshow_cursor nocursor arrow xfixes noxfixes
-                       xdamage noxdamage xd_area xd_mem alphacut alphafrac
-                       alpharemove noalpharemove alphablend noalphablend
-                       xwarppointer xwarp noxwarppointer noxwarp buttonmap
-                       dragging nodragging wireframe_mode wireframe wf
-                       nowireframe nowf wirecopyrect wcr nowirecopyrect nowcr
-                       scr_area scr_skip scr_inc scr_keys scr_term scr_parms
-                       scrollcopyrect scr noscrollcopyrect noscr pointer_mode
+                       show_cursor noshow_cursor nocursor arrow xfixes
+                       noxfixes xdamage noxdamage xd_area xd_mem alphacut
+                       alphafrac alpharemove noalpharemove alphablend
+                       noalphablend xwarppointer xwarp noxwarppointer
+                       noxwarp buttonmap dragging nodragging wireframe_mode
+                       wireframe wf nowireframe nowf wirecopyrect wcr
+                       nowirecopyrect nowcr scr_area scr_skip scr_inc scr_keys
+                       scr_term scr_keyrepeat scr_parms scrollcopyrect scr
+                       noscrollcopyrect noscr noxrecord xrecord pointer_mode
                        pm input_skip input client_input speeds debug_pointer dp
                        nodebug_pointer nodp debug_keyboard dk nodebug_keyboard
                        nodk deferupdate defer wait_ui wait_bog nowait_bog wait

x11vnc/tkx11vnc

@@ -172,6 +172,7 @@ Misc
 	nolookup
 	--
 	xtrap
+	xrecord
 	--
 	bg
 	=-C:ignore,exit sigpipe:
@@ -266,6 +267,7 @@ Tuning
 	scr_inc:
 	scr_keys:
 	scr_term:
+	scr_keyrepeat:
 	scr_parms:
 	-- D
 	speeds:

x11vnc/tkx11vnc.h

@@ -178,6 +178,7 @@
 "	nolookup\n"
 "	--\n"
 "	xtrap\n"
+"	xrecord\n"
 "	--\n"
 "	bg\n"
 "	=-C:ignore,exit sigpipe:\n"
@@ -272,6 +273,7 @@
 "	scr_inc:\n"
 "	scr_keys:\n"
 "	scr_term:\n"
+"	scr_keyrepeat:\n"
 "	scr_parms:\n"
 "	-- D\n"
 "	speeds:\n"

x11vnc/x11vnc.1

@@ -2,7 +2,7 @@
 .TH X11VNC "1" "May 2005" "x11vnc " "User Commands"
 .SH NAME
 x11vnc - allow VNC connections to real X11 displays
-         version: 0.7.2, lastmod: 2005-05-17
+         version: 0.7.2, lastmod: 2005-05-24
 .SH SYNOPSIS
 .B x11vnc
 [OPTION]...
@@ -28,9 +28,14 @@ the name of the machine running x11vnc and N is XXXX - 5900, i.e. usually
 .PP
 By default x11vnc will not allow the screen to be shared and it will exit
 as soon as the client disconnects.  See \fB-shared\fR and \fB-forever\fR below to override
-these protections.  See the FAQ on how to tunnel the VNC connection through
-an encrypted channel such as 
+these protections.  See the FAQ for details how to tunnel the VNC connection
+through an encrypted channel such as 
 .IR ssh (1).
+In brief:
+.IP
+ssh -L 5900:localhost:5900 far-host 'x11vnc -localhost -display :0'
+.IP
+vncviewer -encodings 'copyrect tight zrle hextile' localhost:0
 .PP
 For additional info see: http://www.karlrunge.com/x11vnc/
 and  http://www.karlrunge.com/x11vnc/#faq
@@ -1152,7 +1157,7 @@ If a pattern is prefixed with "KEY:" it only applies
 to Keystroke generated scrolls (e.g. Up arrow).  If it
 is prefixed with "MOUSE:" it only applies to Mouse
 induced scrolls (e.g. dragging on a scrollbar).
-Default: ##Soffice.bin
+Default: ##Soffice.bin,##StarOffice
 .PP
 \fB-scr_inc\fR \fIlist\fR
 .IP
@@ -1212,6 +1217,21 @@ from the actual X framebuffer.  This usually reduces
 the annoying artifacts.  Use "none" to disable.
 Default: "term"
 .PP
+\fB-scr_keyrepeat\fR \fIlo-hi\fR
+.IP
+If a key is held down (or otherwise repeats rapidly) and
+this induces a rapid sequence of scrolls (e.g. holding
+down an Arrow key) the "scrollcopyrect" detection
+and overhead may not be able to keep up.  A time per
+single scroll estimate is performed and if that estimate
+predicts a sustainable scrollrate of keys per second
+between "lo" and "hi" then repeated keys will be
+DISCARDED to maintain the scrollrate. For example your
+key autorepeat may be 25 keys/sec, but for a large
+window or slow link only 8 scrolls per second can be
+sustained, then roughly 2 out of every 3 repeated keys
+will be discarded during this period. Default: "4-20"
+.PP
 \fB-scr_parms\fR \fIstring\fR
 .IP
 Set various parameters for the scrollcopyrect mode.
@@ -1262,6 +1282,12 @@ Turn on debugging info printout for the scroll
 heuristics.  "\fB-ds\fR" is an alias.  Specify it multiple
 times for more output.
 .PP
+\fB-noxrecord\fR
+.IP
+Disable any use of the RECORD extension.  This is
+currently used by the \fB-scrollcopyrect\fR scheme and to
+monitor X server grabs.
+.PP
 \fB-pointer_mode\fR \fIn\fR
 .IP
 Various pointer motion update schemes. "\fB-pm\fR" is
@@ -1942,8 +1968,14 @@ scr_keys:list   set \fB-scr_keys\fR to "list"
 .IP
 scr_term:list   set \fB-scr_term\fR to "list"
 .IP
+scr_keyrepeat:str set \fB-scr_keyrepeat\fR to "str"
+.IP
 scr_parms:str   set \fB-scr_parms\fR parameters.
 .IP
+noxrecord       disable all use of RECORD extension.
+.IP
+xrecord         enable  use of RECORD extension.
+.IP
 pointer_mode:n  set \fB-pointer_mode\fR to n. same as "pm"
 .IP
 input_skip:n    set \fB-input_skip\fR to n.
@@ -2128,14 +2160,15 @@ noskip_dups add_keysyms noadd_keysyms clear_mods
 noclear_mods clear_keys noclear_keys remap repeat
 norepeat fb nofb bell nobell sel nosel primary noprimary
 cursorshape nocursorshape cursorpos nocursorpos cursor
-show_cursor noshow_cursor nocursor arrow xfixes noxfixes
-xdamage noxdamage xd_area xd_mem alphacut alphafrac
-alpharemove noalpharemove alphablend noalphablend
-xwarppointer xwarp noxwarppointer noxwarp buttonmap
-dragging nodragging wireframe_mode wireframe wf
-nowireframe nowf wirecopyrect wcr nowirecopyrect nowcr
-scr_area scr_skip scr_inc scr_keys scr_term scr_parms
-scrollcopyrect scr noscrollcopyrect noscr pointer_mode
+show_cursor noshow_cursor nocursor arrow xfixes
+noxfixes xdamage noxdamage xd_area xd_mem alphacut
+alphafrac alpharemove noalpharemove alphablend
+noalphablend xwarppointer xwarp noxwarppointer
+noxwarp buttonmap dragging nodragging wireframe_mode
+wireframe wf nowireframe nowf wirecopyrect wcr
+nowirecopyrect nowcr scr_area scr_skip scr_inc scr_keys
+scr_term scr_keyrepeat scr_parms scrollcopyrect scr
+noscrollcopyrect noscr noxrecord xrecord pointer_mode
 pm input_skip input client_input speeds debug_pointer dp
 nodebug_pointer nodp debug_keyboard dk nodebug_keyboard
 nodk deferupdate defer wait_ui wait_bog nowait_bog wait