OLD | NEW |
1 <?xml version="1.0" encoding="UTF-8"?> | 1 <?xml version="1.0" encoding="UTF-8"?> |
2 <protocol name="vsync_feedback_unstable_v1"> | 2 <protocol name="vsync_feedback_unstable_v1"> |
3 | 3 |
4 <copyright> | 4 <copyright> |
5 Copyright 2016 The Chromium Authors. | 5 Copyright 2016 The Chromium Authors. |
6 | 6 |
7 Permission is hereby granted, free of charge, to any person obtaining a | 7 Permission is hereby granted, free of charge, to any person obtaining a |
8 copy of this software and associated documentation files (the "Software"), | 8 copy of this software and associated documentation files (the "Software"), |
9 to deal in the Software without restriction, including without limitation | 9 to deal in the Software without restriction, including without limitation |
10 the rights to use, copy, modify, merge, publish, distribute, sublicense, | 10 the rights to use, copy, modify, merge, publish, distribute, sublicense, |
(...skipping 20 matching lines...) Expand all Loading... |
31 | 31 |
32 Warning! The protocol described in this file is experimental and backward | 32 Warning! The protocol described in this file is experimental and backward |
33 incompatible changes may be made. Backward compatible changes may be added | 33 incompatible changes may be made. Backward compatible changes may be added |
34 together with the corresponding interface version bump. Backward | 34 together with the corresponding interface version bump. Backward |
35 incompatible changes are done by bumping the version number in the protocol | 35 incompatible changes are done by bumping the version number in the protocol |
36 and interface names and resetting the interface version. Once the protocol | 36 and interface names and resetting the interface version. Once the protocol |
37 is to be declared stable, the version number in the protocol is removed and | 37 is to be declared stable, the version number in the protocol is removed and |
38 the interface version number is reset. | 38 the interface version number is reset. |
39 </description> | 39 </description> |
40 | 40 |
41 <interface name="zwp_vsync_feedback_v1" version="1"> | 41 <interface name="zcr_vsync_feedback_v1" version="1"> |
42 <description summary="Protocol for providing vertical synchronization timing
"> | 42 <description summary="Protocol for providing vertical synchronization timing
"> |
43 The global interface that allows clients to subscribe for vertical | 43 The global interface that allows clients to subscribe for vertical |
44 synchronization timing data for given wl_output. | 44 synchronization timing data for given wl_output. |
45 </description> | 45 </description> |
46 | 46 |
47 <request name="destroy" type="destructor"> | 47 <request name="destroy" type="destructor"> |
48 <description summary="destroy vsync feedback object"> | 48 <description summary="destroy vsync feedback object"> |
49 Destroy this vsync feedback object. Existing vsync timing objects shall | 49 Destroy this vsync feedback object. Existing vsync timing objects shall |
50 not be affected by this request. | 50 not be affected by this request. |
51 </description> | 51 </description> |
52 </request> | 52 </request> |
53 | 53 |
54 <request name="get_vsync_timing"> | 54 <request name="get_vsync_timing"> |
55 <description summary="get vsync timing object for given wl_output"> | 55 <description summary="get vsync timing object for given wl_output"> |
56 Create a new vsync timing object that represents a subscription to | 56 Create a new vsync timing object that represents a subscription to |
57 vertical synchronization timing updates of given wl_output object. | 57 vertical synchronization timing updates of given wl_output object. |
58 | 58 |
59 The newly created object will immediately signal an update to notify | 59 The newly created object will immediately signal an update to notify |
60 the subscriber of initial timing parameters. | 60 the subscriber of initial timing parameters. |
61 </description> | 61 </description> |
| 62 <arg name="id" type="new_id" interface="zcr_vsync_timing_v1" summary="the
new vsync timing interface id"/> |
| 63 <arg name="output" type="object" interface="wl_output" summary="the wl_out
put object to subscribe for timings of" allow-null="true"/> |
| 64 </request> |
| 65 </interface> |
| 66 |
| 67 <interface name="zcr_vsync_timing_v1" version="1"> |
| 68 <request name="destroy" type="destructor"> |
| 69 <description summary="destroy vsync timing object"> |
| 70 Destroy this vsync timing object. |
| 71 </description> |
| 72 </request> |
| 73 |
| 74 <event name="update"> |
| 75 <description summary="vsync timing updated"> |
| 76 Notifies client that vertical synchronization timing of given wl_output |
| 77 has changed. |
| 78 |
| 79 Timing information consists of two data, timebase and interval. Timebase |
| 80 is an absolute timestamp of the vsync event that caused the timing to |
| 81 change. Interval is a period of time between subsequent vsync events. |
| 82 |
| 83 The unit of all above mentioned time values shall be microseconds and |
| 84 absolute timestamps should match the realm of the primary system |
| 85 monotonic counter, i.e. the POSIX clock_gettime(CLOCK_MONOTONIC). Data |
| 86 type of both values is defined to be a 64-bit unsigned integer, but |
| 87 since the biggest unsigned integer datatype defined by the Wayland |
| 88 protocol is the 32-bit uint, both timebase and interval are split into |
| 89 most significant and least significant part, suffixed by "_h" and "_l" |
| 90 respectively. |
| 91 </description> |
| 92 <arg name="timebase_l" type="uint" summary="new vsync timebase (lower 32 b
its)"/> |
| 93 <arg name="timebase_h" type="uint" summary="new vsync timebase (upper 32 b
its)"/> |
| 94 <arg name="interval_l" type="uint" summary="new vsync interval (lower 32 b
its)"/> |
| 95 <arg name="interval_h" type="uint" summary="new vsync interval (upper 32 b
its)"/> |
| 96 </event> |
| 97 </interface> |
| 98 |
| 99 <interface name="zwp_vsync_feedback_v1" version="1"> |
| 100 <description summary="DEPRECATED"> |
| 101 The global interface that allows clients to subscribe for vertical |
| 102 synchronization timing data for given wl_output. |
| 103 </description> |
| 104 |
| 105 <request name="destroy" type="destructor"> |
| 106 <description summary="destroy vsync feedback object"> |
| 107 Destroy this vsync feedback object. Existing vsync timing objects shall |
| 108 not be affected by this request. |
| 109 </description> |
| 110 </request> |
| 111 |
| 112 <request name="get_vsync_timing"> |
| 113 <description summary="get vsync timing object for given wl_output"> |
| 114 Create a new vsync timing object that represents a subscription to |
| 115 vertical synchronization timing updates of given wl_output object. |
| 116 |
| 117 The newly created object will immediately signal an update to notify |
| 118 the subscriber of initial timing parameters. |
| 119 </description> |
62 <arg name="id" type="new_id" interface="zwp_vsync_timing_v1" summary="the
new vsync timing interface id"/> | 120 <arg name="id" type="new_id" interface="zwp_vsync_timing_v1" summary="the
new vsync timing interface id"/> |
63 <arg name="output" type="object" interface="wl_output" summary="the wl_out
put object to subscribe for timings of" allow-null="true"/> | 121 <arg name="output" type="object" interface="wl_output" summary="the wl_out
put object to subscribe for timings of" allow-null="true"/> |
64 </request> | 122 </request> |
65 </interface> | 123 </interface> |
66 | 124 |
67 <interface name="zwp_vsync_timing_v1" version="1"> | 125 <interface name="zwp_vsync_timing_v1" version="1"> |
68 <request name="destroy" type="destructor"> | 126 <request name="destroy" type="destructor"> |
69 <description summary="destroy vsync timing object"> | 127 <description summary="destroy vsync timing object"> |
70 Destroy this vsync timing object. | 128 Destroy this vsync timing object. |
71 </description> | 129 </description> |
(...skipping 17 matching lines...) Expand all Loading... |
89 most significant and least significant part, suffixed by "_h" and "_l" | 147 most significant and least significant part, suffixed by "_h" and "_l" |
90 respectively. | 148 respectively. |
91 </description> | 149 </description> |
92 <arg name="timebase_l" type="uint" summary="new vsync timebase (lower 32 b
its)"/> | 150 <arg name="timebase_l" type="uint" summary="new vsync timebase (lower 32 b
its)"/> |
93 <arg name="timebase_h" type="uint" summary="new vsync timebase (upper 32 b
its)"/> | 151 <arg name="timebase_h" type="uint" summary="new vsync timebase (upper 32 b
its)"/> |
94 <arg name="interval_l" type="uint" summary="new vsync interval (lower 32 b
its)"/> | 152 <arg name="interval_l" type="uint" summary="new vsync interval (lower 32 b
its)"/> |
95 <arg name="interval_h" type="uint" summary="new vsync interval (upper 32 b
its)"/> | 153 <arg name="interval_h" type="uint" summary="new vsync interval (upper 32 b
its)"/> |
96 </event> | 154 </event> |
97 </interface> | 155 </interface> |
98 </protocol> | 156 </protocol> |
OLD | NEW |