← Back to branch summary

~ubuntu-branches/ubuntu/intrepid/xserver-xgl/intrepid

« back to all changes in this revision

Viewing changes to hw/kdrive/ephyr/README

  • Committer: Bazaar Package Importer
  • Author(s): Matthew Garrett
  • Date: 2006-02-13 14:21:43 UTC
  • Revision ID: james.westby@ubuntu.com-20060213142143-mad6z9xzem7hzxz9
Tags: upstream-7.0.0
Import upstream version 7.0.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
hw/kdrive/ephyr/README
 
1
Xephyr README
 
2
=============
 
3
 
 
4
 
 
5
What Is It ?
 
6
============
 
7
 
 
8
Xephyr is a a kdrive server that outputs to a window on a pre-existing
 
9
'host' X display. Think Xnest but with support for modern extensions
 
10
like composite, damage and randr. 
 
11
 
 
12
Unlike Xnest which is an X proxy, i.e.  limited to the
 
13
capabilities of the host X server, Xephyr is a real X server which
 
14
uses the host X server window as "framebuffer" via fast SHM XImages.
 
15
 
 
16
It also has support for 'visually' debugging what the server is
 
17
painting.
 
18
 
 
19
 
 
20
How To Use 
 
21
==========
 
22
 
 
23
You probably want to run like;
 
24
 
 
25
Xephyr :1 -ac -screen 800x600 &
 
26
 
 
27
Then set DISPLAY=:1 and run whatever X apps you like.
 
28
 
 
29
Use 'xrandr' to change to orientation/size. 
 
30
 
 
31
There is a '-parent' switch which works just like Xnests ( for use
 
32
with things like matchbox-nest - http://matchbox.handhelds.org ).
 
33
 
 
34
There is also a '-host-cursor' switch to set 'cursor acceleration' -
 
35
The host's cursor is reused. This is only really there to aid
 
36
debugging by avoiding server paints for the cursor. Performance
 
37
improvement is negiable. 
 
38
 
 
39
Send a SIGUSR1 to the server ( eg kill -USR1 `pidof Xephyr` ) to
 
40
toggle the debugging mode. In this mode red rectangles are painted to
 
41
screen areas getting painted before painting the actual content. The
 
42
delay between this can be altered by setting a XEPHYR_PAUSE env var to
 
43
a value in micro seconds.
 
44
 
 
45
 
 
46
Caveats
 
47
=======
 
48
 
 
49
 - Depth is limited to being the same as the host. 
 
50
   *Update* As of 8/11/2004. Xephyr can now do 8bpp & 16bpp 
 
51
            on 24bpp host.
 
52
 
 
53
 - Rotated displays are currently updated via full blits. This
 
54
   is slower than a normal oprientated display. Debug mode will
 
55
   therefor not be of much use rotated.  
 
56
 
 
57
 - The '-host-cursor' cursor is static in its appearence. 
 
58
 
 
59
 - The build gets a warning about 'nanosleep'. I think the various '-D'
 
60
   build flags are causing this. I havn't figured as yet how to work
 
61
   round it. It doesn't appear to break anything however. 
 
62
 
 
63
 - Keyboard handling is basic but works. 
 
64
 
 
65
 - Mouse button 5 probably wont work. 
 
66
 
 
67
 
 
68
 
 
69
 
 
70
 
 
71
Matthew Allum <mallum@o-hand.com> 2004 
 
72
 
 
73