xserver-multidpi/hw/kdrive/ephyr
Keith Packard 82f91433e2 glamor: Get testing code using small FBOs working again
Glamor has a mode where pixmaps will be constructed from numerous
small FBOs. This allows testing of the tiled pixmap code without
needing to create huge pixmaps.

However, the render glyph code assumed that it could create a pixmap
large enough for the glyph atlas. Instead of attempting to fix that
(which would be disruptive and not helpful), I've added a new pixmap
creation usage, GLAMOR_CREATE_NO_LARGE which forces allocation of a
single large FBO.

Now that we have pixmaps with varying FBO sizes, I then went around
and fixed the few places using the global FBO max size and replaced
that with the per-pixmap FBO tiling sizes, which were already present
in each large pixmap.

Xephyr has been changed to pass GLAMOR_CREATE_NO_LARGE when it creates
the screen pixmap as it doesn't want to deal with tiling either.

Signed-off-by: Keith Packard <keithp@keithp.com>
Signed-off-by: Eric Anholt <eric@anholt.net>
Reviewed-by: Eric Anholt <eric@anholt.net>
2014-03-26 12:58:40 -07:00
..
man ephyr: add -resizeable to the man page 2013-05-15 09:36:00 +10:00
.gitignore Xephyr: build Xephyr man pages using XORG_MANPAGE_SECTIONS 2011-01-18 15:10:29 -08:00
ephyr_draw.c Introduce a consistent coding style 2012-03-21 13:54:42 -07:00
ephyr_glamor_glx.c glx: Make sure we get an FBConfig the root window's visual. 2014-03-17 14:30:58 -07:00
ephyr_glamor_glx.h xephyr: Don't forget to glViewport() before drawing the screen. 2014-03-17 14:30:28 -07:00
ephyr.c xephyr: Pass incoming XCB events to the Xlib event filter. 2014-03-05 13:10:15 -08:00
ephyr.h xephyr: Build support for rendering with glamor using a -glamor option. 2014-03-05 13:10:12 -08:00
ephyrdri.c Xephyr: move ephyrdri over to xcb 2013-09-03 11:01:00 -07:00
ephyrdri.h ephyr: Fix warning about XID vs unsigned long * by changing function args 2013-08-21 09:10:49 -07:00
ephyrdriext.c kdrive/ephyr: Remove extra 'i' variable in ProcXF86DRIGetDrawableInfo 2014-01-22 19:56:32 -08:00
ephyrdriext.h Introduce a consistent coding style 2012-03-21 13:54:42 -07:00
ephyrglxext.c ephyr: Expose a single function for detecting extensions. 2013-09-03 14:34:41 -07:00
ephyrglxext.h Introduce a consistent coding style 2012-03-21 13:54:42 -07:00
ephyrhostglx.c Xephyr: we're not using Xlib anymore, no need to undef _XSERVER64 2013-09-03 11:02:03 -07:00
ephyrhostglx.h Xephyr: move glx code to xcb 2013-09-03 11:01:40 -07:00
ephyrinit.c miinitext: introduce LoadExtensionList() to replace over LoadExtension() 2014-03-25 16:00:17 -07:00
ephyrlog.h Introduce a consistent coding style 2012-03-21 13:54:42 -07:00
ephyrvideo.c Replace 'pointer' type with 'void *' 2014-01-12 10:24:11 -08:00
hostx.c glamor: Get testing code using small FBOs working again 2014-03-26 12:58:40 -07:00
hostx.h ephyr: Use host (HW) cursors by default. 2013-09-03 14:35:38 -07:00
Makefile.am ephyr: typo where "()" should be "$()" in the Makefile - breaks make dist 2014-03-26 12:58:39 -07:00
os.c kdrive: Fix const cast warnings in arguments processing. 2013-08-21 09:10:46 -07:00
README Xephyr grab fix 2004-11-11 14:55:30 +00:00

Xephyr README
=============


What Is It ?
============

Xephyr is a a kdrive server that outputs to a window on a pre-existing
'host' X display. Think Xnest but with support for modern extensions
like composite, damage and randr. 

Unlike Xnest which is an X proxy, i.e.  limited to the
capabilities of the host X server, Xephyr is a real X server which
uses the host X server window as "framebuffer" via fast SHM XImages.

It also has support for 'visually' debugging what the server is
painting.


How To Use 
==========

You probably want to run like;

Xephyr :1 -ac -screen 800x600 &

Then set DISPLAY=:1 and run whatever X apps you like.

Use 'xrandr' to change to orientation/size. 

There is a '-parent' switch which works just like Xnests ( for use
with things like matchbox-nest - http://matchbox.handhelds.org ).

There is also a '-host-cursor' switch to set 'cursor acceleration' -
The host's cursor is reused. This is only really there to aid
debugging by avoiding server paints for the cursor. Performance
improvement is negiable. 

Send a SIGUSR1 to the server ( eg kill -USR1 `pidof Xephyr` ) to
toggle the debugging mode. In this mode red rectangles are painted to
screen areas getting painted before painting the actual content. The
delay between this can be altered by setting a XEPHYR_PAUSE env var to
a value in micro seconds.


Caveats
=======

 - Depth is limited to being the same as the host. 
   *Update* As of 8/11/2004. Xephyr can now do 8bpp & 16bpp 
            on 24bpp host.

 - Rotated displays are currently updated via full blits. This
   is slower than a normal oprientated display. Debug mode will
   therefor not be of much use rotated.  

 - The '-host-cursor' cursor is static in its appearence. 

 - The build gets a warning about 'nanosleep'. I think the various '-D'
   build flags are causing this. I havn't figured as yet how to work
   round it. It doesn't appear to break anything however. 

 - Keyboard handling is basic but works. 

 - Mouse button 5 probably wont work. 





Matthew Allum <mallum@o-hand.com> 2004