mirror of
https://gitlab.freedesktop.org/libinput/libinput.git
synced 2025-12-20 18:30:06 +01:00
tools: drop the libinput measure trackpoint-range tool
This tool is now obsolete, we don't use that range anywhere. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
This commit is contained in:
Peter Hutterer
parent
6c1e348789
commit
cb49e90472
5 changed files with 0 additions and 271 deletions
|
|
@ -490,7 +490,6 @@ src_python_tools = files(
|
||||||
'tools/libinput-measure-touchpad-tap.py',
|
'tools/libinput-measure-touchpad-tap.py',
|
||||||
'tools/libinput-measure-touchpad-pressure.py',
|
'tools/libinput-measure-touchpad-pressure.py',
|
||||||
'tools/libinput-measure-touch-size.py',
|
'tools/libinput-measure-touch-size.py',
|
||||||
'tools/libinput-measure-trackpoint-range.py',
|
|
||||||
)
|
)
|
||||||
|
|
||||||
config_noop = configuration_data()
|
config_noop = configuration_data()
|
||||||
|
|
@ -514,7 +513,6 @@ src_man = files(
|
||||||
'tools/libinput-measure-touchpad-tap.man',
|
'tools/libinput-measure-touchpad-tap.man',
|
||||||
'tools/libinput-measure-touchpad-pressure.man',
|
'tools/libinput-measure-touchpad-pressure.man',
|
||||||
'tools/libinput-measure-touch-size.man',
|
'tools/libinput-measure-touch-size.man',
|
||||||
'tools/libinput-measure-trackpoint-range.man',
|
|
||||||
)
|
)
|
||||||
|
|
||||||
foreach m : src_man
|
foreach m : src_man
|
||||||
|
|
|
||||||
|
|
@ -1,31 +0,0 @@
|
||||||
.TH LIBINPUT-MEASURE-TRACKPOINT-RANGE "1" "" "libinput @LIBINPUT_VERSION@" "libinput Manual"
|
|
||||||
.SH NAME
|
|
||||||
libinput\-measure\-trackpoint\-range \- measure the delta range of a trackpoint
|
|
||||||
.SH SYNOPSIS
|
|
||||||
.B libinput measure trackpoint\-range [\-\-help] [/dev/input/event0]
|
|
||||||
.SH DESCRIPTION
|
|
||||||
.PP
|
|
||||||
The
|
|
||||||
.B "libinput measure trackpoint\-range"
|
|
||||||
tool measures the delta range of a trackpoint. This is
|
|
||||||
an interactive tool. When executed, the tool will prompt the user to
|
|
||||||
interact with the trackpoint. On termination, the tool prints a summary of
|
|
||||||
the trackpoint deltas seen. This data should be attached to any bug report
|
|
||||||
relating to the trackpoint's speed.
|
|
||||||
.PP
|
|
||||||
This is a debugging tool only, its output may change at any time. Do not
|
|
||||||
rely on the output.
|
|
||||||
.PP
|
|
||||||
This tool usually needs to be run as root to have access to the
|
|
||||||
/dev/input/eventX nodes.
|
|
||||||
.SH OPTIONS
|
|
||||||
If a device node is given, this tool opens that device node. Otherwise, this
|
|
||||||
tool searches for the first node that looks like a trackpoint and uses that
|
|
||||||
node.
|
|
||||||
.TP 8
|
|
||||||
.B \-\-help
|
|
||||||
Print help
|
|
||||||
.SH LIBINPUT
|
|
||||||
Part of the
|
|
||||||
.B libinput(1)
|
|
||||||
suite
|
|
||||||
|
|
@ -1,232 +0,0 @@
|
||||||
#!/usr/bin/env python3
|
|
||||||
# vim: set expandtab shiftwidth=4:
|
|
||||||
# -*- Mode: python; coding: utf-8; indent-tabs-mode: nil -*- */
|
|
||||||
#
|
|
||||||
# Copyright © 2017 Red Hat, Inc.
|
|
||||||
#
|
|
||||||
# Permission is hereby granted, free of charge, to any person obtaining a
|
|
||||||
# copy of this software and associated documentation files (the "Software"),
|
|
||||||
# to deal in the Software without restriction, including without limitation
|
|
||||||
# the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
||||||
# and/or sell copies of the Software, and to permit persons to whom the
|
|
||||||
# Software is furnished to do so, subject to the following conditions:
|
|
||||||
#
|
|
||||||
# The above copyright notice and this permission notice (including the next
|
|
||||||
# paragraph) shall be included in all copies or substantial portions of the
|
|
||||||
# Software.
|
|
||||||
#
|
|
||||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
||||||
# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
||||||
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
||||||
# DEALINGS IN THE SOFTWARE.
|
|
||||||
#
|
|
||||||
|
|
||||||
from math import atan, sqrt, pi, floor, ceil
|
|
||||||
import sys
|
|
||||||
import argparse
|
|
||||||
try:
|
|
||||||
import evdev
|
|
||||||
import evdev.ecodes
|
|
||||||
import pyudev
|
|
||||||
except ModuleNotFoundError as e:
|
|
||||||
print('Error: {}'.format(str(e)), file=sys.stderr)
|
|
||||||
print('One or more python modules are missing. Please install those '
|
|
||||||
'modules and re-run this tool.')
|
|
||||||
sys.exit(1)
|
|
||||||
|
|
||||||
# This should match libinput's DEFAULT_TRACKPOINT_RANGE
|
|
||||||
DEFAULT_RANGE = 20
|
|
||||||
MINIMUM_EVENT_COUNT = 1000
|
|
||||||
|
|
||||||
|
|
||||||
class InvalidDeviceError(Exception):
|
|
||||||
pass
|
|
||||||
|
|
||||||
|
|
||||||
class Delta(object):
|
|
||||||
def __init__(self, x=0, y=0):
|
|
||||||
self.x = x
|
|
||||||
self.y = y
|
|
||||||
|
|
||||||
def __bool__(self):
|
|
||||||
return self.x != 0 or self.y != 0
|
|
||||||
|
|
||||||
def r(self):
|
|
||||||
return sqrt(self.x**2 + self.y**2)
|
|
||||||
|
|
||||||
class Device(object):
|
|
||||||
def __init__(self, path):
|
|
||||||
if path is None:
|
|
||||||
path = self._find_trackpoint_device()
|
|
||||||
self.path = path
|
|
||||||
|
|
||||||
self.device = evdev.InputDevice(self.path)
|
|
||||||
|
|
||||||
print("Using {}: {}\n".format(self.device.name, path))
|
|
||||||
|
|
||||||
self.deltas = []
|
|
||||||
self.nxdeltas = 0
|
|
||||||
self.nydeltas = 0
|
|
||||||
|
|
||||||
self.current_delta = Delta()
|
|
||||||
self.max_delta = Delta(0, 0)
|
|
||||||
|
|
||||||
def _find_trackpoint_device(self):
|
|
||||||
context = pyudev.Context()
|
|
||||||
for device in context.list_devices(subsystem='input'):
|
|
||||||
if not device.get('ID_INPUT_POINTINGSTICK', 0):
|
|
||||||
continue
|
|
||||||
|
|
||||||
if not device.device_node or \
|
|
||||||
not device.device_node.startswith('/dev/input/event'):
|
|
||||||
continue
|
|
||||||
|
|
||||||
return device.device_node
|
|
||||||
|
|
||||||
raise InvalidDeviceError("Unable to find a trackpoint device")
|
|
||||||
|
|
||||||
def handle_rel(self, event):
|
|
||||||
if event.code == evdev.ecodes.REL_X:
|
|
||||||
self.current_delta.x = event.value
|
|
||||||
if self.max_delta.x < abs(event.value):
|
|
||||||
self.max_delta.x = abs(event.value)
|
|
||||||
elif event.code == evdev.ecodes.REL_Y:
|
|
||||||
self.current_delta.y = event.value
|
|
||||||
if self.max_delta.y < abs(event.value):
|
|
||||||
self.max_delta.y = abs(event.value)
|
|
||||||
|
|
||||||
def handle_syn(self, event):
|
|
||||||
self.deltas.append(self.current_delta)
|
|
||||||
if self.current_delta.x != 0:
|
|
||||||
self.nxdeltas += 1
|
|
||||||
if self.current_delta.y != 0:
|
|
||||||
self.nydeltas += 1
|
|
||||||
|
|
||||||
self.current_delta = Delta()
|
|
||||||
|
|
||||||
print("\rTrackpoint sends: max x:{:3d}, max y:{:3} samples [{}, {}]"
|
|
||||||
.format(
|
|
||||||
self.max_delta.x, self.max_delta.y,
|
|
||||||
self.nxdeltas, self.nydeltas,
|
|
||||||
), end="")
|
|
||||||
|
|
||||||
def read_events(self):
|
|
||||||
for event in self.device.read_loop():
|
|
||||||
if event.type == evdev.ecodes.EV_REL:
|
|
||||||
self.handle_rel(event)
|
|
||||||
elif event.type == evdev.ecodes.EV_SYN:
|
|
||||||
self.handle_syn(event)
|
|
||||||
|
|
||||||
def print_summary(self):
|
|
||||||
print("\n") # undo the \r from the status line
|
|
||||||
if not self.deltas:
|
|
||||||
return
|
|
||||||
|
|
||||||
if len(self.deltas) < MINIMUM_EVENT_COUNT:
|
|
||||||
print("WARNING: *******************************************\n"
|
|
||||||
"WARNING: Insufficient samples, data is not reliable\n"
|
|
||||||
"WARNING: *******************************************\n")
|
|
||||||
|
|
||||||
print("Histogram for x axis deltas, in counts of 5")
|
|
||||||
xs = [d.x for d in self.deltas]
|
|
||||||
minx = min(xs)
|
|
||||||
maxx = max(xs)
|
|
||||||
for i in range(minx, maxx + 1):
|
|
||||||
xc = len([x for x in xs if x == i])
|
|
||||||
xc = int(xc/5) # counts of 5 is enough
|
|
||||||
print("{:4}: {}".format(i, "+" * xc, end=""))
|
|
||||||
|
|
||||||
print("Histogram for y axis deltas, in counts of 5")
|
|
||||||
ys = [d.y for d in self.deltas]
|
|
||||||
miny = min(ys)
|
|
||||||
maxy = max(ys)
|
|
||||||
for i in range(miny, maxy + 1):
|
|
||||||
yc = len([y for y in ys if y == i])
|
|
||||||
yc = int(yc/5) # counts of 5 is enough
|
|
||||||
print("{:4}: {}".format(i, "+" * yc, end=""))
|
|
||||||
|
|
||||||
print("Histogram for radius (amplitude) deltas")
|
|
||||||
rs = [d.r() for d in self.deltas if d]
|
|
||||||
nr = 50
|
|
||||||
minr = 0
|
|
||||||
maxr = ceil(max(rs))
|
|
||||||
for x in range(0, nr):
|
|
||||||
yc = len([y for y in rs if y >= x * maxr/nr
|
|
||||||
and y < (x+1) * maxr/nr])
|
|
||||||
print("{:>6.1f}-{:<6.1f}: {:6} {}".
|
|
||||||
format(x * maxr/nr, (x+1) * maxr/nr,
|
|
||||||
yc, "+" * int(yc/5), end=""))
|
|
||||||
|
|
||||||
minr = min(rs)
|
|
||||||
|
|
||||||
axs = sorted([abs(x) for x in xs])
|
|
||||||
ays = sorted([abs(y) for y in ys])
|
|
||||||
ars = sorted([y for y in rs])
|
|
||||||
|
|
||||||
avgx = int(sum(axs)/len(axs))
|
|
||||||
avgy = int(sum(ays)/len(ays))
|
|
||||||
avgr = sum(ars)/len(ars)
|
|
||||||
|
|
||||||
medx = axs[int(len(axs)/2)]
|
|
||||||
medy = ays[int(len(ays)/2)]
|
|
||||||
medr = ars[int(len(ars)/2)]
|
|
||||||
|
|
||||||
pc95x = axs[int(len(axs) * 0.95)]
|
|
||||||
pc95y = ays[int(len(ays) * 0.95)]
|
|
||||||
pc95r = ars[int(len(ars) * 0.95)]
|
|
||||||
|
|
||||||
print("Min r: {:6.1f}, Max r: {:6.1f}, Max/Min: {:6.1f}".
|
|
||||||
format(minr, max(rs), max(rs)/minr))
|
|
||||||
print("Average for abs deltas: x: {:3} y: {:3} r: {:6.1f}".format(avgx, avgy, avgr))
|
|
||||||
print("Median for abs deltas: x: {:3} y: {:3} r: {:6.1f}".format(medx, medy, medr))
|
|
||||||
print("95% percentile for abs deltas: x: {:3} y: {:3} r: {:6.1f}"
|
|
||||||
.format(pc95x, pc95y, pc95r)
|
|
||||||
)
|
|
||||||
if (minr > 2):
|
|
||||||
suggested = 10 * ceil(minr * DEFAULT_RANGE / 10)
|
|
||||||
print("""\
|
|
||||||
The minimum amplitude is too big for precise pointer movements.
|
|
||||||
The recommended value for LIBINPUT_ATTR_TRACKPOINT_RANGE
|
|
||||||
is 20 * {} ~= {} or higher, which would result in a corrected
|
|
||||||
delta range of {:>.1f}-{:<.1f}.
|
|
||||||
""".format(ceil(minr), suggested,
|
|
||||||
minr*DEFAULT_RANGE/suggested, maxr*DEFAULT_RANGE/suggested))
|
|
||||||
|
|
||||||
def main(args):
|
|
||||||
parser = argparse.ArgumentParser(
|
|
||||||
description="Measure the trackpoint delta coordinate range"
|
|
||||||
)
|
|
||||||
parser.add_argument('path', metavar='/dev/input/event0',
|
|
||||||
nargs='?', type=str, help='Path to device (optional)')
|
|
||||||
|
|
||||||
args = parser.parse_args()
|
|
||||||
|
|
||||||
try:
|
|
||||||
device = Device(args.path)
|
|
||||||
|
|
||||||
print(
|
|
||||||
"This tool measures the commonly used pressure range of the\n"
|
|
||||||
"trackpoint. Start by pushing the trackpoint very gently in\n"
|
|
||||||
"slow, small circles. Slowly increase pressure until the pointer\n"
|
|
||||||
"moves quickly around the screen edges, but do not use excessive\n"
|
|
||||||
"pressure that would not be used during day-to-day movement.\n"
|
|
||||||
"Also make diagonal some movements, both slow and quick.\n"
|
|
||||||
"When you're done, start over, until the displayed event count\n"
|
|
||||||
"is {} or more for both x and y axis.\n\n"
|
|
||||||
"Hit Ctrl-C to stop the measurement and display results.\n"
|
|
||||||
"For best results, run this tool several times to get an idea\n"
|
|
||||||
"of the common range.\n".format(MINIMUM_EVENT_COUNT))
|
|
||||||
device.read_events()
|
|
||||||
except KeyboardInterrupt:
|
|
||||||
device.print_summary()
|
|
||||||
except (PermissionError, OSError):
|
|
||||||
print("Error: failed to open device. Are you running as root?")
|
|
||||||
except InvalidDeviceError as e:
|
|
||||||
print("Error: {}".format(e))
|
|
||||||
|
|
||||||
|
|
||||||
if __name__ == "__main__":
|
|
||||||
main(sys.argv)
|
|
||||||
|
|
@ -33,9 +33,6 @@ Measure tap-to-click time
|
||||||
.TP 8
|
.TP 8
|
||||||
.B libinput\-measure\-touchpad\-pressure(1)
|
.B libinput\-measure\-touchpad\-pressure(1)
|
||||||
Measure touch pressure
|
Measure touch pressure
|
||||||
.TP 8
|
|
||||||
.B libinput\-measure\-trackpoint\-range(1)
|
|
||||||
Measure the delta range of a trackpoint.
|
|
||||||
.SH LIBINPUT
|
.SH LIBINPUT
|
||||||
Part of the
|
Part of the
|
||||||
.B libinput(1)
|
.B libinput(1)
|
||||||
|
|
|
||||||
|
|
@ -54,9 +54,6 @@ Measure tap-to-click time
|
||||||
.B libinput\-measure\-touchpad\-pressure(1)
|
.B libinput\-measure\-touchpad\-pressure(1)
|
||||||
Measure touch pressure
|
Measure touch pressure
|
||||||
.TP 8
|
.TP 8
|
||||||
.B libinput\-measure\-trackpoint\-range(1)
|
|
||||||
Measure the delta range of a trackpoint
|
|
||||||
.TP 8
|
|
||||||
.B libinput\-record(1)
|
.B libinput\-record(1)
|
||||||
Record the events from a device
|
Record the events from a device
|
||||||
.TP 8
|
.TP 8
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue