summaryrefslogtreecommitdiff
path: root/presentproto.txt
diff options
context:
space:
mode:
authorKeith Packard <keithp@keithp.com>2013-12-13 12:11:00 -0800
committerKeith Packard <keithp@keithp.com>2013-12-13 12:11:42 -0800
commitff72e3fcfd48185c2e33d6eaa50b7ff100aaeabb (patch)
tree3ae012289ad5853985f83fff8650797199bf3e9a /presentproto.txt
parent8405ee4552565825d776e6a8963d33d9cd9cddf0 (diff)
Move Redirect stuff to 'later version' sections
This makes it clear that the Redirect event bits are not part of the 1.0 standard. Signed-off-by: Keith Packard <keithp@keithp.com>
Diffstat (limited to 'presentproto.txt')
-rw-r--r--presentproto.txt70
1 files changed, 56 insertions, 14 deletions
diff --git a/presentproto.txt b/presentproto.txt
index 9cd7658..6dd1ca2 100644
--- a/presentproto.txt
+++ b/presentproto.txt
@@ -13,7 +13,13 @@ window contents from a pixmap in a well defined fashion, synchronizing
with the display refresh and potentially using a more efficient
mechanism than copying the contents of the source pixmap.
-1.1. Acknowledgments
+1.1. Future Present extension versions
+
+This document includes speculation about future 'redirect' support
+within the Present extension. All such information is subject to
+change and is provided only as an aid to further Present development.
+
+1.2. Acknowledgments
Eric Anholt <eric@anholt.net>
Owen Taylor <otaylor@redhat.com>
@@ -41,13 +47,11 @@ PRESENTNOTIFY {
PRESENTEVENTTYPE { PresentConfigureNotify,
PresentCompleteNotify,
- PresentIdleNotify,
- PresentRedirectNotify }
+ PresentIdleNotify }
PRESENTEVENTMASK { PresentConfigureNotifyMask,
PresentCompleteNotifyMask,
- PresentIdleNotifyMask,
- PresentSubredirectNotifyMask }
+ PresentIdleNotifyMask }
PRESENTOPTION { PresentOptionAsync,
PresentOptionCopy,
@@ -67,6 +71,14 @@ PRESENTCOMPLETEMODE { PresentCompleteModeCopy,
The Present extension also uses the Sync extension Fence data type to
provide synchronization for pixmaps.
+2.1. Data Types proposed for a later Present extension version
+
+PRESENTEVENTTYPE { ...
+ PresentRedirectNotify }
+
+PRESENTEVENTMASK { ...
+ PresentSubredirectNotifyMask }
+
❄ ❄ ❄ ❄ ❄ ❄ ❄
3. Errors
@@ -86,6 +98,8 @@ PresentPixmap request.
IdleNotify events inform clients when pixmaps are available for re-use.
+5.1. Events proposed for a later Present extension version
+
RedirectNotify events inform clients about other clients PresentPixmap
requests.
@@ -281,13 +295,6 @@ The name of this extension is "Present"
no operation is performed. Otherwise, a new event context is
created selecting the specified events.
- Specifying PresentSubredirectNotify Mask causes PresentPixmap
- requests on any child of 'window' from other clients to
- generate PresentRedirectNotify events to 'window' instead of
- actually performing the operation. However, only one client at
- a time can select for PresentRedirect on a window. An attempt
- to violate this restriction results in an Access error.
-
┌───
PresentQueryCapabilities
target: CRTC or WINDOW
@@ -324,6 +331,25 @@ The name of this extension is "Present"
defined by the extension, but is expected to be on the order
of milliseconds or less.
+
+7.1 Requests proposed for a later Present extension version
+
+ These are not part of the standard and represent future plans
+ for the Present extension.
+
+┌───
+ PresentSelectInput
+ ...
+└───
+ ...
+
+ Specifying PresentSubredirectNotify Mask causes PresentPixmap
+ requests on any child of 'window' from other clients to
+ generate PresentRedirectNotify events to 'window' instead of
+ actually performing the operation. However, only one client at
+ a time can select for PresentRedirect on a window. An attempt
+ to violate this restriction results in an Access error.
+
❄ ❄ ❄ ❄ ❄ ❄ ❄
8. Extension Events
@@ -426,6 +452,8 @@ The name of this extension is "Present"
buffer. If not None, then the client must wait for the fence
to be signaled before using the pixmap.
+8.1. Extension Events proposed for a later Present extension version
+
┌───
PresentRedirectNotify
type: CARD8 XGE event type (35)
@@ -527,7 +555,6 @@ A.1 Common Types
0 PresentConfigureNotify
1 PresentCompleteNotify
2 PresentIdleNotify
- 3 PresentRedirectNotify
└───
┌───
@@ -535,7 +562,6 @@ A.1 Common Types
1 PresentConfigureNotifyMask
2 PresentCompleteNotifyMask
4 PresentIdleNotifyMask
- 8 PresentRedirectNotifyMask
└───
┌───
@@ -571,6 +597,20 @@ A.1 Common Types
4 CARD32 serial
└───
+A.1.1 Common Types proposed for a later Present extension version
+
+┌───
+ PresentEventType
+ ...
+ 3 PresentRedirectNotify
+└───
+
+┌───
+ PresentEventMask
+ ...
+ 8 PresentSubredirectNotifyMask
+└───
+
A.2 Protocol Requests
┌───
@@ -706,6 +746,8 @@ A.3 Protocol Events
4 SyncFence idle-fence
└───
+A.3.1 Protocol Events proposed for later Present extension version
+
┌───
PresentRedirectNotify
1 35 XGE