OLD | NEW |
1 <?xml version="1.0" encoding="UTF-8"?> | 1 <?xml version="1.0" encoding="UTF-8"?> |
2 <protocol name="gaming_input_unstable_v1"> | 2 <protocol name="gaming_input_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 24 matching lines...) Expand all Loading... |
35 may be added together with the corresponding uinterface version bump. | 35 may be added together with the corresponding uinterface version bump. |
36 Backward incompatible changes are done by bumping the version number in | 36 Backward incompatible changes are done by bumping the version number in |
37 the protocol and uinterface names and resetting the interface version. | 37 the protocol and uinterface names and resetting the interface version. |
38 Once the protocol is to be declared stable, the 'z' prefix and the | 38 Once the protocol is to be declared stable, the 'z' prefix and the |
39 version number in the protocol and interface names are removed and the | 39 version number in the protocol and interface names are removed and the |
40 interface version number is reset. | 40 interface version number is reset. |
41 </description> | 41 </description> |
42 | 42 |
43 <request name="get_gamepad"> | 43 <request name="get_gamepad"> |
44 <description summary="get gamepad device assigned to seat"> | 44 <description summary="get gamepad device assigned to seat"> |
45 Create gamepad object. See zwp_gamepad_v1 interface for details. | 45 Create gamepad object. See zcr_gamepad_v1 interface for details. |
46 </description> | 46 </description> |
47 <arg name="id" type="new_id" interface="zcr_gamepad_v1"/> | 47 <arg name="id" type="new_id" interface="zcr_gamepad_v1"/> |
48 <arg name="seat" type="object" interface="wl_seat"/> | 48 <arg name="seat" type="object" interface="wl_seat"/> |
49 </request> | 49 </request> |
50 </interface> | 50 </interface> |
51 | 51 |
52 <interface name="zcr_gamepad_v1" version="1"> | 52 <interface name="zcr_gamepad_v1" version="1"> |
53 <description summary="gamepad input device"> | 53 <description summary="gamepad input device"> |
54 The zwp_gamepad_v1 interface represents one or more gamepad input devices, | 54 The zcr_gamepad_v1 interface represents one or more gamepad input devices, |
55 which are reported as a normalized 'Standard Gamepad' as it is specified | 55 which are reported as a normalized 'Standard Gamepad' as it is specified |
56 by the W3C Gamepad API at: https://w3c.github.io/gamepad/#remapping | 56 by the W3C Gamepad API at: https://w3c.github.io/gamepad/#remapping |
57 </description> | 57 </description> |
58 | 58 |
59 <request name="destroy" type="destructor"> | 59 <request name="destroy" type="destructor"> |
60 <description summary="destroy gamepad object"/> | 60 <description summary="destroy gamepad object"/> |
61 </request> | 61 </request> |
62 | 62 |
63 <enum name="gamepad_state"> | 63 <enum name="gamepad_state"> |
64 <description summary="connection state"/> | 64 <description summary="connection state"/> |
(...skipping 52 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
117 <event name="frame"> | 117 <event name="frame"> |
118 <description summary="Notifies end of a series of gamepad changes."> | 118 <description summary="Notifies end of a series of gamepad changes."> |
119 Indicates the end of a set of events that logically belong together. | 119 Indicates the end of a set of events that logically belong together. |
120 A client is expected to accumulate the data in all events within the | 120 A client is expected to accumulate the data in all events within the |
121 frame before proceeding. | 121 frame before proceeding. |
122 </description> | 122 </description> |
123 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | 123 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> |
124 </event> | 124 </event> |
125 </interface> | 125 </interface> |
126 | 126 |
127 <interface name="zwp_gaming_input_v1" version="1"> | |
128 <description summary="DEPRECATED"> | |
129 A global interface to provide gaming input devices for a given seat. | |
130 | |
131 Currently only gamepad devices are supported. | |
132 | |
133 Warning! The protocol described in this file is experimental and | |
134 backward incompatible changes may be made. Backward compatible changes | |
135 may be added together with the corresponding uinterface version bump. | |
136 Backward incompatible changes are done by bumping the version number in | |
137 the protocol and uinterface names and resetting the interface version. | |
138 Once the protocol is to be declared stable, the 'z' prefix and the | |
139 version number in the protocol and interface names are removed and the | |
140 interface version number is reset. | |
141 </description> | |
142 | |
143 <request name="get_gamepad"> | |
144 <description summary="get gamepad device assigned to seat"> | |
145 Create gamepad object. See zwp_gamepad_v1 interface for details. | |
146 </description> | |
147 <arg name="id" type="new_id" interface="zwp_gamepad_v1"/> | |
148 <arg name="seat" type="object" interface="wl_seat"/> | |
149 </request> | |
150 </interface> | |
151 | |
152 <interface name="zwp_gamepad_v1" version="1"> | |
153 <description summary="DEPRECATED"> | |
154 The zwp_gamepad_v1 interface represents one or more gamepad input devices, | |
155 which are reported as a normalized 'Standard Gamepad' as it is specified | |
156 by the W3C Gamepad API at: https://w3c.github.io/gamepad/#remapping | |
157 </description> | |
158 | |
159 <request name="destroy" type="destructor"> | |
160 <description summary="destroy gamepad object"/> | |
161 </request> | |
162 | |
163 <enum name="gamepad_state"> | |
164 <description summary="connection state"/> | |
165 <entry name="off" value="0" summary="no gamepads are connected or on."/> | |
166 <entry name="on" value="1" summary="at least one gamepad is connected."/> | |
167 </enum> | |
168 | |
169 <event name="state_change"> | |
170 <description summary="state change event"> | |
171 Notification that this seat's connection state has changed. | |
172 </description> | |
173 <arg name="state" type="uint" enum="gamepad_state" summary="new state"/> | |
174 </event> | |
175 | |
176 <event name="axis"> | |
177 <description summary="axis change event"> | |
178 Notification of axis change. | |
179 | |
180 The axis id specifies which axis has changed as defined by the W3C | |
181 'Standard Gamepad'. | |
182 | |
183 The value is calibrated and normalized to the -1 to 1 range. | |
184 </description> | |
185 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | |
186 <arg name="axis" type="uint" summary="axis that produced this event"/> | |
187 <arg name="value" type="fixed" summary="new value of axis"/> | |
188 </event> | |
189 | |
190 <enum name="button_state"> | |
191 <description summary="physical button state"> | |
192 Describes the physical state of a button that produced the button | |
193 event. | |
194 </description> | |
195 <entry name="released" value="0" summary="the button is not pressed"/> | |
196 <entry name="pressed" value="1" summary="the button is pressed"/> | |
197 </enum> | |
198 | |
199 <event name="button"> | |
200 <description summary="Gamepad button changed"> | |
201 Notification of button change. | |
202 | |
203 The button id specifies which button has changed as defined by the W3C | |
204 'Standard Gamepad'. | |
205 | |
206 A button can have a digital and an analog value. The analog value is | |
207 normalized to a 0 to 1 range. | |
208 If a button does not provide an analog value, it will be derived from | |
209 the digital state. | |
210 </description> | |
211 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | |
212 <arg name="button" type="uint" summary="id of button"/> | |
213 <arg name="state" type="uint" enum="button_state" summary="digital state o
f the button"/> | |
214 <arg name="analog" type="fixed" summary="analog value of the button"/> | |
215 </event> | |
216 | |
217 <event name="frame"> | |
218 <description summary="Notifies end of a series of gamepad changes."> | |
219 Indicates the end of a set of events that logically belong together. | |
220 A client is expected to accumulate the data in all events within the | |
221 frame before proceeding. | |
222 </description> | |
223 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | |
224 </event> | |
225 </interface> | |
226 </protocol> | 127 </protocol> |
OLD | NEW |