miext/rootless/README.txt

15 window of the X server is generally not drawn. Instead, each top-level
16 child of the root window is represented as a separate on-screen window by
22 implementation, which provides functions that allow the generic rootless
31 screen. A top-level window is a direct child of the root window. To avoid
32 confusion, an on-screen native window of the underlying window system
34 mapped top-level X11 window with a frame. An X11 window may be said
35 to be "framed" if it or its top-level parent is represented by a frame.
40 frames, this must be done by the rootless implementation. The generic
43 the rootless implementation's StartDrawing() function and StopDrawing()
57 Rootless Implementation
60 generic rootless layer through rootless implementation functions, compile-
61 time options, and runtime parameters. The rootless implementation
64 frames. Some of the implementation functions are optional. A detailed
65 description of the rootless implementation functions is provided in
68         By design, a rootless implementation should only have to include
71 rootlessCommon.h in your implementation, let the generic rootless layer
73 should be generalized.) A rootless implementation should also modify
76         The following compile-time options are defined in
83         containing the alpha channel are defined by the macro
99         The following runtime options are defined in rootless.h:
103         screen-local to global coordinates.
107         implementation's respective acceleration function. The rootless
114 	The rootless implementation typically does not have direct access
118 falls back to using fb for all its 2-D drawing. Providing optional rootless
119 implementation acceleration functions can accelerate some graphics
123 rootless implementation to provide hints for when the acceleration
152 Appendix A: Rootless Implementation Functions
154 	The rootless implementation functions are defined in rootless.h. It
162 implementation's CreateFrame() function. The generic rootless layer does
164 implementation to indicate the frame to operate on.
171  *              initialized before calling except for pFrame->wid, which
175  *  pNewShape   Shape for the frame (in frame-local coordinates). NULL for
235  *  pNewShape   New shape for the frame (in frame-local coordinates)
276  *  pDamage     Region containing all the changed pixels in frame-local
287  *  rects       Array of damaged rectangles in frame-local coordinates
298  *  use the new top-level parent. If defined this function will be called
299  *  afterwards for implementation specific bookkeeping.