hc
2024-10-12 a5969cabbb4660eab42b6ef0412cbbd1200cf14d
kernel/Documentation/input/event-codes.rst
....@@ -190,7 +190,26 @@
190190 * REL_WHEEL, REL_HWHEEL:
191191
192192 - These codes are used for vertical and horizontal scroll wheels,
193
- respectively.
193
+ respectively. The value is the number of detents moved on the wheel, the
194
+ physical size of which varies by device. For high-resolution wheels
195
+ this may be an approximation based on the high-resolution scroll events,
196
+ see REL_WHEEL_HI_RES. These event codes are legacy codes and
197
+ REL_WHEEL_HI_RES and REL_HWHEEL_HI_RES should be preferred where
198
+ available.
199
+
200
+* REL_WHEEL_HI_RES, REL_HWHEEL_HI_RES:
201
+
202
+ - High-resolution scroll wheel data. The accumulated value 120 represents
203
+ movement by one detent. For devices that do not provide high-resolution
204
+ scrolling, the value is always a multiple of 120. For devices with
205
+ high-resolution scrolling, the value may be a fraction of 120.
206
+
207
+ If a vertical scroll wheel supports high-resolution scrolling, this code
208
+ will be emitted in addition to REL_WHEEL or REL_HWHEEL. The REL_WHEEL
209
+ and REL_HWHEEL may be an approximation based on the high-resolution
210
+ scroll events. There is no guarantee that the high-resolution data
211
+ is a multiple of 120 at the time of an emulated REL_WHEEL or REL_HWHEEL
212
+ event.
194213
195214 EV_ABS
196215 ------