--- Begin Message ---
- To: Debian Bug Tracking System <submit@bugs.debian.org>
- Subject: xserver-xorg-input-evtouch: Additional documentation on configuring.
- From: Brett Wuth <wuth@castrov.cuug.ab.ca>
- Date: Thu, 15 Jan 2009 19:21:01 -0700
- Message-id: <20090116022101.15069.14682.reportbug@macbook.castrov.cuug.ab.ca>
Package: xserver-xorg-input-evtouch
Version: 0.8.7-3
Severity: minor
Tags: patch
The documentation on configuring evtouch is sparse and incomplete.
The attached patch includes a dump of Quortech's internal wiki page
where all the configuration options in xorg.conf have been identified
and an initial description created. Sample configuration are
provided.
-- System Information:
Debian Release: 4.0
APT prefers stable
APT policy: (500, 'stable')
Architecture: i386 (i686)
Shell: /bin/sh linked to /bin/bash
Kernel: Linux 2.6.22-14-generic
Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8)
# Description: This patch adds some documentation to evtouch.
#
# Changes
# o Add configuring.html, a dump of Quortech.com's wiki documentation
# on what has been determined about configuration options supported
# by evtouch.
#
# Feel free to send comments, critics, suggestions to wuth@acm.org. To
# apply simply change into the toplevel directory of the source to be
# modified and enter: patch -p1 < <PATH_TO_PATCH>
#
# All patches are available under the GNU GPL, I hope they might be
# useful for you (-:
# - Brett Wuth
#
Index: xf86-input-evtouch-0.8.7/configuring.html
===================================================================
--- /dev/null 1970-01-01 00:00:00.000000000 +0000
+++ xf86-input-evtouch-0.8.7/configuring.html 2009-01-15 18:02:40.000000000 -0700
@@ -0,0 +1,662 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" dir="ltr" lang="en"><head>
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+ <meta name="keywords" content="Eclipse Project/evtouch/Configuring,Eclipse Project/evtouch/Configuring/Click on touch,Eclipse Project/evtouch">
+<link rel="shortcut icon" href="http://wiki.qts.quortech.com/favicon.ico"><title>Eclipse Project/evtouch/Configuring - QuortechWiki</title>
+
+ <style type="text/css" media="screen,projection">/*<![CDATA[*/ @import "/mediawiki/skins/monobook/main.css?9"; /*]]>*/</style>
+ <link rel="stylesheet" type="text/css" href="configuring_files/commonPrint.css"><!--[if lt IE 5.5000]><style type="text/css">@import "/mediawiki/skins/monobook/IE50Fixes.css";</style><![endif]--><!--[if IE 5.5000]><style type="text/css">@import "/mediawiki/skins/monobook/IE55Fixes.css";</style><![endif]--><!--[if IE 6]><style type="text/css">@import "/mediawiki/skins/monobook/IE60Fixes.css";</style><![endif]--><!--[if IE 7]><style type="text/css">@import "/mediawiki/skins/monobook/IE70Fixes.css?1";</style><![endif]--><!--[if lt IE 7]><script type="text/javascript" src="/mediawiki/skins/common/IEFixes.js"></script>
+ <meta http-equiv="imagetoolbar" content="no" /><![endif]-->
+
+
+
+
+
+ <script type="text/javascript">var skin = 'monobook';var stylepath = '/mediawiki/skins';</script>
+ <script type="text/javascript" src="configuring_files/wikibits.js"><!-- wikibits js --></script>
+ <script type="text/javascript" src="configuring_files/index.php"><!-- site js --></script>
+ <style type="text/css">/*<![CDATA[*/
+@import "/mediawiki/index.php?title=MediaWiki:Common.css&action=raw&ctype=text/css&smaxage=18000";
+@import "/mediawiki/index.php?title=MediaWiki:Monobook.css&action=raw&ctype=text/css&smaxage=18000";
+@import "/mediawiki/index.php?title=-&action=raw&gen=css&maxage=18000";
+/*]]>*/</style><!-- Head Scripts --></head><body onload="setupRightClickEdit()" class="ns-0 ltr">
+ <div id="globalWrapper">
+ <div id="column-content">
+ <div id="content">
+ <a name="top" id="top"></a>
+ <h1 class="firstHeading">Eclipse Project/evtouch/Configuring</h1>
+ <div id="bodyContent">
+ <h3 id="siteSub">From QuortechWiki</h3>
+ <div id="contentSub"><span class="subpages">< <a href="http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project" title="Eclipse Project">Eclipse Project</a> | <a href="http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project/evtouch" title="Eclipse Project/evtouch">evtouch</a></span></div>
+ <div id="jump-to-nav">Jump to: <a href="#column-one">navigation</a>, <a href="#searchInput">search</a></div> <!-- start content -->
+ <p><a href="http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project/evtouch" title="Eclipse Project/evtouch">EVTouch</a> is configured in xorg.conf.
+</p>
+<table id="toc" class="toc" summary="Contents"><tbody><tr><td><div id="toctitle"><h2>Contents</h2> <span class="toctoggle">[<a href="javascript:toggleToc()" class="internal" id="togglelink">hide</a>]</span></div>
+<ul>
+<li class="toclevel-1"><a href="#examples"><span class="tocnumber">1</span> <span class="toctext">examples</span></a>
+<ul>
+<li class="toclevel-2"><a href="#disabled"><span class="tocnumber">1.1</span> <span class="toctext">disabled</span></a></li>
+<li class="toclevel-2"><a href="#click_on_touch"><span class="tocnumber">1.2</span> <span class="toctext">click on touch</span></a></li>
+<li class="toclevel-2"><a href="#early_production_configuration"><span class="tocnumber">1.3</span> <span class="toctext">early production configuration</span></a></li>
+</ul>
+</li>
+<li class="toclevel-1"><a href="#options"><span class="tocnumber">2</span> <span class="toctext">options</span></a>
+<ul>
+<li class="toclevel-2"><a href="#general"><span class="tocnumber">2.1</span> <span class="toctext">general</span></a></li>
+<li class="toclevel-2"><a href="#coordinates"><span class="tocnumber">2.2</span> <span class="toctext">coordinates</span></a></li>
+<li class="toclevel-2"><a href="#states"><span class="tocnumber">2.3</span> <span class="toctext">states</span></a>
+<ul>
+<li class="toclevel-3"><a href="#S_UNTOUCHED"><span class="tocnumber">2.3.1</span> <span class="toctext">S_UNTOUCHED</span></a></li>
+<li class="toclevel-3"><a href="#S_TOUCHED"><span class="tocnumber">2.3.2</span> <span class="toctext">S_TOUCHED</span></a></li>
+<li class="toclevel-3"><a href="#S_LONGTOUCHED"><span class="tocnumber">2.3.3</span> <span class="toctext">S_LONGTOUCHED</span></a></li>
+<li class="toclevel-3"><a href="#S_MOVING"><span class="tocnumber">2.3.4</span> <span class="toctext">S_MOVING</span></a></li>
+<li class="toclevel-3"><a href="#S_MAYBETAPPED"><span class="tocnumber">2.3.5</span> <span class="toctext">S_MAYBETAPPED</span></a></li>
+<li class="toclevel-3"><a href="#S_ONEANDAHALFTAP"><span class="tocnumber">2.3.6</span> <span class="toctext">S_ONEANDAHALFTAP</span></a></li>
+<li class="toclevel-3"><a href="#issued_events"><span class="tocnumber">2.3.7</span> <span class="toctext">issued events</span></a></li>
+<li class="toclevel-3"><a href="#actions"><span class="tocnumber">2.3.8</span> <span class="toctext">actions</span></a>
+<ul>
+<li class="toclevel-4"><a href="#btn_down_action"><span class="tocnumber">2.3.8.1</span> <span class="toctext">btn_down_action</span></a></li>
+<li class="toclevel-4"><a href="#btn_up_action"><span class="tocnumber">2.3.8.2</span> <span class="toctext">btn_up_action</span></a></li>
+<li class="toclevel-4"><a href="#btn_click_action"><span class="tocnumber">2.3.8.3</span> <span class="toctext">btn_click_action</span></a></li>
+</ul>
+</li>
+<li class="toclevel-3"><a href="#variables"><span class="tocnumber">2.3.9</span> <span class="toctext">variables</span></a></li>
+<li class="toclevel-3"><a href="#timer_values"><span class="tocnumber">2.3.10</span> <span class="toctext">timer values</span></a></li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</td></tr></tbody></table><script type="text/javascript"> if (window.showTocToggle) { var tocShowText = "show"; var tocHideText = "hide"; showTocToggle(); } </script>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=1" title="Edit section: examples">edit</a>]</div><a name="examples"></a><h2>1 examples </h2>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=2" title="Edit section: disabled">edit</a>]</div><a name="disabled"></a><h3>1.1 disabled </h3>
+<p>To disable the touch screen
+</p><p>Add the section:
+</p>
+<pre>Section "InputDevice"
+ Identifier "NoPointer"
+ Driver "mouse"
+ Option "CorePointer"
+ Option "Device" "/dev/input/NoDevice"
+EndSection
+</pre>
+<p>This section must be removed or commented out to reenable. (Probably a consequence of the <code>Option "CorePointer"</code>.)
+</p><p>Change the ServerLayout to
+</p>
+<pre>Section "ServerLayout"
+ Identifier "Default"
+# InputDevice "touchscreen0" "CorePointer"
+ InputDevice "NoPointer" "CorePointer"
+ Screen "DefaultScreen"
+EndSection
+</pre>
+<p>And run X like this:
+</p>
+<pre>Xorg -allowMouseOpenFail &
+</pre>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=3" title="Edit section: click on touch">edit</a>]</div><a name="click_on_touch"></a><h3>1.2 click on touch </h3>
+<table style="border: 1px solid rgb(170, 170, 170);">
+<caption> <font size="1"><i><a href="http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project/evtouch/Configuring/Click_on_touch" title="Eclipse Project/evtouch/Configuring/Click on touch">Eclipse Project/evtouch/Configuring/Click on touch</a>:</i></font>
+</caption>
+<tbody><tr>
+<td>
+<p>In order to activate a disabled touch screen <i>and</i> configure it to click before the finger is lifted from the screen, make the following changes.
+</p><p>Edit /etc/X11/xorg.conf to change the "InputDevice" section to look like this:
+</p>
+<pre>Section "InputDevice"
+ Identifier "touchscreen0"
+ Driver "evtouch"
+ Option "Device" "/dev/input/event0"
+ Option "DeviceName" "touchscreen"
+
+ Option "SendCoreEvents" "On"
+
+ # Calibration data
+ Option "MinX" "799"
+ Option "MaxX" "3087"
+ Option "MinY" "1402"
+ Option "MaxY" "3150"
+
+ # Treat any touch as a click
+ Option "LongTouchTimer" "0"
+ Option "longtouched_action" "click"
+ Option "longtouched_button" "1"
+
+ # Should never be able to get to this state. Ignore.
+ Option "TapTimer" "0"
+ Option "maybetapped_action" "up"
+ Option "maybetapped_button" "1"
+
+ # Should never be able to get to this state. Ignore.
+ Option "oneandahalftap_action" "up"
+ Option "oneandahalftap_button" "1"
+
+ # Any movement is reported.
+ # Click has already been posted.
+ Option "MoveLimit" "0"
+EndSection
+</pre>
+<p>You can keep the Calibration Data from the previous version.
+</p><p>Comment out the "NoPointer" device:
+</p>
+<pre>#Section "InputDevice"
+# Identifier "NoPointer"
+# Driver "mouse"
+# Option "CorePointer"
+# Option "Device" "/dev/input/NoDevice"
+#EndSection
+</pre>
+<p>And change the "ServerLayout" Section
+</p>
+<pre>Section "ServerLayout"
+ Identifier "Default"
+ InputDevice "touchscreen0" "CorePointer"
+# InputDevice "NoPointer" "CorePointer"
+ Screen "DefaultScreen"
+EndSection
+</pre>
+</td></tr></tbody></table>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=4" title="Edit section: early production configuration">edit</a>]</div><a name="early_production_configuration"></a><h3>1.3 early production configuration </h3>
+<p>This was the first production configuration:
+</p><p>Add this section:
+</p>
+<pre>Section "InputDevice"
+ Identifier "touchscreen0"
+ Driver "evtouch"
+ Option "Device" "/dev/input/evtouch_event"
+ Option "DeviceName" "touchscreen"
+
+ Option "ReportingMode" "Raw"
+
+ # calibration data
+ Option "MinX" "846"
+ Option "MaxX" "3144"
+ Option "MinY" "1306"
+ Option "MaxY" "3094"
+
+ Option "MoveLimit" "10"
+
+ Option "SendCoreEvents" "On"
+
+ # Milliseconds of continuous touching to be treated as a long touch.
+ # In earlier versions of evtouch, there was no easy way to disable this,
+ # so we use a very long value: 100s.
+ Option "LongTouchTimer" "100000"
+
+ # treat long touched as an innocuous event
+ Option "longtouched_action" "up"
+ Option "longtouched_button" "0"
+
+ # milliseconds of continuous release to finish a tap
+ Option "TapTimer" "10"
+# defaults:
+# Option "maybetapped_action" "click"
+# Option "maybetapped_button" "1"
+
+ # treat one and a half tap as an innocuous event
+ Option "oneandahalftap_action" "up"
+ Option "oneandahalftap_button" "0"
+EndSection
+</pre>
+<p>In the ServerLayout section
+</p><p>comment out:
+</p>
+<pre> #InputDevice "Configured Mouse"
+</pre>
+<p>and add
+</p>
+<pre> InputDevice "touchscreen0"
+</pre>
+<p><br>
+<code>/dev/input/evtouch_event</code> as listed in the "InputDevice" is a symbolic link to the appropriate <code>/dev/input/eventN</code>.
+That link will automatically be created by udev from a rule installed
+by the evtouch package if udev is installed. If not, you can change
+that line to point to <code>/dev/input/eventN</code> where <code>eventN</code> can be found in <code>/proc/bus/input/devices</code>.
+</p>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=5" title="Edit section: options">edit</a>]</div><a name="options"></a><h2>2 options </h2>
+<p>Here's a complete list of xorg.conf options supported by evtouch:
+</p>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=6" title="Edit section: general">edit</a>]</div><a name="general"></a><h3>2.1 general </h3>
+<dl><dt> Device
+</dt></dl>
+<ul><li> character device node (or symbolic link to such) from which to read low level events
+</li><li> example: /dev/input/evtouch_event
+</li><li> see ChangeLog section 0.8.7-HR line 42
+</li></ul>
+<dl><dt> DeviceName
+</dt></dl>
+<ul><li> used to describe device in debugging output
+</li><li> default: "EVTouch TouchScreen"
+</li><li> see evtouch.c line 1338
+</li><li> see evtouch.c line 1214 (default overridden by line 1338)
+</li></ul>
+<dl><dt> ScreenNumber
+</dt></dl>
+<ul><li> Which X screen this touch screen is associated with. Used to get screen dimensions.
+</li><li> see evtouch.c EVTouchPreInit() line 1242
+</li></ul>
+<dl><dt> DebugLevel
+</dt></dl>
+<ul><li> Controls the amount of debugging information output. Versions
+prior to 0.8.7-3quortech3 (quortech-debug.patch) did not honour this
+entirely and would output uncontrolled information.
+</li><li> default: 0
+</li><li> see evtouch.c line 1261
+</li></ul>
+<dl><dt> HistorySize
+</dt></dl>
+<ul><li> default: 0
+</li><li> see evtouch.c line 1322
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=7" title="Edit section: coordinates">edit</a>]</div><a name="coordinates"></a><h3>2.2 coordinates </h3>
+<dl><dt> Calibrate
+</dt></dl>
+<ul><li> see evtouch.c line 1244
+</li></ul>
+<dl><dt> MinX, MinY
+</dt></dl>
+<ul><li> The minimum values produced by the touch screen controller. Used to calibrate the screen.
+</li><li> default: 0
+</li><li> see evtouch.c line 1250
+</li></ul>
+<dl><dt> MaxX, MaxY
+</dt></dl>
+<ul><li> The maximum values produced by the touch screen controller. Used to calibrate the screen.
+</li><li> default: physical size
+</li><li> see evtouch.c line 1250
+</li></ul>
+<dl><dt> Rotate
+</dt></dl>
+<ul><li> "There are two valid values:
+<ul><li> CW -- Rotate the screen clockwise
+</li><li> CCW -- Rotate the screen counter-clockwise
+</li><li> Everything else will be treated as "no rotation"."
+</li></ul>
+</li><li> UD -- upside down, is added in a patch.
+</li><li> default: no rotation
+</li><li> see <a href="http://www.conan.de/touchscreen/evtouch.html" class="external free" title="http://www.conan.de/touchscreen/evtouch.html" rel="nofollow">http://www.conan.de/touchscreen/evtouch.html</a>
+</li><li> see evtouch.c line 1257
+</li></ul>
+<dl><dt> SwapX
+</dt></dl>
+<ul><li> "This option is in the driver since V0.61. When set to 1 the
+X-axis is swapped. This option is applied BEFORE the rotation-option."
+</li><li> default: false
+</li><li> see <a href="http://www.conan.de/touchscreen/evtouch.html" class="external free" title="http://www.conan.de/touchscreen/evtouch.html" rel="nofollow">http://www.conan.de/touchscreen/evtouch.html</a>
+</li><li> see evtouch.c line 1300
+</li></ul>
+<dl><dt> SwapY
+</dt></dl>
+<ul><li> "This option is in the driver since V0.61. When set to 1 the
+Y-axis is swapped. This option is applied BEFORE the rotation-option."
+</li><li> default: false
+</li><li> see <a href="http://www.conan.de/touchscreen/evtouch.html" class="external free" title="http://www.conan.de/touchscreen/evtouch.html" rel="nofollow">http://www.conan.de/touchscreen/evtouch.html</a>
+</li><li> see evtouch.c line 1300
+</li></ul>
+<dl><dt> x0, y0, x1, y1, x2, y2, x3, y3, x4, y4, x5, y5, x6, y6, x7, y7, x8, y8
+</dt></dl>
+<ul><li> 9-point calibration data
+</li><li> defaults: 0
+</li><li> see evtouch.c line 1306
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=8" title="Edit section: states">edit</a>]</div><a name="states"></a><h3>2.3 states </h3>
+<p>See <a href="http://www.conan.de/touchscreen/libtouch.html" class="external free" title="http://www.conan.de/touchscreen/libtouch.html" rel="nofollow">http://www.conan.de/touchscreen/libtouch.html</a>
+</p><p>The states are:
+</p>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=9" title="Edit section: S_UNTOUCHED">edit</a>]</div><a name="S_UNTOUCHED"></a><h4>2.3.1 S_UNTOUCHED </h4>
+<ul><li> The state when the touch screen is initialized or when the touch screen is not being touched and all actions have timed out.
+</li><li> see state_name_t libtouch.c line 60
+</li><li> State entry
+<ul><li> see enter_untouched libtouch.c line 365
+</li><li> any buttons that are marked down are posted as "up"
+</li></ul>
+</li><li> Event handling:
+<ul><li> moves to <a href="#S_TOUCHED" title="">#S_TOUCHED</a> when
+<ul><li> receives a pen down event
+</li><li> and receives either
+<ul><li> a SYN event (sufficient for our usage)
+</li><li> or receives both an X and Y <i>change in value</i> (not analyzed for conditions)
+</li></ul>
+</li></ul>
+</li><li> see handle_untouched libtouch.c line 384
+</li></ul>
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=10" title="Edit section: S_TOUCHED">edit</a>]</div><a name="S_TOUCHED"></a><h4>2.3.2 S_TOUCHED </h4>
+<ul><li> State when the screen is first touched (and not released, moved or timed out) after having been in <a href="#S_UNTOUCHED" title="">#S_UNTOUCHED</a>
+</li><li> see state_name_t libtouch.c line 60
+</li><li> State Entry:
+<ul><li> see enter_touched() libtouch.c line 433
+</li><li> longtouch timer started
+</li><li> all other timers disabled
+</li></ul>
+</li><li> Event Handling:
+<ul><li> see handle_touched libtouch.c line 438
+</li><li> if pen up event, go to <a href="#S_MAYBETAPPED" title="">#S_MAYBETAPPED</a>
+</li><li> if longtouch timer expires, go to <a href="#S_LONGTOUCHED" title="">#S_LONGTOUCHED</a>
+</li><li> if move beyond move_limit
+<ul><li> post button down for drag button
+</li><li> go to <a href="#S_MOVING" title="">#S_MOVING</a>
+</li></ul>
+</li></ul>
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=11" title="Edit section: S_LONGTOUCHED">edit</a>]</div><a name="S_LONGTOUCHED"></a><h4>2.3.3 S_LONGTOUCHED </h4>
+<ul><li> "If you touch the screen for a long time without moving the
+pen too much this state is entered and the default-action is issued."
+</li><li> State when the screen is touched and held for longer than the longtouch timer and not moved more than the move_limit
+</li><li> see <a href="http://www.conan.de/touchscreen/libtouch.html" class="external free" title="http://www.conan.de/touchscreen/libtouch.html" rel="nofollow">http://www.conan.de/touchscreen/libtouch.html</a>
+</li><li> see state_name_t libtouch.c line 60
+</li><li> State Entry
+<ul><li> all timers are disabled
+</li><li> the <a href="#issued_events" title="">longtouch event</a> is issued
+</li><li> see enter_longtouched() libtouch.c line 500
+</li></ul>
+</li><li> Event Handling
+<ul><li> if pen is released, go to <a href="#S_UNTOUCHED" title="">#S_UNTOUCHED</a>
+</li><li> if moved more than move_limit, go to <a href="#S_MOVING" title="">#S_MOVING</a>
+</li><li> see handle_longtouched() libtouch.c line 508
+</li></ul>
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=12" title="Edit section: S_MOVING">edit</a>]</div><a name="S_MOVING"></a><h4>2.3.4 S_MOVING </h4>
+<ul><li> State when touch is dragged beyond move_limit
+</li><li> see state_name_t libtouch.c line 60
+</li><li> State Entry
+<ul><li> all timers are disabled
+</li><li> see enter_moving() libtouch.c line 485
+</li></ul>
+</li><li> Event Handler
+<ul><li> if pen up event, go to <a href="#S_UNTOUCHED" title="">#S_UNTOUCHED</a>
+</li><li> see handle_moving() libtouch.c line 491
+</li></ul>
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=13" title="Edit section: S_MAYBETAPPED">edit</a>]</div><a name="S_MAYBETAPPED"></a><h4>2.3.5 S_MAYBETAPPED </h4>
+<ul><li> "If you tap with the pen on the screen the default-action is
+issued. If you touch the screen again immediately the next state is
+entered."
+</li><li> State after having touched and released screen (in less than the long timer) until tap timer expires or other touch happens.
+</li><li> see <a href="http://www.conan.de/touchscreen/libtouch.html" class="external free" title="http://www.conan.de/touchscreen/libtouch.html" rel="nofollow">http://www.conan.de/touchscreen/libtouch.html</a>
+</li><li> see state_name_t libtouch.c line 60
+</li><li> State Entry
+<ul><li> start tap timer
+</li><li> all other timers disabled
+</li><li> see enter_maybetap() libtouch.c line 539
+</li></ul>
+</li><li> Event Handling
+<ul><li> if tap timer expired
+<ul><li> issue <a href="#issued_events" title="">maybetapped event</a>
+</li><li> go to <a href="#S_UNTOUCHED" title="">#S_UNTOUCHED</a>
+</li></ul>
+</li><li> see handle_maybetap() libtouch.c line 548
+</li><li> if additional pen down event
+<ul><li> disable timers
+</li><li> code shows FIXME
+</li></ul>
+</li><li> if new pen down and new X, Y coordinates less than move_limit, go to <a href="#S_ONEANDAHALFTAP" title="">#S_ONEANDAHALFTAP</a>
+</li><li> if new pen down and new X, Y coordinates outside move_limit
+<ul><li> issue <a href="#issued_events" title="">maybetapped event</a>
+</li><li> go to <a href="#S_TOUCHED" title="">#S_TOUCHED</a>
+</li></ul>
+</li></ul>
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=14" title="Edit section: S_ONEANDAHALFTAP">edit</a>]</div><a name="S_ONEANDAHALFTAP"></a><h4>2.3.6 S_ONEANDAHALFTAP </h4>
+<ul><li> "This state is entered if you tap the screen and immediately
+after that touch the same place on the screen again without moving the
+pen on the screen too much."
+</li><li> see <a href="http://www.conan.de/touchscreen/libtouch.html" class="external free" title="http://www.conan.de/touchscreen/libtouch.html" rel="nofollow">http://www.conan.de/touchscreen/libtouch.html</a>
+</li><li> see state_name_t libtouch.c line 60
+</li><li> State Entry
+<ul><li> longtouch timer started
+</li><li> all other timers disabled
+</li><li> see enter_oneandahalftap() libtouch.c line 615
+</li></ul>
+</li><li> Event Handling
+<ul><li> if pen up event and longtouch timer not expired and this state has issued any events
+<ul><li> disable all timers
+</li><li> issue <b>2</b> <a href="#issued_events" title="">maybetapped events</a>
+</li><li> go to <a href="#S_UNTOUCHED" title="">#S_UNTOUCHED</a>
+</li></ul>
+</li><li> if pen up event (otherwise)
+<ul><li> go to <a href="#S_UNTOUCHED" title="">#S_UNTOUCHED</a>
+</li></ul>
+</li><li> if X or Y changes outside move_limit, go to <a href="#S_MOVING" title="">#S_MOVING</a>
+</li><li> if the longtouch timer has expired and no events have been issued, issue the <a href="#issued_events" title="">oneandahalftap event</a>
+</li><li> see handle_oneandahalftap() libtouch.c line 624
+</li></ul>
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=15" title="Edit section: issued events">edit</a>]</div><a name="issued_events"></a><h4>2.3.7 issued events </h4>
+<p>See <a href="http://www.conan.de/touchscreen/libtouch.html" class="external free" title="http://www.conan.de/touchscreen/libtouch.html" rel="nofollow">http://www.conan.de/touchscreen/libtouch.html</a>
+</p><p><br>
+The action options follow the form: <i>issue name</i><code>_action</code>. E.g <code>longtouched_action</code>.
+</p>
+<ul><li> see libtouch.c line 226
+</li></ul>
+<p>The button options follow the form: <i>issue name</i><code>_button</code>. E.g <code>maybetouched_button</code>.
+</p>
+<ul><li> see libtouch.c line 221
+</li><li> "Button to use (1, 2, ...)."
+</li><li> If the value is -1, the default value is used instead.
+</li></ul>
+<table border="1">
+<tbody><tr>
+<th> options </th><th> default button </th><th> default action </th><th> notes
+</th></tr>
+<tr>
+<td> <b>untouched_button</b> <b>untouched_action</b>
+</td><td> 0 (place holder)
+</td><td> NULL
+</td><td> Never issued; unused.
+</td></tr>
+<tr>
+<td> <b>touched_button</b> <b>touched_action</b>
+</td><td> 0 (place holder)
+</td><td> NULL
+</td><td> Never issued; unused.
+</td></tr>
+<tr>
+<td> <b>longtouched_button</b> <b>longtouched_action</b>
+</td><td> 1 (left button)
+</td><td> <a href="#btn_down_action" title="">down</a>
+</td><td>
+<ul><li> "Button-action to issue when the user touches the screen for a long time."
+</li><li> Issued when entering state <a href="#S_LONGTOUCHED" title="">#S_LONGTOUCHED</a>.
+</li></ul>
+</td></tr>
+<tr>
+<td> <b>moving_button</b> <b>moving_action</b>
+</td><td> 0 (place holder)
+</td><td> NULL
+</td><td> Never issued; unused.
+</td></tr>
+<tr>
+<td> <b>maybetapped_button</b> <b>maybetapped_action</b>
+</td><td> 1 (left button)
+</td><td> <a href="#btn_click_action" title="">click</a>
+</td><td>
+<ul><li> "Button-action to issue when the user taps the screen."
+</li><li> Issued on some exits from state <a href="#S_MAYBETAPPED" title="">#S_MAYBETAPPED</a>.
+</li><li> Issued <b>twice</b> on some exits from state <a href="#S_ONEANDAHALFTAP" title="">#S_ONEANDAHALFTAP</a>.
+</li></ul>
+</td></tr>
+<tr>
+<td> <b>oneandahalftap_button</b> <b>oneandahalftap_action</b>
+</td><td> 3 (right button)
+</td><td> <a href="#btn_down_action" title="">down</a>
+</td><td>
+<ul><li> "Button-action to issue when the user taps the screen and then touches approximately the same location for a long time."
+</li><li> Issued during state <a href="#S_ONEANDAHALFTAP" title="">#S_ONEANDAHALFTAP</a>.
+</li></ul>
+</td></tr></tbody></table>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=16" title="Edit section: actions">edit</a>]</div><a name="actions"></a><h4>2.3.8 actions </h4>
+<ul><li> see libtouch.c line 226
+</li><li> Can be one of "down", "up", or "click"
+</li><li> Any other value causes the option (not the action) to be silently ignored.
+</li><li> There is no value that means the action should be disabled or ignored.
+</li><li> The values will associate the corresponding function:
+</li></ul>
+<pre> btn_down_action
+ btn_up_action
+ btn_click_action
+</pre>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=17" title="Edit section: btn_down_action">edit</a>]</div><a name="btn_down_action"></a><h5>2.3.8.1 btn_down_action </h5>
+<p>Post a button down action.
+</p>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=18" title="Edit section: btn_up_action">edit</a>]</div><a name="btn_up_action"></a><h5>2.3.8.2 btn_up_action </h5>
+<p>Post a button down action.
+</p>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=19" title="Edit section: btn_click_action">edit</a>]</div><a name="btn_click_action"></a><h5>2.3.8.3 btn_click_action </h5>
+<p>Post a button down action, immediately followed by a button up action.
+</p>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=20" title="Edit section: variables">edit</a>]</div><a name="variables"></a><h4>2.3.9 variables </h4>
+<dl><dt> untouched_drag, touched_drag, longtouched_drag, moving_drag, maybetapped_drag, oneandahalftap_drag
+</dt></dl>
+<ul><li> They specify the drag_btn.
+</li><li> Defaults are all -1. A value of -1 causes the option to be ignored. (The drag_btn is left unchanged.)
+</li><li> libtouch.c line 241
+</li></ul>
+<dl><dt> MoveLimit
+</dt></dl>
+<ul><li> Specifies the tolerance in changes to X and Y that will be ignored. Values above this will be treated as a drag.
+</li><li> "If the pen moves out of this radius a "mouse-press"-event becomes impossible."
+</li><li> Default is 180 pixels (not 30 pixels)
+</li><li> See: ChangeLog line 29, evtouch.c line 1271 overrides other default of 30 at libtouch.c line 203
+</li></ul>
+<dl><dt> ButtonNumber
+</dt></dl>
+<ul><li> default: 2
+</li><li> see evtouch.c line 1255
+</li></ul>
+<dl><dt> Emulate3Buttons
+</dt></dl>
+<ul><li> "Enable emulation of three button support"
+</li><li> default: true (enabled)
+</li><li> see <a href="http://www.conan.de/touchscreen/evtouch.html" class="external free" title="http://www.conan.de/touchscreen/evtouch.html" rel="nofollow">http://www.conan.de/touchscreen/evtouch.html</a>
+</li><li> see evtouch.c line 1257
+</li></ul>
+<dl><dt> Emulate3Timeout
+</dt></dl>
+<ul><li> "If both buttons are pressed/released before this timer
+expires a "middle press/release"-event is generated. This timer starts
+to run as soon as a button is pressed."
+</li><li> see <a href="#timer_values" title="">#timer values</a>
+</li><li> default: 50 ms
+</li><li> see <a href="http://www.conan.de/touchscreen/evtouch.html" class="external free" title="http://www.conan.de/touchscreen/evtouch.html" rel="nofollow">http://www.conan.de/touchscreen/evtouch.html</a>
+</li><li> see evtouch.c line 1258
+</li></ul>
+<dl><dt> TapTimer
+</dt></dl>
+<ul><li> "This timer starts when the state MAYBETAPPED is entered. When
+this timer expires a tap-event is issued and the state changes to
+UNTOUCHED."
+</li><li> see <a href="#timer_values" title="">#timer values</a>
+</li><li> default: 90 (not 200ms)
+</li><li> see <a href="http://www.conan.de/touchscreen/evtouch.html" class="external free" title="http://www.conan.de/touchscreen/evtouch.html" rel="nofollow">http://www.conan.de/touchscreen/evtouch.html</a>
+</li><li> see evtouch.c line 1264
+</li><li> see TapTimer() in xorg-server-1.4.1~git20080105-1~holger/os/WaitFor.c
+</li></ul>
+<dl><dt> LongtouchTimer
+</dt></dl>
+<ul><li> "This timer is always started when the state TOUCHED is
+entered. When the timer expires before you untouch the screen again the
+state moves to LONGTOUCHED and on entering that state a longtouch-event
+is issued."
+</li><li> see <a href="#timer_values" title="">#timer values</a>
+</li><li> default: 160 (not 400ms)
+</li><li> see evtouch.c line 1267
+</li></ul>
+<div class="editsection" style="float: right; margin-left: 5px;">[<a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit&section=21" title="Edit section: timer values">edit</a>]</div><a name="timer_values"></a><h4>2.3.10 timer values </h4>
+<p>Timer values are set in milliseconds.
+</p><p>Prior to 0.8.7-3quortech2 (quortech-timer.patch) a value of 0
+caused the timer to be ignored. Since then 0 means the timer goes off
+immediately, and -1 means the timer will never go off.
+</p><p>See TimerSet() in xorg-server-1.4.1~git20080105-1~holger/os/WaitFor.c
+</p>
+<!-- Saved in parser cache with key wikidb:pcache:idhash:2037-0!1!0!ISO 8601!1!en!2 and timestamp 20090116010017 -->
+<div class="printfooter">
+Retrieved from "<a href="http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project/evtouch/Configuring">http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project/evtouch/Configuring</a>"</div>
+ <!-- end content -->
+ <div class="visualClear"></div>
+ </div>
+ </div>
+ </div>
+ <div id="column-one">
+ <div id="p-cactions" class="portlet">
+ <h5>Views</h5>
+ <ul>
+ <li id="ca-nstab-main" class="selected"><a title="View the content page [alt-c]" accesskey="c" href="http://wiki.qts.quortech.com/mediawiki/index.php/Eclipse_Project/evtouch/Configuring">Article</a></li>
+ <li id="ca-talk" class="new"><a title="Discussion about the content page [alt-t]" accesskey="t" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Talk:Eclipse_Project/evtouch/Configuring&action=edit">Discussion</a></li>
+ <li id="ca-edit"><a title="You can edit this page. Please use the preview button before saving. [alt-e]" accesskey="e" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=edit">Edit</a></li>
+ <li id="ca-history"><a title="Past versions of this page. [alt-h]" accesskey="h" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=history">History</a></li>
+ <li id="ca-protect"><a title="Protect this page [alt-=]" accesskey="=" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=protect">Protect</a></li>
+ <li id="ca-delete"><a title="Delete this page [alt-d]" accesskey="d" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=delete">Delete</a></li>
+ <li id="ca-move"><a title="Move this page [alt-m]" accesskey="m" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Special:Movepage&target=Eclipse_Project%2Fevtouch%2FConfiguring">Move</a></li>
+ <li id="ca-unwatch"><a title="Remove this page from your watchlist [alt-w]" accesskey="w" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&action=unwatch">Unwatch</a></li>
+ </ul>
+ </div>
+ <div class="portlet" id="p-personal">
+ <h5>Personal tools</h5>
+ <div class="pBody">
+ <ul>
+ <li id="pt-userpage"><a title="My user page [alt-.]" accesskey="." href="http://wiki.qts.quortech.com/mediawiki/index.php/User:Brett_Wuth">Brett Wuth</a></li>
+ <li id="pt-mytalk"><a title="My talk page [alt-n]" accesskey="n" href="http://wiki.qts.quortech.com/mediawiki/index.php/User_talk:Brett_Wuth" class="new">My talk</a></li>
+ <li title="My preferences" id="pt-preferences"><a href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Preferences">Preferences</a></li>
+ <li id="pt-watchlist"><a title="The list of pages you're monitoring for changes. [alt-l]" accesskey="l" href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Watchlist">My watchlist</a></li>
+ <li id="pt-mycontris"><a title="List of my contributions [alt-y]" accesskey="y" href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Contributions/Brett_Wuth">My contributions</a></li>
+ <li id="pt-logout"><a title="Log out [alt-o]" accesskey="o" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Special:Userlogout&returnto=Eclipse_Project/evtouch/Configuring">Log out</a></li>
+ </ul>
+ </div>
+ </div>
+ <div title="Main Page" class="portlet" id="p-logo">
+ <a style="background-image: url(/mediawiki/skins/common/images/wiki.png);" href="http://wiki.qts.quortech.com/mediawiki/index.php/Main_Page" title="Main Page"></a>
+ </div>
+ <script type="text/javascript"> if (window.isMSIE55) fixalpha(); </script>
+ <div class="portlet" id="p-navigation">
+ <h5>Navigation</h5>
+ <div class="pBody">
+ <ul>
+ <li id="n-mainpage"><a title="Visit the Main Page [alt-z]" accesskey="z" href="http://wiki.qts.quortech.com/mediawiki/index.php/Main_Page">Main Page</a></li>
+ <li title="Find background information on current events" id="n-currentevents"><a href="http://wiki.qts.quortech.com/mediawiki/index.php/Current_events">Current events</a></li>
+ <li id="n-recentchanges"><a title="The list of recent changes in the wiki. [alt-r]" accesskey="r" href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Recentchanges">Recent changes</a></li>
+ <li id="n-randompage"><a title="Load a random page [alt-x]" accesskey="x" href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Random">Random page</a></li>
+ <li title="The place to find out." id="n-help"><a href="http://wiki.qts.quortech.com/mediawiki/index.php/Help:Contents">Help</a></li>
+ </ul>
+ </div>
+ </div>
+ <div id="p-search" class="portlet">
+ <h5><label for="searchInput">Search</label></h5>
+ <div id="searchBody" class="pBody">
+ <form action="/mediawiki/index.php/Special:Search" id="searchform"><div>
+ <input id="searchInput" name="search" accesskey="f" value="" type="text">
+ <input name="go" class="searchButton" id="searchGoButton" value="Go" type="submit">
+ <input name="fulltext" class="searchButton" value="Search" type="submit">
+ </div></form>
+ </div>
+ </div>
+ <div class="portlet" id="p-tb">
+ <h5>Toolbox</h5>
+ <div class="pBody">
+ <ul>
+ <li id="t-whatlinkshere"><a title="List of all wiki pages that link here [alt-j]" accesskey="j" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Special:Whatlinkshere&target=Eclipse_Project%2Fevtouch%2FConfiguring">What links here</a></li>
+ <li id="t-recentchangeslinked"><a title="Recent changes in pages linked from this page [alt-k]" accesskey="k" href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Special:Recentchangeslinked&target=Eclipse_Project%2Fevtouch%2FConfiguring">Related changes</a></li>
+<li id="t-upload"><a title="Upload images or media files [alt-u]" accesskey="u" href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Upload">Upload file</a></li>
+<li id="t-specialpages"><a title="List of all special pages [alt-q]" accesskey="q" href="http://wiki.qts.quortech.com/mediawiki/index.php/Special:Specialpages">Special pages</a></li>
+ <li id="t-print"><a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&printable=yes&printable=yes">Printable version</a></li> <li id="t-permalink"><a href="http://wiki.qts.quortech.com/mediawiki/index.php?title=Eclipse_Project/evtouch/Configuring&oldid=52326">Permanent link</a></li> </ul>
+ </div>
+ </div>
+ </div><!-- end of the left (by default at least) column -->
+ <div class="visualClear"></div>
+ <div id="footer">
+ <div id="f-poweredbyico"><a href="http://www.mediawiki.org/"><img src="configuring_files/poweredby_mediawiki_88x31.png" alt="MediaWiki"></a></div>
+ <ul id="f-list">
+ <li id="lastmod"> This page was last modified 2009-01-15 17:51:57.</li>
+ <li id="viewcount">This page has been accessed 81 times.</li>
+ <li id="privacy"><a href="http://wiki.qts.quortech.com/mediawiki/index.php/QuortechWiki:Privacy_policy" title="QuortechWiki:Privacy policy">Privacy policy</a></li>
+ <li id="about"><a href="http://wiki.qts.quortech.com/mediawiki/index.php/QuortechWiki:About" title="QuortechWiki:About">About QuortechWiki</a></li>
+ <li id="disclaimer"><a href="http://wiki.qts.quortech.com/mediawiki/index.php/QuortechWiki:General_disclaimer" title="QuortechWiki:General disclaimer">Disclaimers</a></li>
+ </ul>
+ </div>
+ <script type="text/javascript"> if (window.runOnloadHook) runOnloadHook();</script>
+</div>
+<!-- Served by wiki in 0.120 secs. -->
+
+</body></html>
\ No newline at end of file
--- End Message ---