Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
libinput-mea...-touchpad-tap(1)  libinput Manual libinput-mea...-touchpad-tap(1)

NAME
     libinput-measure-touchpad-tap - measure tap-to-click properties of devices

SYNOPSIS
     libinput	measure   touchpad-tap	[--help]  [--format=<format>]  [/dev/in-
     put/event0]

DESCRIPTION
     The  libinput  measure  touchpad-tap  tool  measures  properties	of   the
     tap-to-click  behavior  of the user. This is an interactive tool. When exe-
     cuted, the tool will prompt the user to interact with the touchpad. On ter-
     mination, the tool prints a summary of the tap interactions seen. This data
     should be attached to any tap-related bug report.

     For a full description on how libinput's tap-to-click behavior  works,  see
     the   online   documentation  here:  https://wayland.freedesktop.org/libin-
     put/doc/latest/tapping.html

     This is a debugging tool only, its output may change at any  time.  Do  not
     rely on the output.

     This  tool  usually  needs to be run as root to have access to the /dev/in-
     put/eventX nodes.

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 touchpad and uses
     that node.

     --help  Print help

     --format=summary|dat
	     Specify the data format to be printed. The default (or if	--format
	     is omitted) is "summary". See section DATA FORMATS

DATA FORMATS
     This  section describes the data formats printed with the --format command-
     line argument. Note that any of the output may change at any time.

     summary
	 The summary format prints a summary of the data collected. This  format
	 is  useful to get a quick overview of a user's tapping behavior and why
	 some taps may or may not be detected.

     dat
	 The dat format prints the touch sequence data (raw  and  processed)  in
	 column-style  format,	suitable  for  processing by other tools such as
	 gnuplot(1).  The data is aligned in one row per touch with each  column
	 containing a separate data entry.  libinput-measure-touchpad-tap prints
	 comments at the top of the file to describe each column.

	 WARNING:  The data contained in the output is grouped by different sort
	 orders. For example, the first few columns may list tap information  in
	 the  'natural' sort order (i.e. as they occurred), the data in the next
	 few columns may list tap information sorted by the delta  time  between
	 touch	down  and touch up.  Comparing columns across these group bound-
	 aries will compare data of two different touch points and result in in-
	 valid analysis.

BUGS
     This tool does not take finger pressure into account. The	tap  it  detects
     may  be  different  to  those  detected  by libinput if libinput's pressure
     thresholds differ significantly to the kernel's pressure thresholds.

LIBINPUT
     Part of the libinput(1) suite

libinput 1.31.1 				 libinput-mea...-touchpad-tap(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=libinput-measure-touchpad-tap&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help