mirror of
https://gitlab.freedesktop.org/xorg/proto/xorgproto.git
synced 2025-12-25 00:10:12 +01:00
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:
parent
8405ee4552
commit
ff72e3fcfd
1 changed files with 56 additions and 14 deletions
|
|
@ -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
|
with the display refresh and potentially using a more efficient
|
||||||
mechanism than copying the contents of the source pixmap.
|
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>
|
Eric Anholt <eric@anholt.net>
|
||||||
Owen Taylor <otaylor@redhat.com>
|
Owen Taylor <otaylor@redhat.com>
|
||||||
|
|
@ -41,13 +47,11 @@ PRESENTNOTIFY {
|
||||||
|
|
||||||
PRESENTEVENTTYPE { PresentConfigureNotify,
|
PRESENTEVENTTYPE { PresentConfigureNotify,
|
||||||
PresentCompleteNotify,
|
PresentCompleteNotify,
|
||||||
PresentIdleNotify,
|
PresentIdleNotify }
|
||||||
PresentRedirectNotify }
|
|
||||||
|
|
||||||
PRESENTEVENTMASK { PresentConfigureNotifyMask,
|
PRESENTEVENTMASK { PresentConfigureNotifyMask,
|
||||||
PresentCompleteNotifyMask,
|
PresentCompleteNotifyMask,
|
||||||
PresentIdleNotifyMask,
|
PresentIdleNotifyMask }
|
||||||
PresentSubredirectNotifyMask }
|
|
||||||
|
|
||||||
PRESENTOPTION { PresentOptionAsync,
|
PRESENTOPTION { PresentOptionAsync,
|
||||||
PresentOptionCopy,
|
PresentOptionCopy,
|
||||||
|
|
@ -67,6 +71,14 @@ PRESENTCOMPLETEMODE { PresentCompleteModeCopy,
|
||||||
The Present extension also uses the Sync extension Fence data type to
|
The Present extension also uses the Sync extension Fence data type to
|
||||||
provide synchronization for pixmaps.
|
provide synchronization for pixmaps.
|
||||||
|
|
||||||
|
2.1. Data Types proposed for a later Present extension version
|
||||||
|
|
||||||
|
PRESENTEVENTTYPE { ...
|
||||||
|
PresentRedirectNotify }
|
||||||
|
|
||||||
|
PRESENTEVENTMASK { ...
|
||||||
|
PresentSubredirectNotifyMask }
|
||||||
|
|
||||||
❄ ❄ ❄ ❄ ❄ ❄ ❄
|
❄ ❄ ❄ ❄ ❄ ❄ ❄
|
||||||
|
|
||||||
3. Errors
|
3. Errors
|
||||||
|
|
@ -86,6 +98,8 @@ PresentPixmap request.
|
||||||
|
|
||||||
IdleNotify events inform clients when pixmaps are available for re-use.
|
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
|
RedirectNotify events inform clients about other clients PresentPixmap
|
||||||
requests.
|
requests.
|
||||||
|
|
||||||
|
|
@ -281,13 +295,6 @@ The name of this extension is "Present"
|
||||||
no operation is performed. Otherwise, a new event context is
|
no operation is performed. Otherwise, a new event context is
|
||||||
created selecting the specified events.
|
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
|
PresentQueryCapabilities
|
||||||
target: CRTC or WINDOW
|
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
|
defined by the extension, but is expected to be on the order
|
||||||
of milliseconds or less.
|
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
|
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
|
buffer. If not None, then the client must wait for the fence
|
||||||
to be signaled before using the pixmap.
|
to be signaled before using the pixmap.
|
||||||
|
|
||||||
|
8.1. Extension Events proposed for a later Present extension version
|
||||||
|
|
||||||
┌───
|
┌───
|
||||||
PresentRedirectNotify
|
PresentRedirectNotify
|
||||||
type: CARD8 XGE event type (35)
|
type: CARD8 XGE event type (35)
|
||||||
|
|
@ -527,7 +555,6 @@ A.1 Common Types
|
||||||
0 PresentConfigureNotify
|
0 PresentConfigureNotify
|
||||||
1 PresentCompleteNotify
|
1 PresentCompleteNotify
|
||||||
2 PresentIdleNotify
|
2 PresentIdleNotify
|
||||||
3 PresentRedirectNotify
|
|
||||||
└───
|
└───
|
||||||
|
|
||||||
┌───
|
┌───
|
||||||
|
|
@ -535,7 +562,6 @@ A.1 Common Types
|
||||||
1 PresentConfigureNotifyMask
|
1 PresentConfigureNotifyMask
|
||||||
2 PresentCompleteNotifyMask
|
2 PresentCompleteNotifyMask
|
||||||
4 PresentIdleNotifyMask
|
4 PresentIdleNotifyMask
|
||||||
8 PresentRedirectNotifyMask
|
|
||||||
└───
|
└───
|
||||||
|
|
||||||
┌───
|
┌───
|
||||||
|
|
@ -571,6 +597,20 @@ A.1 Common Types
|
||||||
4 CARD32 serial
|
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
|
A.2 Protocol Requests
|
||||||
|
|
||||||
┌───
|
┌───
|
||||||
|
|
@ -706,6 +746,8 @@ A.3 Protocol Events
|
||||||
4 SyncFence idle-fence
|
4 SyncFence idle-fence
|
||||||
└───
|
└───
|
||||||
|
|
||||||
|
A.3.1 Protocol Events proposed for later Present extension version
|
||||||
|
|
||||||
┌───
|
┌───
|
||||||
PresentRedirectNotify
|
PresentRedirectNotify
|
||||||
1 35 XGE
|
1 35 XGE
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue