miext/rootless/README.txt

11         The generic rootless layer allows an X server to be implemented
14 coexist on the same screen. The layer is called "rootless" because the root
19 contains code that is useful for any rootless X server. The code for the
20 generic rootless layer is located in xc/programs/Xserver/miext/rootless. To
21 build a complete rootless X server requires a specific rootless
22 implementation, which provides functions that allow the generic rootless
28         In the context of a rootless X server the term window is used to
33 is referred to as a "frame". The generic rootless layer associates each
37         The generic rootless layer models each frame as being backed at
40 frames, this must be done by the rootless implementation. The generic
41 rootless layer model does not assume it always has access to the frames'
43 the rootless implementation's StartDrawing() function and StopDrawing()
49 generic rootless layer will stop Expose events being generated when the
60 generic rootless layer through rootless implementation functions, compile-
61 time options, and runtime parameters. The rootless implementation
62 functions are a list of functions that allow the generic rootless layer to
65 description of the rootless implementation functions is provided in
68         By design, a rootless implementation should only have to include
69 the rootless.h header file. The rootlessCommon.h file contains definitions
70 internal to the generic rootless layer. (If you find you need to use
71 rootlessCommon.h in your implementation, let the generic rootless layer
72 maintainers know. This could be an area where the generic rootless layer
73 should be generalized.) A rootless implementation should also modify
94         of the frame contents need to be preserved by the generic rootless
95         layer. If true, the generic rootless layer will pass gravity hints
99         The following runtime options are defined in rootless.h:
106         The minimum number of bytes or pixels for which to use the rootless
107         implementation's respective acceleration function. The rootless
114 	The rootless implementation typically does not have direct access
117 overlap well with the X11 drawing primitives. The generic rootless layer
118 falls back to using fb for all its 2-D drawing. Providing optional rootless
123 rootless implementation to provide hints for when the acceleration
131 will use these extra bits as an alpha channel. The generic rootless layer can
139 channel safe variants. These are provided in rootless/safeAlpha.
144 	The generic rootless layer was originally conceived and developed
148 reintroduced the generic abstractions and made the rootless code suitable
154 	The rootless implementation functions are defined in rootless.h. It
155 is intended that rootless.h contains the complete interface that is needed by
156 rootless implementations. The definitions contained in rootlessCommon.h
157 are intended for internal use by the generic rootless layer and are more
162 implementation's CreateFrame() function. The generic rootless layer does
163 not use this frame id other than to pass it back to the rootless