[PATCH] Atomic query requests
Adam Jackson
ajax at redhat.com
Mon Mar 15 09:06:15 PDT 2010
Signed-off-by: Adam Jackson <ajax at redhat.com>
---
fixesproto.txt | 57 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
xfixesproto.h | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++++
xfixeswire.h | 7 ++++-
3 files changed, 113 insertions(+), 5 deletions(-)
diff --git a/fixesproto.txt b/fixesproto.txt
index 5ef8153..9d0547f 100644
--- a/fixesproto.txt
+++ b/fixesproto.txt
@@ -1,7 +1,7 @@
The XFIXES Extension
- Version 4.0
- Document Revision 2
- 2006-12-14
+ Version 5.0
+ Document Revision 1
+ 2010-03-15
Keith Packard
keithp at keithp.com
@@ -160,6 +160,7 @@ current cursor and provides a way to identify cursor images to avoid
refetching the image each time it changes to a previously seen cursor.
7.1 Types
+
CURSOREVENT { DisplayCursor }
7.2 Events
@@ -566,6 +567,56 @@ ShowCursor
Servers supporting the X Input Extension Version 2.0 or higher show
all visible cursors in response to a ShowCursor request.
+************* XFIXES VERSION 5 OR BETTER ***********
+
+12. Atomic queries
+
+Some core protocol requests return information about only a few windows,
+when the application often wants information about the hierarchy all the
+way to the root. In order to get consistent information this has to be
+done under a server grab, which is impolite when the client is remote.
+
+12.1 Types
+
+ POINTERWINDOW { Window w,
+ CARD16 x,
+ CARD16 y }
+
+12.2 Requests
+
+QueryPointer
+
+ ->
+
+ mask: SETofKEYBUTMASK
+ pointer_windows: LISTofPOINTERWINOW
+
+ This request returns the list of windows that contain the cursor,
+ from leafmost to rootmost, and the cursor's offset within each.
+ It also returns the current button mask for the pointer.
+
+ Unlike the core QueryPointer request, this does not take a root
+ window argument a priori; the client simply receives the cursor
+ state for whichever root window the cursor happens to be on. If
+ the cursor is on no screen (for example, in a dead area between
+ screens, or owned by a native window system) a zero-sized list
+ is returned.
+
+QueryAncestors
+
+ window: WINDOW
+
+ ->
+
+ windows: LISTofWINDOW
+
+ This request returns the list of ancestors of the named window,
+ from nearest to rootmost. If the named window is a root window,
+ a zero-sized list is returned.
+
+ If the window argument does not name a defined window, BadWindow
+ is generated.
+
99. Future compatibility
This extension is not expected to remain fixed. Future changes will
diff --git a/xfixesproto.h b/xfixesproto.h
index 545e325..9b745bb 100644
--- a/xfixesproto.h
+++ b/xfixesproto.h
@@ -500,6 +500,60 @@ typedef struct {
#define sz_xXFixesShowCursorReq sizeof(xXFixesShowCursorReq)
+typedef struct {
+ CARD8 reqType;
+ CARD8 xfixesReqType;
+ CARD16 length B16;
+} xXFixesQueryPointerReq;
+
+#define sz_xXFixesQueryPointerReq sizeof(xXFixesQueryPointerReq)
+
+typedef struct {
+ Window window B32;
+ CARD16 x B16;
+ CARD16 y B16;
+} xXFixesPointerWindow;
+
+typedef struct {
+ BYTE type; /* X_Reply */
+ BYTE pad1;
+ CARD16 sequenceNumber B16;
+ CARD32 length B32;
+ CARD16 mask B16;
+ CARD16 pad2 B16;
+ CARD32 numWindows B32;
+ CARD32 pad3 B32;
+ CARD32 pad4 B32;
+ CARD32 pad5 B32;
+ CARD32 pad6 B32;
+} xXFixesQueryPointerReply;
+
+#define sz_xXFixesQueryPointerReply 32
+
+typedef struct {
+ CARD8 reqType;
+ CARD8 xfixesReqType;
+ CARD16 length B16;
+ Window window B32;
+} xXFixesQueryAncestorsReq;
+
+#define sz_xXFixesQueryAncestorsReq sizeof(xXFixesQueryAncestorsReq)
+
+typedef struct {
+ BYTE type; /* X_Reply */
+ BYTE pad1;
+ CARD16 sequenceNumber B16;
+ CARD32 length B32;
+ CARD32 numWindows B32;
+ CARD32 pad3 B32;
+ CARD32 pad4 B32;
+ CARD32 pad5 B32;
+ CARD32 pad6 B32;
+ CARD32 pad7 B32;
+} xXFixesQueryAncestorsReply;
+
+#define sz_xXFixesQueryAncestorsReply 32
+
#undef Region
#undef Picture
#undef Window
diff --git a/xfixeswire.h b/xfixeswire.h
index 6f20270..70ba4c5 100644
--- a/xfixeswire.h
+++ b/xfixeswire.h
@@ -47,7 +47,7 @@
#define _XFIXESWIRE_H_
#define XFIXES_NAME "XFIXES"
-#define XFIXES_MAJOR 4
+#define XFIXES_MAJOR 5
#define XFIXES_MINOR 0
/*************** Version 1 ******************/
@@ -85,8 +85,11 @@
/*************** Version 4 ******************/
#define X_XFixesHideCursor 29
#define X_XFixesShowCursor 30
+/*************** Version 5 ******************/
+#define X_XFixesQueryPointer 31
+#define X_XFixesQueryAncestors 32
-#define XFixesNumberRequests (X_XFixesShowCursor+1)
+#define XFixesNumberRequests (X_XFixesQueryAncestors+1)
/* Selection events share one event number */
#define XFixesSelectionNotify 0
--
1.6.5.2
More information about the xorg-devel
mailing list