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

1 files changed, 51 insertions, 25 deletions

diff --git a/x11vnc/README b/x11vnc/README
index 822c343..8b9f1c1 100644
--- a/x11vnc/README
+++ b/x11vnc/README
@@ -1,5 +1,5 @@
 
-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