summaryrefslogtreecommitdiffstats
path: root/x11vnc/README
diff options
context:
space:
mode:
Diffstat (limited to 'x11vnc/README')
-rw-r--r--x11vnc/README103
1 files changed, 55 insertions, 48 deletions
diff --git a/x11vnc/README b/x11vnc/README
index d01b255..1e97c14 100644
--- a/x11vnc/README
+++ b/x11vnc/README
@@ -1,5 +1,5 @@
-x11vnc README file Date: Wed Jan 18 22:06:12 EST 2006
+x11vnc README file Date: Sat Jan 21 20:25:28 EST 2006
The following information is taken from these URLs:
@@ -4898,7 +4898,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.8 lastmod: 2006-01-18
+x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-21
x11vnc options:
-display disp -auth file
@@ -4906,7 +4906,7 @@ x11vnc options:
-clip WxH+X+Y -flashcmap
-shiftcmap n -notruecolor
-visual n -overlay
- -overlay_nocursor -8to24
+ -overlay_nocursor -8to24 [opts]
-scale fraction -scale_cursor frac
-viewonly -shared
-once -forever
@@ -5009,7 +5009,7 @@ libvncserver-tight-extension options:
% x11vnc -help
-x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-18
+x11vnc: allow VNC connections to real X11 displays. 0.8 lastmod: 2006-01-21
Typical usage is:
@@ -5140,25 +5140,24 @@ Options:
-overlay_nocursor Sets -overlay, but does not try to draw the exact mouse
cursor shape using the overlay mechanism.
--8to24 If -overlay is not supported on your OS, and you have a
- legacy 8bpp app that you want to view on a multi-depth
- display with default depth 24 (and is 32 bpp), try
- this option. It will also work for a default depth 8
- display with depth 24 overlay windows. This option
+-8to24 [opts] Try this option if -overlay is not supported on your
+ OS, and you have a legacy 8bpp app that you want to
+ view on a multi-depth display with default depth 24
+ (and is 32 bpp) or have default depth 8 display with
+ depth 24 overlay windows for some apps. This option
may not work on all X servers and hardware (tested on
- XFree86/Xorg mga driver).
-
- It enables a hack where x11vnc monitors windows within 3
- levels from the root window. If it finds any that are
- 8bpp it will apply a transformation for pixel data in
- these regions where it extracts the 8bpp index color
- value from bits 25-32 and maps them on to TrueColor
- values and inserts them into bits 1-24 (i.e. overwrites
- bits 1-24).
-
- For default depth 8 displays, everything is tranformed
- to 32bpp (and is potentially a improvement over
- -flashcmap).
+ XFree86/Xorg mga driver). The "opts" string is not
+ required and is described below.
+
+ This mode enables a hack where x11vnc monitors windows
+ within 3 levels from the root window. If it finds
+ any that are 8bpp it will apply a transformation for
+ pixel data in these regions where it extracts the 8bpp
+ index color value from bits 25-32 and maps them on
+ to TrueColor values and inserts them into bits 1-24
+ (i.e. overwrites bits 1-24). Whereas for default
+ depth 8 displays, everything is tranformed to 32bpp
+ (and is potentially a improvement over -flashcmap).
These schemes appear to work, but may still have
bugs and note that they do hog resources. If there
@@ -5175,17 +5174,24 @@ Options:
to periodically refresh the screen (at the cost of
bandwidth).
- Debugging for this mode can be enabled by setting the
- environment variable DEBUG_8TO24 to 1, 2, or 3.
+ The [opts] string can contain the following settings.
+ Multiple settings are separated by commas.
+
+ For when there are still color problems, enable an even
+ more experimental mode via the option "getimage".
+ This enables a scheme were XGetImage() is used to
+ retrieve the 8bpp data instead of assuming that data
+ is in bits 25-32. This mode is significantly slower
+ than the above mode. For the default depth 8 case,
+ XGetImage() is always used to access depth 24 pixel
+ data.
+
+ For default depth 8 displays, setting option
+ "highbits" may give a speedup for transforming 8bpp
+ pixel data.
- If there are problems, to enable an even more
- experimental mode, set the environment variable
- XGETIMAGE_8TO24=1 before starting x11vnc. This enables
- a scheme were XGetImage() is used to retrieve the 8bpp
- data instead of assuming that data is in bits 25-32.
- This mode is significantly slower than the above mode.
- For the default depth 8 case, XGetImage() is always
- used to access depth 24 pixel data.
+ Debugging for this mode can be enabled by setting
+ "dbg=1", "dbg=2", or "dbg=3"
-scale fraction Scale the framebuffer by factor "fraction". Values
less than 1 shrink the fb, larger ones expand it. Note:
@@ -6623,6 +6629,7 @@ n
nooverlay_cursor.
8to24 enable -8to24 mode (if applicable).
no8to24 disable -8to24 mode.
+ 8to24_opts:str set the -8to24 opts to "str".
visual:vis set -visual to "vis"
scale:frac set -scale to "frac"
scale_cursor:f set -scale_cursor to "f"
@@ -6877,22 +6884,22 @@ n
truecolor notruecolor overlay nooverlay overlay_cursor
overlay_yescursor nooverlay_nocursor nooverlay_cursor
nooverlay_yescursor overlay_nocursor 8to24 no8to24
- visual scale scale_cursor viewonly noviewonly shared
- noshared forever noforever once timeout filexfer deny
- lock nodeny unlock connect allowonce allow localhost
- nolocalhost listen lookup nolookup accept afteraccept
- gone shm noshm flipbyteorder noflipbyteorder onetile
- noonetile solid_color solid nosolid blackout xinerama
- noxinerama xtrap noxtrap xrandr noxrandr xrandr_mode
- padgeom quiet q noquiet modtweak nomodtweak xkb
- noxkb skip_keycodes sloppy_keys nosloppy_keys
- skip_dups 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 seldir cursorshape nocursorshape
- cursorpos nocursorpos cursor show_cursor noshow_cursor
- nocursor arrow xfixes noxfixes xdamage noxdamage
- xd_area xd_mem alphacut alphafrac alpharemove
+ 8to24_opts visual scale scale_cursor viewonly
+ noviewonly shared noshared forever noforever once
+ timeout filexfer deny lock nodeny unlock connect
+ allowonce allow localhost nolocalhost listen lookup
+ nolookup accept afteraccept gone shm noshm flipbyteorder
+ noflipbyteorder onetile noonetile solid_color solid
+ nosolid blackout xinerama noxinerama xtrap noxtrap
+ xrandr noxrandr xrandr_mode padgeom quiet q noquiet
+ modtweak nomodtweak xkb noxkb skip_keycodes sloppy_keys
+ nosloppy_keys skip_dups 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 seldir 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