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>
This commit is contained in:
Keith Packard 2013-12-13 12:11:00 -08:00
parent 8405ee4552
commit ff72e3fcfd

View file

@ -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