libinput-measure-touchpad-size.man 1.3 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. .TH libinput-measure-touchpad-size "1"
  2. .SH NAME
  3. libinput\-measure\-touchpad\-size \- measure the size of a touchpad
  4. .SH SYNOPSIS
  5. .B libinput measure touchpad\-size [\-\-help] WxH [\fI/dev/input/event0\fI]
  6. .SH DESCRIPTION
  7. .PP
  8. The
  9. .B "libinput measure touchpad\-size"
  10. tool measures the size of a touchpad. This is an interactive tool. When
  11. executed, the tool will prompt the user to interact with the touchpad. The
  12. tool records the axis ranges and calculates the size and resolution based on
  13. those. On termination, the tool prints a hwdb entry that can be added to the
  14. .B 60-evdev.hwdb
  15. file provided by system.
  16. .PP
  17. For details see the online documentation here:
  18. .I https://wayland.freedesktop.org/libinput/doc/latest/absolute-coordinate-ranges.html
  19. .PP
  20. This is a debugging tool only, its output may change at any time. Do not
  21. rely on the output.
  22. .PP
  23. This tool usually needs to be run as root to have access to the
  24. /dev/input/eventX nodes.
  25. .SH OPTIONS
  26. This tool must be provided the physical dimensions of the device in mm.
  27. For example, if your touchpad is 100mm wide and 55mm high, run this tool as
  28. .B libinput measure touchpad-size 100x55
  29. .PP
  30. If a device node is given, this tool opens that device node. Otherwise, this
  31. tool searches for the first node that looks like a touchpad and uses that
  32. node.
  33. .TP 8
  34. .B \-\-help
  35. Print help
  36. .SH LIBINPUT
  37. Part of the
  38. .B libinput(1)
  39. suite