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

FreeBSD Manual Pages

  
 
  

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

NAME
       libinput-measure-touchpad-tap  -	measure	tap-to-click properties	of de-
       vices

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
       executed,  the tool will	prompt the user	to interact with the touchpad.
       On termination, 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/lib-
       input/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/input/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 com-
       mandline	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	behav-
	   ior 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-touch-
	   pad-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	infor-
	   mation 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 boundaries will compare data  of	two  different
	   touch points	and result in invalid analysis.

BUGS
       This  tool  does	 not take finger pressure into account.	The tap	it de-
       tects 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.27.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+14.3.quarterly>

home | help