OLD | NEW |
1 <?xml version="1.0" encoding="UTF-8"?> | 1 <?xml version="1.0" encoding="UTF-8"?> |
2 <protocol name="stylus_unstable_v1"> | 2 <protocol name="stylus_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 97 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
108 Measured from surface normal as plane angle in degrees, values lie in | 108 Measured from surface normal as plane angle in degrees, values lie in |
109 [-90,90]. A positive x is to the right and a positive y is towards the | 109 [-90,90]. A positive x is to the right and a positive y is towards the |
110 user. | 110 user. |
111 </description> | 111 </description> |
112 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | 112 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> |
113 <arg name="tilt_x" type="fixed" summary="tilt in x direction"/> | 113 <arg name="tilt_x" type="fixed" summary="tilt in x direction"/> |
114 <arg name="tilt_y" type="fixed" summary="tilt in y direction"/> | 114 <arg name="tilt_y" type="fixed" summary="tilt in y direction"/> |
115 </event> | 115 </event> |
116 </interface> | 116 </interface> |
117 | 117 |
118 <interface name="zwp_stylus_v1" version="1"> | |
119 <description summary="DEPRECATED"> | |
120 Allows a wl_pointer to represent an on-screen stylus. The client can | |
121 interpret the on-screen stylus like any other mouse device, and use | |
122 this protocol to obtain detail information about the type of stylus, | |
123 as well as the force and tilt of the tool. | |
124 | |
125 These events are to be fired by the server within the same frame as other | |
126 wl_pointer events. | |
127 | |
128 Warning! The protocol described in this file is experimental and | |
129 backward incompatible changes may be made. Backward compatible changes | |
130 may be added together with the corresponding uinterface version bump. | |
131 Backward incompatible changes are done by bumping the version number in | |
132 the protocol and uinterface names and resetting the interface version. | |
133 Once the protocol is to be declared stable, the 'z' prefix and the | |
134 version number in the protocol and interface names are removed and the | |
135 interface version number is reset. | |
136 </description> | |
137 | |
138 <request name="get_pointer_stylus"> | |
139 <description summary="get stylus interface for pointer"> | |
140 Create pointer_stylus object. See zwp_pointer_stylus_v1 interface for | |
141 details. | |
142 </description> | |
143 <arg name="id" type="new_id" interface="zwp_pointer_stylus_v1"/> | |
144 <arg name="pointer" type="object" interface="wl_pointer"/> | |
145 </request> | |
146 </interface> | |
147 | |
148 <interface name="zwp_pointer_stylus_v1" version="1"> | |
149 <description summary="DEPRECATED"> | |
150 The zwp_pointer_stylus_v1 interface extends the wl_pointer interface with | |
151 events to describe details about a stylus acting as a pointer. | |
152 </description> | |
153 | |
154 <request name="destroy" type="destructor"> | |
155 <description summary="destroy stylus object"/> | |
156 </request> | |
157 | |
158 <enum name="tool_type"> | |
159 <description summary="tool type of device."/> | |
160 <entry name="mouse" value="0" summary="Mouse or touchpad, not a stylus."/> | |
161 <entry name="pen" value="1" summary="Pen"/> | |
162 <entry name="touch" value="2" summary="Touch"/> | |
163 <entry name="eraser" value="3" summary="Eraser"/> | |
164 </enum> | |
165 | |
166 <event name="tool_change"> | |
167 <description summary="pointing device tool type changed"> | |
168 Notification that the user is using a new tool type. There can only be | |
169 one tool in use at a time. If the pointer enters a client surface, with | |
170 a tool type other than mouse, this event will also be generated. | |
171 | |
172 If this event is not received, the client has to assume a mouse is in | |
173 use. The remaining events of this protocol are only being generated | |
174 after this event has been fired with a tool type other than mouse. | |
175 </description> | |
176 <arg name="type" type="uint" enum="tool_type" summary="new device type"/> | |
177 </event> | |
178 | |
179 <event name="force"> | |
180 <description summary="force change event"> | |
181 Notification of a change in physical force on the surface of the screen. | |
182 | |
183 If the pointer enters a client surface, with a tool type other than | |
184 mouse, this event will also be generated. | |
185 | |
186 The force is calibrated and normalized to the 0 to 1 range. | |
187 </description> | |
188 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | |
189 <arg name="force" type="fixed" summary="new value of force"/> | |
190 </event> | |
191 | |
192 <event name="tilt"> | |
193 <description summary="force change event"> | |
194 Notification of a change in tilt of the pointing tool. | |
195 | |
196 If the pointer enters a client surface, with a tool type other than | |
197 mouse, this event will also be generated. | |
198 | |
199 Measured from surface normal as plane angle in degrees, values lie in | |
200 [-90,90]. A positive x is to the right and a positive y is towards the | |
201 user. | |
202 </description> | |
203 <arg name="time" type="uint" summary="timestamp with millisecond granulari
ty"/> | |
204 <arg name="tilt_x" type="fixed" summary="tilt in x direction"/> | |
205 <arg name="tilt_y" type="fixed" summary="tilt in y direction"/> | |
206 </event> | |
207 </interface> | |
208 </protocol> | 118 </protocol> |
OLD | NEW |