[PATCH libinput 1/2] libinput: add orientation and size of touch point and pressure to the API

Peter Hutterer peter.hutterer at who-t.net
Thu Nov 12 20:58:54 PST 2015


On Mon, Nov 02, 2015 at 04:56:13PM +0100, Andreas Pokorny wrote:
> This change adds four new properties to touch events:
> * major: diameter of the touch ellipse along the major axis
> * minor: diameter perpendicular to major axis
> * pressure: a pressure value mapped into the range [0, 1]
> * orientation: the angle between major and the x axis [0, 360]
> 
> Those values are optionally supported by multi-touch drivers, so default values
> are used if the information is missing. The existance of each of the properties
> can be queried at the event using another set of libinput_event_touch_has_*
> functions.
> 
> Explanation of those values was added to the touch screen page.
> 
> Signed-off-by: Andreas Pokorny <andreas.pokorny at canonical.com>

did you get my patch to squash in with the documentation updates?
none of those appear to be in here.

Cheers,
   Peter

> ---
>  doc/Makefile.am                                |   2 +
>  doc/page-hierarchy.dox                         |   1 +
>  doc/svg/touchscreen-touch-event-properties.svg | 347 +++++++++++++++++++++++++
>  doc/touch-event-properties.dox                 |  42 +++
>  src/evdev.c                                    | 224 ++++++++++++++--
>  src/evdev.h                                    |  24 ++
>  src/libinput-private.h                         |  13 +-
>  src/libinput-util.h                            |   6 +
>  src/libinput.c                                 | 212 ++++++++++++++-
>  src/libinput.h                                 | 222 ++++++++++++++++
>  src/libinput.sym                               |  13 +
>  test/touch.c                                   | 241 +++++++++++++++++
>  12 files changed, 1315 insertions(+), 32 deletions(-)
>  create mode 100644 doc/svg/touchscreen-touch-event-properties.svg
>  create mode 100644 doc/touch-event-properties.dox
> 
> diff --git a/doc/Makefile.am b/doc/Makefile.am
> index fe70f6a..c0b4f73 100644
> --- a/doc/Makefile.am
> +++ b/doc/Makefile.am
> @@ -26,6 +26,7 @@ header_files = \
>  	$(srcdir)/tapping.dox \
>  	$(srcdir)/test-suite.dox \
>  	$(srcdir)/tools.dox \
> +	$(srcdir)/touch-event-properties.dox \
>  	$(srcdir)/touchpads.dox
>  
>  diagram_files = \
> @@ -50,6 +51,7 @@ diagram_files = \
>  	$(srcdir)/svg/thumb-detection.svg \
>  	$(srcdir)/svg/top-software-buttons.svg \
>  	$(srcdir)/svg/touchscreen-gestures.svg \
> +	$(srcdir)/svg/touchscreen-touch-event-properties.svg \
>  	$(srcdir)/svg/twofinger-scrolling.svg
>  
>  style_files = \
> diff --git a/doc/page-hierarchy.dox b/doc/page-hierarchy.dox
> index 3fdb1f7..aadc87f 100644
> --- a/doc/page-hierarchy.dox
> +++ b/doc/page-hierarchy.dox
> @@ -11,6 +11,7 @@
>  @page touchscreens Touchscreens
>  
>  - @subpage absolute_axes
> +- @subpage touch_event_properties
>  
>  @page pointers Mice, Trackballs, etc.
>  
> diff --git a/doc/svg/touchscreen-touch-event-properties.svg b/doc/svg/touchscreen-touch-event-properties.svg
> new file mode 100644
> index 0000000..b728f40
> --- /dev/null
> +++ b/doc/svg/touchscreen-touch-event-properties.svg
> @@ -0,0 +1,347 @@
> +<?xml version="1.0" encoding="UTF-8" standalone="no"?>
> +<!-- Created with Inkscape (http://www.inkscape.org/) -->
> +
> +<svg
> +   xmlns:dc="http://purl.org/dc/elements/1.1/"
> +   xmlns:cc="http://creativecommons.org/ns#"
> +   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
> +   xmlns:svg="http://www.w3.org/2000/svg"
> +   xmlns="http://www.w3.org/2000/svg"
> +   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
> +   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
> +   width="81.778557mm"
> +   height="107.62305mm"
> +   viewBox="0 0 289.76655 381.34154"
> +   id="svg2"
> +   version="1.1"
> +   inkscape:version="0.91 r13725"
> +   sodipodi:docname="touchscreen-touch-event-properties.svg">
> +  <defs
> +     id="defs4">
> +    <marker
> +       inkscape:stockid="DotL"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="DotL"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4259"
> +         d="m -2.5,-1 c 0,2.76 -2.24,5 -5,5 -2.76,0 -5,-2.24 -5,-5 0,-2.76 2.24,-5 5,-5 2.76,0 5,2.24 5,5 z"
> +         style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
> +         transform="matrix(0.8,0,0,0.8,5.92,0.8)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <marker
> +       inkscape:stockid="CurveOut"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="CurveOut"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4385"
> +         d="m -5.4129913,-5.0456926 c 2.76,0 4.99999999,2.24 4.99999999,5.00000002 0,2.75999998 -2.23999999,4.99999998 -4.99999999,4.99999998"
> +         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
> +         transform="scale(0.6,0.6)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <marker
> +       inkscape:stockid="StopL"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="StopL"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4367"
> +         d="M 0,5.65 0,-5.65"
> +         style="fill:none;fill-opacity:0.75;fill-rule:evenodd;stroke:#000000;stroke-width:1pt;stroke-opacity:1"
> +         transform="scale(0.8,0.8)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <marker
> +       style="overflow:visible"
> +       id="DistanceStart"
> +       refX="0"
> +       refY="0"
> +       orient="auto"
> +       inkscape:stockid="DistanceStart"
> +       inkscape:isstock="true">
> +      <g
> +         id="g2300"
> +         style="fill:#000000;fill-opacity:1;stroke:#000000;stroke-opacity:1">
> +        <path
> +           style="fill:#000000;fill-opacity:1;stroke:#000000;stroke-width:1.14999998;stroke-linecap:square;stroke-opacity:1"
> +           d="M 0,0 2,0"
> +           id="path2306"
> +           inkscape:connector-curvature="0" />
> +        <path
> +           style="fill:#000000;fill-opacity:1;fill-rule:evenodd;stroke:#000000;stroke-opacity:1"
> +           d="M 0,0 13,4 9,0 13,-4 0,0 Z"
> +           id="path2302"
> +           inkscape:connector-curvature="0" />
> +        <path
> +           style="fill:#000000;fill-opacity:1;stroke:#000000;stroke-width:1;stroke-linecap:square;stroke-opacity:1"
> +           d="M 0,-4 0,40"
> +           id="path2304"
> +           inkscape:connector-curvature="0" />
> +      </g>
> +    </marker>
> +    <marker
> +       inkscape:stockid="Arrow2Mend"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="Arrow2Mend"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4225"
> +         style="fill:#cb004e;fill-opacity:1;fill-rule:evenodd;stroke:#cb004e;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
> +         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
> +         transform="scale(-0.6,-0.6)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <marker
> +       inkscape:stockid="Arrow2Lend"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="Arrow2Lend"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4219"
> +         style="fill:#cb004e;fill-opacity:1;fill-rule:evenodd;stroke:#cb004e;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
> +         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
> +         transform="matrix(-1.1,0,0,-1.1,-1.1,0)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <marker
> +       inkscape:stockid="TriangleInL"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="TriangleInL"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4331"
> +         d="m 5.77,0 -8.65,5 0,-10 8.65,5 z"
> +         style="fill:#b3b3b3;fill-opacity:1;fill-rule:evenodd;stroke:#b3b3b3;stroke-width:1pt;stroke-opacity:1"
> +         transform="scale(-0.8,-0.8)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <marker
> +       inkscape:stockid="Arrow2Lstart"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="Arrow2Lstart"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         id="path4216"
> +         style="fill:#cb004e;fill-opacity:1;fill-rule:evenodd;stroke:#cb004e;stroke-width:0.625;stroke-linejoin:round;stroke-opacity:1"
> +         d="M 8.7185878,4.0337352 -2.2072895,0.01601326 8.7185884,-4.0017078 c -1.7454984,2.3720609 -1.7354408,5.6174519 -6e-7,8.035443 z"
> +         transform="matrix(1.1,0,0,1.1,1.1,0)"
> +         inkscape:connector-curvature="0" />
> +    </marker>
> +    <inkscape:path-effect
> +       effect="powerstroke"
> +       id="path-effect4140"
> +       is_visible="true"
> +       offset_points="0,0.5"
> +       sort_points="true"
> +       interpolator_type="Linear"
> +       interpolator_beta="0.2"
> +       start_linecap_type="zerowidth"
> +       linejoin_type="round"
> +       miter_limit="4"
> +       end_linecap_type="zerowidth"
> +       cusp_linecap_type="round" />
> +    <marker
> +       inkscape:stockid="TriangleInL"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="TriangleInL-1"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         inkscape:connector-curvature="0"
> +         id="path4331-8"
> +         d="m 5.77,0 -8.65,5 0,-10 8.65,5 z"
> +         style="fill:#b3b3b3;fill-opacity:1;fill-rule:evenodd;stroke:#b3b3b3;stroke-width:1pt;stroke-opacity:1"
> +         transform="scale(-0.8,-0.8)" />
> +    </marker>
> +    <marker
> +       inkscape:stockid="TriangleInL"
> +       orient="auto"
> +       refY="0"
> +       refX="0"
> +       id="TriangleInL-1-3"
> +       style="overflow:visible"
> +       inkscape:isstock="true">
> +      <path
> +         inkscape:connector-curvature="0"
> +         id="path4331-8-7"
> +         d="m 5.77,0 -8.65,5 0,-10 8.65,5 z"
> +         style="fill:#b3b3b3;fill-opacity:1;fill-rule:evenodd;stroke:#b3b3b3;stroke-width:1pt;stroke-opacity:1"
> +         transform="scale(-0.8,-0.8)" />
> +    </marker>
> +  </defs>
> +  <sodipodi:namedview
> +     id="base"
> +     pagecolor="#ffffff"
> +     bordercolor="#666666"
> +     borderopacity="1.0"
> +     inkscape:pageopacity="0.0"
> +     inkscape:pageshadow="2"
> +     inkscape:zoom="0.99999999"
> +     inkscape:cx="123.83444"
> +     inkscape:cy="279.21547"
> +     inkscape:document-units="px"
> +     inkscape:current-layer="layer1"
> +     showgrid="false"
> +     showguides="false"
> +     inkscape:window-width="2560"
> +     inkscape:window-height="1056"
> +     inkscape:window-x="0"
> +     inkscape:window-y="24"
> +     inkscape:window-maximized="1"
> +     fit-margin-top="0"
> +     fit-margin-left="0"
> +     fit-margin-right="0"
> +     fit-margin-bottom="0" />
> +  <metadata
> +     id="metadata7">
> +    <rdf:RDF>
> +      <cc:Work
> +         rdf:about="">
> +        <dc:format>image/svg+xml</dc:format>
> +        <dc:type
> +           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
> +        <dc:title></dc:title>
> +      </cc:Work>
> +    </rdf:RDF>
> +  </metadata>
> +  <g
> +     inkscape:label="Layer 1"
> +     inkscape:groupmode="layer"
> +     id="layer1"
> +     transform="translate(-99.549825,-70.836892)">
> +    <path
> +       style="fill:#b3b3b3;fill-opacity:1;fill-rule:evenodd;stroke:#b3b3b3;stroke-width:1.79780054px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#TriangleInL-1-3)"
> +       d="m 231.28087,80.931744 -0.008,371.246666"
> +       id="path4144-1-8-1"
> +       inkscape:connector-curvature="0"
> +       sodipodi:nodetypes="cc" />
> +    <g
> +       id="g6309"
> +       inkscape:transform-center-x="-9.527809"
> +       inkscape:transform-center-y="-8.1612127"
> +       transform="matrix(1.171972,1.3632932,-1.3632932,1.171972,275.33248,-179.00364)">
> +      <path
> +         sodipodi:nodetypes="cc"
> +         inkscape:connector-curvature="0"
> +         id="path4144-1-8"
> +         d="m 172.88767,70.631028 -0.004,206.500482"
> +         style="fill:#b3b3b3;fill-opacity:1;fill-rule:evenodd;stroke:#b3b3b3;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-start:url(#TriangleInL-1)" />
> +      <ellipse
> +         ry="77.321434"
> +         rx="45.89286"
> +         cy="180.93364"
> +         cx="172.85715"
> +         id="path4136"
> +         style="fill:none;fill-opacity:1;stroke:#000000;stroke-width:1;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1" />
> +      <path
> +         sodipodi:nodetypes="cc"
> +         inkscape:connector-curvature="0"
> +         id="path4142"
> +         d="m 126.9449,180.93396 91.84596,0.007"
> +         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
> +      <path
> +         sodipodi:nodetypes="cc"
> +         inkscape:connector-curvature="0"
> +         id="path4144"
> +         d="m 172.84766,103.6564 -0.004,154.59727"
> +         style="fill:none;fill-rule:evenodd;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1" />
> +      <text
> +         sodipodi:linespacing="125%"
> +         id="text4146"
> +         y="188.01213"
> +         x="128.08986"
> +         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:7.5px;line-height:125%;font-family:sans-serif;-inkscape-font-specification:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
> +         xml:space="preserve"><tspan
> +           y="188.01213"
> +           x="128.08986"
> +           id="tspan4148"
> +           sodipodi:role="line">minor axis</tspan></text>
> +      <text
> +         transform="matrix(0,-1,1,0,0,0)"
> +         sodipodi:linespacing="125%"
> +         id="text4150"
> +         y="169.33234"
> +         x="-256.35562"
> +         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:7.5px;line-height:125%;font-family:sans-serif;-inkscape-font-specification:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
> +         xml:space="preserve"><tspan
> +           y="169.33234"
> +           x="-256.35562"
> +           id="tspan4152"
> +           sodipodi:role="line">major axis</tspan></text>
> +    </g>
> +    <text
> +       xml:space="preserve"
> +       style="font-style:normal;font-weight:normal;font-size:71.91202545px;line-height:125%;font-family:Sans;letter-spacing:0px;word-spacing:0px;fill:#b3b3b3;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
> +       x="44.285629"
> +       y="369.12045"
> +       id="text6877"
> +       sodipodi:linespacing="125%"
> +       transform="matrix(0.76306478,-0.64632201,0.64632201,0.76306478,0,0)"><tspan
> +         sodipodi:role="line"
> +         id="tspan6879"
> +         x="44.285629"
> +         y="369.12045"
> +         style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:13.4835043px;font-family:sans-serif;-inkscape-font-specification:sans-serif;fill:#b3b3b3;fill-opacity:1">pointing direction</tspan></text>
> +    <text
> +       xml:space="preserve"
> +       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:13.4835043px;line-height:125%;font-family:sans-serif;-inkscape-font-specification:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#b3b3b3;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
> +       x="237.00804"
> +       y="99.788658"
> +       id="text6887"
> +       sodipodi:linespacing="125%"><tspan
> +         sodipodi:role="line"
> +         id="tspan6889"
> +         x="237.00804"
> +         y="99.788658">y axis</tspan></text>
> +    <path
> +       style="fill:none;fill-opacity:1;stroke:#cb004e;stroke-width:1.79780054;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-opacity:1;marker-end:url(#Arrow2Mend)"
> +       id="path7011"
> +       sodipodi:type="arc"
> +       sodipodi:cx="231.14914"
> +       sodipodi:cy="268.54077"
> +       sodipodi:rx="79.092262"
> +       sodipodi:ry="79.092262"
> +       sodipodi:start="4.7157629"
> +       sodipodi:end="5.5461565"
> +       d="m 231.41599,189.44896 a 79.092262,79.092262 0 0 1 58.2985,25.93463"
> +       sodipodi:open="true" />
> +    <text
> +       xml:space="preserve"
> +       style="font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;font-size:8.98900318px;line-height:125%;font-family:sans-serif;-inkscape-font-specification:sans-serif;letter-spacing:0px;word-spacing:0px;fill:#cb004e;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
> +       x="232.66777"
> +       y="184.40468"
> +       id="text7119"
> +       sodipodi:linespacing="125%"><tspan
> +         sodipodi:role="line"
> +         id="tspan7121"
> +         x="232.66777"
> +         y="184.40468"
> +         style="font-size:13.4835043px;fill:#cb004e;fill-opacity:1">orientation</tspan></text>
> +  </g>
> +</svg>
> diff --git a/doc/touch-event-properties.dox b/doc/touch-event-properties.dox
> new file mode 100644
> index 0000000..bf326f7
> --- /dev/null
> +++ b/doc/touch-event-properties.dox
> @@ -0,0 +1,42 @@
> +/**
> + at page touch_event_properties Properties of a touch event
> +
> +This page gives some overview on touchscreen events. With libinput touchscreens
> +provide the event types @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref LIBINPUT_EVENT_TOUCH_UP,
> + at ref LIBINPUT_EVENT_TOUCH_MOTION and @ref LIBINPUT_EVENT_TOUCH_CANCEL. The
> +touchscreen events @ref LIBINPUT_EVENT_TOUCH_DOWN and
> + at ref LIBINPUT_EVENT_TOUCH_MOTION provide alongside the actual state change and
> +the absolute coordinates (@ref absolute_axes_handling) additional information
> +about the touch contact.
> +
> + at image html touchscreen-touch-event-properties.svg "Properties of a touch screen contact"
> +
> +Assuming the interaction of fingers with a touch screen, touch contacts are
> +approximated with an ellipse. The major axis of the ellipse describes the
> +pointing direction of the finger. The minor axis is the perpendicular
> +extent of the touching shape. The orientation angle is the clockwise rotation of
> +the pointing direction against the y-axis of the touchscreen.
> +
> +Additionally to the values shown in the drawing above, most touchscreens also
> +provide a pressure value to indicate the force applied with the contact point.
> +
> +The support for those contact properties varies between the different
> +available touchscreens. In the case of pressure libinput will return the
> +maximum pressure value, which is 1.0. If only the major axis but no minor axis
> +is present, libinput will assume a circular shape and return the major axis
> +value for convenience. If also no major axis value is known 0.0 is returned.
> +If the orientation is not available libinput will return 0.0 degrees.
> +
> +For querying the touch properties see:
> +- libinput_event_touch_get_major_transformed()
> +- libinput_event_touch_get_minor_transformed()
> +- libinput_event_touch_get_orientation()
> +- libinput_event_touch_get_pressure()
> +
> +For testing which of the touch properties are available see:
> +- libinput_event_touch_has_major()
> +- libinput_event_touch_has_minor()
> +- libinput_event_touch_has_orientation()
> +- libinput_event_touch_has_pressure()
> +
> +*/
> diff --git a/src/evdev.c b/src/evdev.c
> index ec3abc6..ea6be05 100644
> --- a/src/evdev.c
> +++ b/src/evdev.c
> @@ -45,6 +45,10 @@
>  
>  #define DEFAULT_WHEEL_CLICK_ANGLE 15
>  #define DEFAULT_MIDDLE_BUTTON_SCROLL_TIMEOUT ms2us(200)
> +#define DEFAULT_TOUCH_PRESSURE 1.0
> +#define DEFAULT_TOUCH_ORIENTATION 0.0
> +#define DEFAULT_TOUCH_MAJOR 0.0
> +#define DEFAULT_TOUCH_MINOR 0.0
>  
>  enum evdev_key_type {
>  	EVDEV_KEY_TYPE_NONE,
> @@ -245,6 +249,100 @@ evdev_device_transform_y(struct evdev_device *device,
>  	return scale_axis(device->abs.absinfo_y, y, height);
>  }
>  
> +double
> +evdev_device_transform_ellipse_diameter_to_mm(struct evdev_device *device,
> +					      int diameter,
> +					      double axis_angle)
> +{
> +	double x_res = device->abs.absinfo_x->resolution;
> +	double y_res = device->abs.absinfo_y->resolution;
> +
> +	if (x_res == y_res)
> +		return diameter / x_res;
> +
> +	/* resolution differs but no orientation available
> +	 * -> estimate resolution using the average */
> +	if (device->abs.absinfo_orientation == NULL) {
> +		return diameter * 2.0 / (x_res + y_res);
> +	} else {
> +		/* Why scale x using sine of angle?
> +		 * axis_angle = 0 indicates that the given diameter
> +		 * is aligned with the y-axis. */
> +		double x_scaling_ratio = fabs(sin(deg2rad(axis_angle)));
> +		double y_scaling_ratio = fabs(cos(deg2rad(axis_angle)));
> +
> +		return diameter / hypotf(y_res * y_scaling_ratio,
> +					 x_res * x_scaling_ratio);
> +	}
> +}
> +
> +double
> +evdev_device_transform_ellipse_diameter(struct evdev_device *device,
> +					int diameter,
> +					double axis_angle,
> +					uint32_t width,
> +					uint32_t height)
> +{
> +	double x_res = device->abs.absinfo_x->resolution;
> +	double y_res = device->abs.absinfo_y->resolution;
> +	double x_scale = width / (device->abs.dimensions.x + 1.0);
> +	double y_scale = height / (device->abs.dimensions.y + 1.0);
> +
> +	if (x_res == y_res)
> +		return diameter * x_scale;
> +
> +	/* no orientation available -> estimate resolution using the
> +	 * average */
> +	if (device->abs.absinfo_orientation == NULL) {
> +		return diameter * (x_scale + y_scale) / 2.0;
> +	} else {
> +		/* Why scale x using sine of angle?
> +		 * axis_angle = 0 indicates that the given diameter
> +		 * is aligned with the y-axis. */
> +		double x_scaling_ratio = fabs(sin(deg2rad(axis_angle)));
> +		double y_scaling_ratio = fabs(cos(deg2rad(axis_angle)));
> +
> +		return diameter * (y_scale * y_scaling_ratio +
> +				   x_scale * x_scaling_ratio);
> +	}
> +}
> +
> +double
> +evdev_device_transform_orientation(struct evdev_device *device,
> +				   int32_t orientation)
> +{
> +	const struct input_absinfo *orientation_info =
> +					device->abs.absinfo_orientation;
> +
> +	double angle = DEFAULT_TOUCH_ORIENTATION;
> +
> +	/* ABS_MT_ORIENTATION is defined as a clockwise rotation - zero
> +	 * (instead of minimum) is mapped to the y-axis, and maximum is
> +	 * mapped to the x-axis. So minimum is likely to be negative but
> +	 * plays no role in scaling the value to degrees.*/
> +	if (orientation_info)
> +		angle = (90.0 * orientation) / orientation_info->maximum;
> +
> +	return fmod(360.0 + angle, 360.0);
> +}
> +
> +double
> +evdev_device_transform_pressure(struct evdev_device *device,
> +				int32_t pressure)
> +{
> +	const struct input_absinfo *pressure_info =
> +					device->abs.absinfo_pressure;
> +
> +	if (pressure_info) {
> +		double max_pressure = pressure_info->maximum;
> +		double min_pressure = pressure_info->minimum;
> +		return (pressure - min_pressure) /
> +					(max_pressure - min_pressure);
> +	} else {
> +		return DEFAULT_TOUCH_PRESSURE;
> +	}
> +}
> +
>  static inline void
>  normalize_delta(struct evdev_device *device,
>  		const struct device_coords *delta,
> @@ -282,8 +380,15 @@ evdev_flush_pending_event(struct evdev_device *device, uint64_t time)
>  	struct normalized_coords accel, unaccel;
>  	struct device_coords point;
>  	struct device_float_coords raw;
> +	struct mt_slot *slot_data;
> +	struct ellipse default_touch = {
> +		.major = DEFAULT_TOUCH_MAJOR,
> +		.minor = DEFAULT_TOUCH_MINOR,
> +		.orientation = DEFAULT_TOUCH_ORIENTATION
> +	};
>  
>  	slot = device->mt.slot;
> +	slot_data = &device->mt.slots[slot];
>  
>  	switch (device->pending_event) {
>  	case EVDEV_NONE:
> @@ -324,7 +429,7 @@ evdev_flush_pending_event(struct evdev_device *device, uint64_t time)
>  		if (!(device->seat_caps & EVDEV_DEVICE_TOUCH))
>  			break;
>  
> -		if (device->mt.slots[slot].seat_slot != -1) {
> +		if (slot_data->seat_slot != -1) {
>  			log_bug_kernel(libinput,
>  				       "%s: Driver sent multiple touch down for the "
>  				       "same slot",
> @@ -333,38 +438,50 @@ evdev_flush_pending_event(struct evdev_device *device, uint64_t time)
>  		}
>  
>  		seat_slot = ffs(~seat->slot_map) - 1;
> -		device->mt.slots[slot].seat_slot = seat_slot;
> +		slot_data->seat_slot = seat_slot;
>  
>  		if (seat_slot == -1)
>  			break;
>  
>  		seat->slot_map |= 1 << seat_slot;
> -		point = device->mt.slots[slot].point;
> +		point = slot_data->point;
>  		transform_absolute(device, &point);
>  
> -		touch_notify_touch_down(base, time, slot, seat_slot,
> -					&point);
> +		touch_notify_touch_down(base,
> +					time,
> +					slot,
> +					seat_slot,
> +					&point,
> +					&slot_data->area,
> +					slot_data->pressure);
>  		break;
>  	case EVDEV_ABSOLUTE_MT_MOTION:
>  		if (!(device->seat_caps & EVDEV_DEVICE_TOUCH))
>  			break;
>  
> -		seat_slot = device->mt.slots[slot].seat_slot;
> -		point = device->mt.slots[slot].point;
> +		seat_slot = slot_data->seat_slot;
> +
> +		point = slot_data->point;
>  
>  		if (seat_slot == -1)
>  			break;
>  
>  		transform_absolute(device, &point);
> -		touch_notify_touch_motion(base, time, slot, seat_slot,
> -					  &point);
> +
> +		touch_notify_touch_motion(base,
> +					  time,
> +					  slot,
> +					  seat_slot,
> +					  &point,
> +					  &slot_data->area,
> +					  slot_data->pressure);
>  		break;
>  	case EVDEV_ABSOLUTE_MT_UP:
>  		if (!(device->seat_caps & EVDEV_DEVICE_TOUCH))
>  			break;
>  
> -		seat_slot = device->mt.slots[slot].seat_slot;
> -		device->mt.slots[slot].seat_slot = -1;
> +		seat_slot = slot_data->seat_slot;
> +		slot_data->seat_slot = -1;
>  
>  		if (seat_slot == -1)
>  			break;
> @@ -396,7 +513,13 @@ evdev_flush_pending_event(struct evdev_device *device, uint64_t time)
>  		point = device->abs.point;
>  		transform_absolute(device, &point);
>  
> -		touch_notify_touch_down(base, time, -1, seat_slot, &point);
> +		touch_notify_touch_down(base,
> +					time,
> +					-1,
> +					seat_slot,
> +					&point,
> +					&default_touch,
> +					DEFAULT_TOUCH_PRESSURE);
>  		break;
>  	case EVDEV_ABSOLUTE_MOTION:
>  		point = device->abs.point;
> @@ -408,8 +531,13 @@ evdev_flush_pending_event(struct evdev_device *device, uint64_t time)
>  			if (seat_slot == -1)
>  				break;
>  
> -			touch_notify_touch_motion(base, time, -1, seat_slot,
> -						  &point);
> +			touch_notify_touch_motion(base,
> +						  time,
> +						  -1,
> +						  seat_slot,
> +						  &point,
> +						  &default_touch,
> +						  DEFAULT_TOUCH_PRESSURE);
>  		} else if (device->seat_caps & EVDEV_DEVICE_POINTER) {
>  			pointer_notify_motion_absolute(base, time, &point);
>  		}
> @@ -569,8 +697,9 @@ evdev_process_touch(struct evdev_device *device,
>  		    struct input_event *e,
>  		    uint64_t time)
>  {
> -	switch (e->code) {
> -	case ABS_MT_SLOT:
> +	struct mt_slot *current_slot = &device->mt.slots[device->mt.slot];
> +
> +	if (e->code == ABS_MT_SLOT) {
>  		if ((size_t)e->value >= device->mt.slots_len) {
>  			log_bug_libinput(device->base.seat->libinput,
>  					 "%s exceeds slots (%d of %zd)\n",
> @@ -581,8 +710,7 @@ evdev_process_touch(struct evdev_device *device,
>  		}
>  		evdev_flush_pending_event(device, time);
>  		device->mt.slot = e->value;
> -		break;
> -	case ABS_MT_TRACKING_ID:
> +	} else if(e->code == ABS_MT_TRACKING_ID) {
>  		if (device->pending_event != EVDEV_NONE &&
>  		    device->pending_event != EVDEV_ABSOLUTE_MT_MOTION)
>  			evdev_flush_pending_event(device, time);
> @@ -590,17 +718,34 @@ evdev_process_touch(struct evdev_device *device,
>  			device->pending_event = EVDEV_ABSOLUTE_MT_DOWN;
>  		else
>  			device->pending_event = EVDEV_ABSOLUTE_MT_UP;
> -		break;
> -	case ABS_MT_POSITION_X:
> -		device->mt.slots[device->mt.slot].point.x = e->value;
> -		if (device->pending_event == EVDEV_NONE)
> -			device->pending_event = EVDEV_ABSOLUTE_MT_MOTION;
> -		break;
> -	case ABS_MT_POSITION_Y:
> -		device->mt.slots[device->mt.slot].point.y = e->value;
> -		if (device->pending_event == EVDEV_NONE)
> +	} else {
> +		bool needs_wake = true;
> +
> +		switch(e->code) {
> +		case ABS_MT_POSITION_X:
> +			current_slot->point.x = e->value;
> +			break;
> +		case ABS_MT_POSITION_Y:
> +			current_slot->point.y = e->value;
> +			break;
> +		case ABS_MT_TOUCH_MAJOR:
> +			current_slot->area.major = e->value;
> +			break;
> +		case ABS_MT_TOUCH_MINOR:
> +			current_slot->area.minor = e->value;
> +			break;
> +		case ABS_MT_ORIENTATION:
> +			current_slot->area.orientation = e->value;
> +			break;
> +		case ABS_MT_PRESSURE:
> +			current_slot->pressure = e->value;
> +			break;
> +		default:
> +			needs_wake = false;
> +			break;
> +		}
> +		if (needs_wake && device->pending_event == EVDEV_NONE)
>  			device->pending_event = EVDEV_ABSOLUTE_MT_MOTION;
> -		break;
>  	}
>  }
>  
> @@ -1954,6 +2099,20 @@ evdev_configure_mt_device(struct evdev_device *device)
>  		slots[slot].point.y = libevdev_get_slot_value(evdev,
>  							      slot,
>  							      ABS_MT_POSITION_Y);
> +		slots[slot].area.major =
> +			libevdev_get_slot_value(evdev,
> +						slot,
> +						ABS_MT_TOUCH_MAJOR);
> +		slots[slot].area.minor =
> +			libevdev_get_slot_value(evdev,
> +						slot,
> +						ABS_MT_TOUCH_MINOR);
> +		slots[slot].area.orientation =
> +			libevdev_get_slot_value(evdev,
> +						slot,
> +						ABS_MT_ORIENTATION);
> +		slots[slot].pressure =
> +			libevdev_get_slot_value(evdev, slot, ABS_MT_PRESSURE);
>  	}
>  	device->mt.slots = slots;
>  	device->mt.slots_len = num_slots;
> @@ -2024,6 +2183,15 @@ evdev_configure_device(struct evdev_device *device)
>  		return -1;
>  	}
>  
> +	device->abs.absinfo_orientation =
> +		libevdev_get_abs_info(evdev, ABS_MT_ORIENTATION);
> +	device->abs.absinfo_pressure =
> +		libevdev_get_abs_info(evdev, ABS_MT_PRESSURE);
> +	device->abs.absinfo_major =
> +		libevdev_get_abs_info(evdev, ABS_MT_TOUCH_MAJOR);
> +	device->abs.absinfo_minor =
> +		libevdev_get_abs_info(evdev, ABS_MT_TOUCH_MINOR);
> +
>  	if (!evdev_is_fake_mt_device(device))
>  		evdev_fix_android_mt(device);
>  
> diff --git a/src/evdev.h b/src/evdev.h
> index e44a65d..7b8d0e6 100644
> --- a/src/evdev.h
> +++ b/src/evdev.h
> @@ -112,6 +112,8 @@ enum evdev_device_model {
>  struct mt_slot {
>  	int32_t seat_slot;
>  	struct device_coords point;
> +	struct ellipse area;
> +	int32_t pressure;
>  };
>  
>  struct evdev_device {
> @@ -128,6 +130,8 @@ struct evdev_device {
>  	int fd;
>  	struct {
>  		const struct input_absinfo *absinfo_x, *absinfo_y;
> +		const struct input_absinfo *absinfo_major, *absinfo_minor,
> +		      *absinfo_pressure, *absinfo_orientation;
>  		int fake_resolution;
>  
>  		struct device_coords point;
> @@ -349,6 +353,26 @@ double
>  evdev_device_transform_y(struct evdev_device *device,
>  			 double y,
>  			 uint32_t height);
> +double
> +evdev_device_transform_ellipse_diameter_to_mm(struct evdev_device *device,
> +					      int32_t diameter,
> +					      double axis_angle);
> +
> +double
> +evdev_device_transform_ellipse_diameter(struct evdev_device *device,
> +					int32_t diameter,
> +					double axis_angle,
> +					uint32_t width,
> +					uint32_t height);
> +
> +double
> +evdev_device_transform_orientation(struct evdev_device *device,
> +				   int32_t orientation);
> +
> +double
> +evdev_device_transform_pressure(struct evdev_device *device,
> +				int32_t pressure);
> +
>  int
>  evdev_device_suspend(struct evdev_device *device);
>  
> diff --git a/src/libinput-private.h b/src/libinput-private.h
> index e146c26..b90c21d 100644
> --- a/src/libinput-private.h
> +++ b/src/libinput-private.h
> @@ -40,6 +40,11 @@ struct device_coords {
>  	int x, y;
>  };
>  
> +/* Ellipse parameters in device coordinates */
> +struct ellipse {
> +	int major, minor, orientation;
> +};
> +
>  /*
>   * A coordinate pair in device coordinates, capable of holding non discrete
>   * values, this is necessary e.g. when device coordinates get averaged.
> @@ -396,14 +401,18 @@ touch_notify_touch_down(struct libinput_device *device,
>  			uint64_t time,
>  			int32_t slot,
>  			int32_t seat_slot,
> -			const struct device_coords *point);
> +			const struct device_coords *point,
> +			const struct ellipse *area,
> +			int32_t pressure);
>  
>  void
>  touch_notify_touch_motion(struct libinput_device *device,
>  			  uint64_t time,
>  			  int32_t slot,
>  			  int32_t seat_slot,
> -			  const struct device_coords *point);
> +			  const struct device_coords *point,
> +			  const struct ellipse *area,
> +			  int32_t pressure);
>  
>  void
>  touch_notify_touch_up(struct libinput_device *device,
> diff --git a/src/libinput-util.h b/src/libinput-util.h
> index ba253b5..9495fa6 100644
> --- a/src/libinput-util.h
> +++ b/src/libinput-util.h
> @@ -118,6 +118,12 @@ msleep(unsigned int ms)
>  	usleep(ms * 1000);
>  }
>  
> +static inline double
> +deg2rad(double angle)
> +{
> +	return angle * M_PI/180.0;
> +}
> +
>  static inline int
>  long_bit_is_set(const unsigned long *array, int bit)
>  {
> diff --git a/src/libinput.c b/src/libinput.c
> index 24f2b69..bdd3d41 100644
> --- a/src/libinput.c
> +++ b/src/libinput.c
> @@ -112,6 +112,8 @@ struct libinput_event_touch {
>  	int32_t slot;
>  	int32_t seat_slot;
>  	struct device_coords point;
> +	struct ellipse area;
> +	int32_t pressure;
>  };
>  
>  struct libinput_event_gesture {
> @@ -732,6 +734,204 @@ libinput_event_touch_get_y(struct libinput_event_touch *event)
>  	return evdev_convert_to_mm(device->abs.absinfo_y, event->point.y);
>  }
>  
> +LIBINPUT_EXPORT double
> +libinput_event_touch_get_major(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +	double angle;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	angle = evdev_device_transform_orientation(device,
> +						   event->area.orientation);
> +
> +	return evdev_device_transform_ellipse_diameter_to_mm(device,
> +							     event->area.major,
> +							     angle);
> +}
> +
> +LIBINPUT_EXPORT double
> +libinput_event_touch_get_major_transformed(struct libinput_event_touch *event,
> +					   uint32_t width,
> +					   uint32_t height)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +	double angle;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	angle = evdev_device_transform_orientation(device,
> +						   event->area.orientation);
> +
> +	return evdev_device_transform_ellipse_diameter(device,
> +						       event->area.major,
> +						       angle,
> +						       width,
> +						       height);
> +}
> +
> +LIBINPUT_EXPORT int
> +libinput_event_touch_has_major(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	return device->abs.absinfo_major != 0;
> +}
> +
> +LIBINPUT_EXPORT double
> +libinput_event_touch_get_minor(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +	double angle;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	angle = evdev_device_transform_orientation(device,
> +						   event->area.orientation);
> +
> +	/* angle + 90 since the minor diameter is perpendicular to the
> +	 * major axis */
> +	return evdev_device_transform_ellipse_diameter_to_mm(device,
> +							     event->area.minor,
> +							     angle + 90.0);
> +
> +}
> +
> +LIBINPUT_EXPORT double
> +libinput_event_touch_get_minor_transformed(struct libinput_event_touch *event,
> +					   uint32_t width,
> +					   uint32_t height)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +	double angle;
> +	int diameter;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	angle = evdev_device_transform_orientation(device,
> +						   event->area.orientation);
> +
> +	/* use major diameter if minor is not available, but if it is
> +	 * add 90 since the minor diameter is perpendicular to the
> +	 * major axis */
> +	if (device->abs.absinfo_minor) {
> +		diameter = event->area.minor,
> +		angle += 90.0;
> +	} else {
> +		diameter = event->area.major;
> +	}
> +
> +	return evdev_device_transform_ellipse_diameter(device,
> +						       diameter,
> +						       angle,
> +						       width,
> +						       height);
> +}
> +
> +LIBINPUT_EXPORT int
> +libinput_event_touch_has_minor(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	return device->abs.absinfo_minor != 0;
> +}
> +
> +LIBINPUT_EXPORT double
> +libinput_event_touch_get_orientation(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	return evdev_device_transform_orientation(device,
> +						  event->area.orientation);
> +}
> +
> +LIBINPUT_EXPORT int
> +libinput_event_touch_has_orientation(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	return device->abs.absinfo_orientation != 0;
> +}
> +
> +LIBINPUT_EXPORT double
> +libinput_event_touch_get_pressure(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	return evdev_device_transform_pressure(device,
> +					       event->pressure);
> +}
> +
> +LIBINPUT_EXPORT int
> +libinput_event_touch_has_pressure(struct libinput_event_touch *event)
> +{
> +	struct evdev_device *device =
> +		(struct evdev_device *) event->base.device;
> +
> +	require_event_type(libinput_event_get_context(&event->base),
> +			   event->base.type,
> +			   0,
> +			   LIBINPUT_EVENT_TOUCH_DOWN,
> +			   LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	return device->abs.absinfo_pressure != 0;
> +}
> +
>  LIBINPUT_EXPORT uint32_t
>  libinput_event_gesture_get_time(struct libinput_event_gesture *event)
>  {
> @@ -1512,7 +1712,9 @@ touch_notify_touch_down(struct libinput_device *device,
>  			uint64_t time,
>  			int32_t slot,
>  			int32_t seat_slot,
> -			const struct device_coords *point)
> +			const struct device_coords *point,
> +			const struct ellipse *area,
> +			int32_t pressure)
>  {
>  	struct libinput_event_touch *touch_event;
>  
> @@ -1528,6 +1730,8 @@ touch_notify_touch_down(struct libinput_device *device,
>  		.slot = slot,
>  		.seat_slot = seat_slot,
>  		.point = *point,
> +		.area = *area,
> +		.pressure = pressure,
>  	};
>  
>  	post_device_event(device, time,
> @@ -1540,7 +1744,9 @@ touch_notify_touch_motion(struct libinput_device *device,
>  			  uint64_t time,
>  			  int32_t slot,
>  			  int32_t seat_slot,
> -			  const struct device_coords *point)
> +			  const struct device_coords *point,
> +			  const struct ellipse *area,
> +			  int32_t pressure)
>  {
>  	struct libinput_event_touch *touch_event;
>  
> @@ -1556,6 +1762,8 @@ touch_notify_touch_motion(struct libinput_device *device,
>  		.slot = slot,
>  		.seat_slot = seat_slot,
>  		.point = *point,
> +		.area = *area,
> +		.pressure = pressure,
>  	};
>  
>  	post_device_event(device, time,
> diff --git a/src/libinput.h b/src/libinput.h
> index 9057446..1c50c58 100644
> --- a/src/libinput.h
> +++ b/src/libinput.h
> @@ -968,6 +968,228 @@ libinput_event_touch_get_y_transformed(struct libinput_event_touch *event,
>  /**
>   * @ingroup event_touch
>   *
> + * Return the diameter of the major axis of the touch ellipse in mm.
> + * This value might not be provided by the device, in that case the value
> + * 0.0 is returned.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION, this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return The current major axis diameter
> + */
> +double
> +libinput_event_touch_get_major(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return the diameter of the major axis of the touch ellipse in screen
> + * space. This value might not be provided by the device, in that case the
> + * value 0.0 is returned.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @param width The current output screen width
> + * @param height The current output screen height
> + * @return The current major axis diameter
> + */
> +double
> +libinput_event_touch_get_major_transformed(struct libinput_event_touch *event,
> +					   uint32_t width,
> +					   uint32_t height);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return if the event contains a major axis value of the touch ellipse.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION, this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return Non-zero when a major diameter is available
> + */
> +int
> +libinput_event_touch_has_major(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return the diameter of the minor axis of the touch ellipse in mm.
> + * This value might not be provided by the device, in this case the value
> + * 0.0 is returned.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return The current minor diameter
> + */
> +double
> +libinput_event_touch_get_minor(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return the diameter of the minor axis of the touch ellipse in screen
> + * space. This value might not be provided by the device, in this case
> + * the value 0.0 is returned.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @param width The current output screen width
> + * @param height The current output screen height
> + * @return The current minor diameter
> + */
> +double
> +libinput_event_touch_get_minor_transformed(struct libinput_event_touch *event,
> +					   uint32_t width,
> +					   uint32_t height);
> +/**
> + * @ingroup event_touch
> + *
> + * Return if the event contains a minor axis value of the touch ellipse.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION, this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return Non-zero when a minor diameter is available
> + */
> +int
> +libinput_event_touch_has_minor(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return the pressure value applied to the touch contact normalized to the
> + * range [0, 1]. If this value is not available the function returns the maximum
> + * value 1.0.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return The current pressure value
> + */
> +double
> +libinput_event_touch_get_pressure(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return if the event contains a pressure value for the touch contact.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION, this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return Non-zero when a pressure value is available
> + */
> +int
> +libinput_event_touch_has_pressure(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return the major axis rotation in degrees, clockwise from the logical north
> + * of the touch screen.
> + *
> + * @note Even when the orientation is measured by the device, it might be only
> + * available in coarse steps (e.g only indicating alignment with either of the
> + * axes).
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION, this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return The current orientation value
> + */
> +double
> +libinput_event_touch_get_orientation(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
> + * Return if the event contains a orientation value for the touch contact.
> + *
> + * A more detailed explanation can be found in @ref touch_event_properties.
> + *
> + * For events not of type @ref LIBINPUT_EVENT_TOUCH_DOWN, @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION, this function returns 0.
> + *
> + * @note It is an application bug to call this function for events of type
> + * other than @ref LIBINPUT_EVENT_TOUCH_DOWN or @ref
> + * LIBINPUT_EVENT_TOUCH_MOTION.
> + *
> + * @param event The libinput touch event
> + * @return Non-zero when an orientation value is available
> + */
> +int
> +libinput_event_touch_has_orientation(struct libinput_event_touch *event);
> +
> +/**
> + * @ingroup event_touch
> + *
>   * @return The generic libinput_event of this event
>   */
>  struct libinput_event *
> diff --git a/src/libinput.sym b/src/libinput.sym
> index 15203c8..23d7975 100644
> --- a/src/libinput.sym
> +++ b/src/libinput.sym
> @@ -179,3 +179,16 @@ LIBINPUT_1.1 {
>  	libinput_device_config_accel_get_default_profile;
>  	libinput_device_config_accel_set_profile;
>  } LIBINPUT_0.21.0;
> +
> +LIBINPUT_1.1_unreleased {
> +	libinput_event_touch_get_major;
> +	libinput_event_touch_get_major_transformed;
> +	libinput_event_touch_get_minor;
> +	libinput_event_touch_get_minor_transformed;
> +	libinput_event_touch_get_orientation;
> +	libinput_event_touch_get_pressure;
> +	libinput_event_touch_has_major;
> +	libinput_event_touch_has_minor;
> +	libinput_event_touch_has_orientation;
> +	libinput_event_touch_has_pressure;
> +} LIBINPUT_1.1;
> diff --git a/test/touch.c b/test/touch.c
> index eae8007..ab30914 100644
> --- a/test/touch.c
> +++ b/test/touch.c
> @@ -673,6 +673,245 @@ START_TEST(touch_time_usec)
>  }
>  END_TEST
>  
> +static inline double calc_diameter_scale(double x_res,
> +					 double y_res,
> +					 double orientation)
> +{
> +	double orientation_rad = deg2rad(orientation);
> +	if (x_res == y_res)
> +		return x_res;
> +
> +	return hypotf(y_res * fabs(cos(orientation_rad)),
> +		      x_res * fabs(sin(orientation_rad)));
> +}
> +
> +static inline bool exceeds_range(const struct input_absinfo *info,
> +				 int value)
> +{
> +	return !info || (info->minimum > value) || (info->maximum < value);
> +}
> +
> +START_TEST(touch_point_properties)
> +{
> +	struct litest_device *dev = litest_current_device();
> +	struct libinput *li = dev->libinput;
> +	struct libinput_event *ev;
> +	struct libinput_event_touch *tev;
> +
> +	const int touch_x = 50;
> +	const int touch_y = 90;
> +	const int input_orientation = 64;
> +	const int input_pressure = 128;
> +	const int input_major = 14;
> +	const int input_minor= 8;
> +
> +	const int input_orientation_2 = 128;
> +	const int input_major_2 = 30;
> +
> +	struct axis_replacement down_values[] = {
> +		{ABS_MT_PRESSURE, input_pressure},
> +		{ABS_MT_ORIENTATION, input_orientation},
> +		{ABS_MT_TOUCH_MAJOR, input_major},
> +		{ABS_MT_TOUCH_MINOR, input_minor},
> +		{-1, -1}};
> +	struct axis_replacement move_values[] = {
> +		{ABS_MT_ORIENTATION, input_orientation_2},
> +		{ABS_MT_TOUCH_MAJOR, input_major_2},
> +		{-1, -1}};
> +	const struct input_absinfo *orientation_info;
> +	const struct input_absinfo *pressure_info;
> +	const struct input_absinfo *major_info;
> +	const struct input_absinfo *minor_info;
> +	const struct input_absinfo *x_info, *y_info;
> +
> +	double x_res, y_res, touch_minor_scale, touch_major_scale;
> +
> +	double expected_major;
> +	double expected_minor;
> +	double expected_orientation;
> +	double expected_pressure;
> +
> +	pressure_info = libevdev_get_abs_info(dev->evdev, ABS_MT_PRESSURE);
> +	orientation_info = libevdev_get_abs_info(dev->evdev, ABS_MT_ORIENTATION);
> +	major_info = libevdev_get_abs_info(dev->evdev, ABS_MT_TOUCH_MAJOR);
> +	minor_info = libevdev_get_abs_info(dev->evdev, ABS_MT_TOUCH_MINOR);
> +	x_info = libevdev_get_abs_info(dev->evdev, ABS_MT_POSITION_X);
> +	y_info = libevdev_get_abs_info(dev->evdev, ABS_MT_POSITION_Y);
> +
> +	if (!orientation_info || !pressure_info || !major_info || !minor_info)
> +		return;
> +
> +	if (exceeds_range(pressure_info, input_pressure) ||
> +	    exceeds_range(major_info, input_major) ||
> +	    exceeds_range(major_info, input_major_2) ||
> +	    exceeds_range(minor_info, input_minor) ||
> +	    exceeds_range(orientation_info, input_orientation) ||
> +	    exceeds_range(orientation_info, input_orientation_2)) {
> +		fprintf(stderr,
> +			"%s does not support the required value ranges\n",
> +			libinput_device_get_name(dev->libinput_device));
> +		return;
> +        }
> +
> +	x_res = x_info->resolution ? x_info->resolution : 1;
> +	y_res = y_info->resolution ? y_info->resolution : 1;
> +
> +	expected_orientation = 90.0 * input_orientation /
> +				orientation_info->maximum;
> +	touch_major_scale = calc_diameter_scale(x_res,
> +						y_res,
> +						expected_orientation);
> +	touch_minor_scale = calc_diameter_scale(x_res,
> +						y_res,
> +						expected_orientation + 90.0);
> +	expected_major = input_major / touch_major_scale;
> +	expected_minor = input_minor / touch_minor_scale;
> +	expected_pressure = (double)input_pressure / (pressure_info->maximum -
> +						      pressure_info->minimum);
> +
> +	litest_drain_events(li);
> +
> +	litest_touch_down_extended(dev, 0, touch_x, touch_y, down_values);
> +
> +	litest_wait_for_event(li);
> +	ev = libinput_get_event(li);
> +	tev = litest_is_touch_event(ev, LIBINPUT_EVENT_TOUCH_DOWN);
> +
> +	ck_assert_double_eq(libinput_event_touch_get_pressure(tev),
> +			    expected_pressure);
> +	ck_assert_double_eq(libinput_event_touch_get_orientation(tev),
> +			    expected_orientation);
> +	ck_assert_double_eq(libinput_event_touch_get_major(tev),
> +			    expected_major);
> +	ck_assert_double_eq(libinput_event_touch_get_minor(tev),
> +			    expected_minor);
> +
> +	litest_touch_move_extended(dev, 0, touch_x, touch_y, move_values);
> +
> +	do {
> +		libinput_event_destroy(ev);
> +		litest_wait_for_event(li);
> +		ev = libinput_get_event(li);
> +	} while (libinput_event_get_type(ev) == LIBINPUT_EVENT_TOUCH_FRAME);
> +
> +	tev = litest_is_touch_event(ev, LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	expected_orientation = 90.0 * input_orientation_2 /
> +				orientation_info->maximum;
> +	touch_major_scale = calc_diameter_scale(x_res,
> +						y_res,
> +						expected_orientation);
> +	expected_major = input_major_2 / touch_major_scale;
> +
> +	ck_assert_double_eq(libinput_event_touch_get_pressure(tev),
> +			    expected_pressure);
> +	ck_assert_double_eq(libinput_event_touch_get_orientation(tev),
> +			    expected_orientation);
> +	ck_assert_double_eq(libinput_event_touch_get_major(tev),
> +			    expected_major);
> +	ck_assert_double_eq(libinput_event_touch_get_minor(tev),
> +			    expected_minor);
> +
> +	libinput_event_destroy(ev);
> +}
> +END_TEST
> +
> +START_TEST(touch_point_no_minor_or_orientation)
> +{
> +	struct litest_device *dev = litest_current_device();
> +	struct libinput *li = dev->libinput;
> +	struct libinput_event *ev;
> +	struct libinput_event_touch *tev;
> +	const int touch_x = 50;
> +	const int touch_y = 90;
> +	const int input_pressure = 43;
> +	const int input_major = 23;
> +	const int input_major_2 = 30;
> +
> +	struct axis_replacement down_values[] = {
> +		{ABS_MT_PRESSURE, input_pressure},
> +		{ABS_MT_TOUCH_MAJOR, input_major},
> +		{-1, -1}};
> +	struct axis_replacement move_values[] = {
> +		{ABS_MT_TOUCH_MAJOR, input_major_2},
> +		{-1, -1}};
> +
> +	const struct input_absinfo *orientation_info;
> +	const struct input_absinfo *pressure_info;
> +	const struct input_absinfo *x_info;
> +	const struct input_absinfo *major_info;
> +	double touch_major_scale;
> +
> +	double expected_major;
> +	double expected_minor;
> +	double expected_orientation = 0.0;
> +	double expected_pressure;
> +
> +	x_info = libevdev_get_abs_info(dev->evdev, ABS_MT_POSITION_X);
> +	pressure_info = libevdev_get_abs_info(dev->evdev, ABS_MT_PRESSURE);
> +	major_info = libevdev_get_abs_info(dev->evdev, ABS_MT_TOUCH_MAJOR);
> +	orientation_info = libevdev_get_abs_info(dev->evdev,
> +						 ABS_MT_ORIENTATION);
> +
> +	if (orientation_info || !pressure_info || !x_info || !major_info ||
> +	    !libevdev_has_event_code(dev->evdev, EV_ABS, ABS_MT_TOUCH_MAJOR) ||
> +	    libevdev_has_event_code(dev->evdev, EV_ABS, ABS_MT_TOUCH_MINOR))
> +		return;
> +
> +	if (exceeds_range(pressure_info, input_pressure) ||
> +	    exceeds_range(major_info, input_major) ||
> +	    exceeds_range(major_info, input_major_2)) {
> +		fprintf(stderr,
> +			"%s does not support the required value ranges\n",
> +			libinput_device_get_name(dev->libinput_device));
> +		return;
> +        }
> +
> +	expected_pressure = (double) input_pressure /
> +			(pressure_info->maximum - pressure_info->minimum);
> +	touch_major_scale = x_info->resolution ? x_info->resolution : 1;
> +	expected_major = input_major / touch_major_scale;
> +	expected_minor = expected_major;
> +
> +	litest_drain_events(li);
> +
> +	litest_touch_down_extended(dev, 0, touch_x, touch_y, down_values);
> +
> +	litest_wait_for_event(li);
> +	ev = libinput_get_event(li);
> +	tev = litest_is_touch_event(ev, LIBINPUT_EVENT_TOUCH_DOWN);
> +
> +	ck_assert_double_eq(libinput_event_touch_get_orientation(tev),
> +			    expected_orientation);
> +	ck_assert_double_eq(libinput_event_touch_get_pressure(tev),
> +			    expected_pressure);
> +	ck_assert_double_eq(libinput_event_touch_get_major(tev),
> +			    expected_major);
> +	ck_assert_double_eq(libinput_event_touch_get_minor(tev),
> +			    expected_minor);
> +
> +	expected_major = input_major_2 / touch_major_scale;
> +	expected_minor = expected_major;
> +
> +	litest_touch_move_extended(dev, 0, touch_x, touch_y, move_values);
> +
> +	do {
> +		libinput_event_destroy(ev);
> +		litest_wait_for_event(li);
> +		ev = libinput_get_event(li);
> +	} while (libinput_event_get_type(ev) == LIBINPUT_EVENT_TOUCH_FRAME);
> +
> +	tev = litest_is_touch_event(ev, LIBINPUT_EVENT_TOUCH_MOTION);
> +
> +	ck_assert_double_eq(libinput_event_touch_get_major(tev),
> +			    expected_major);
> +	ck_assert_double_eq(libinput_event_touch_get_minor(tev),
> +			    expected_minor);
> +
> +	libinput_event_destroy(ev);
> +}
> +END_TEST
> +
>  void
>  litest_setup_tests(void)
>  {
> @@ -697,6 +936,8 @@ litest_setup_tests(void)
>  	litest_add("touch:protocol a", touch_protocol_a_init, LITEST_PROTOCOL_A, LITEST_ANY);
>  	litest_add("touch:protocol a", touch_protocol_a_touch, LITEST_PROTOCOL_A, LITEST_ANY);
>  	litest_add("touch:protocol a", touch_protocol_a_2fg_touch, LITEST_PROTOCOL_A, LITEST_ANY);
> +	litest_add("touch:properties", touch_point_properties, LITEST_TOUCH|LITEST_ELLIPSE, LITEST_ANY);
> +	litest_add("touch:properties", touch_point_no_minor_or_orientation, LITEST_TOUCH|LITEST_ELLIPSE, LITEST_ANY);
>  
>  	litest_add_ranged("touch:state", touch_initial_state, LITEST_TOUCH, LITEST_PROTOCOL_A, &axes);
>  
> -- 
> 2.5.0
> 


More information about the wayland-devel mailing list