TouchBench

What is it?
-----------
TouchBench is an application that converts touchscreen events produced by
touch.device into mouse events.
Two emulation modes are supported:
1) "MOUSE" mode is suitable for workbench operations.It emulates all the
functionalities of a mouse, according to the following rules:
- Press & Release within 100 msec -> left-mouse button click
- Press & Move                    -> mouse drag with left-mouse button pressed
- Press & Hold for more then 1sec -> right-mouse button press
2) "RAW" mode is suitable for touch-panels operations. It translates the touch
events according to the following rules:
- press   -> left-mouse button press
- release -> left-mouse button release

Why?
-----------
All the applications developed for the amiga until now, obviously only involve
the use of the mouse, since there was no API that managed touch events, like the
one provided by touch.device.
TouchBench allows all pre-existing applications that do not use touch.device to
be used with a touchscreen.
I developed this application to be able to use point and click games or
touch-friendly applications like MihPhoto with my touchscreen, and as first test
application for touch.device.

Installation
------------
Copy the folder wherever you like.

Configuration
-------------
TouchBench can currently be configured through tooltypes.
The following tooltypes are available:
- MODE: define the emulation mode. The following values are available:
  - "MOUSE" is the default mode, suitable for applications requiring standard
mouse operations.
  - "RAW" - suitable for touch-panel applications.
- SENSITIVITY: it tunes the sensitivity of recognizing a drag action (default
value is 40 pixels). Sensitivity is valid only in MOUSE mode.
- ANTIBOUNCE: if specified with RAW mode, it ignores the release events shorter
than the specified value in msecs.

Usage
-----
Double-click on the touchbench icon will run the application in background.
TouchBench is an amigaos application, so you can use exchanger to control the
running state.
Send a CTRL_C signal to stop touchbench.

Known problems & limitations
--------------
- Missing GUI.
- It currently supports no more than one touch device at a time.
- Next versions will be more configurable

License
-------
This binary distribution is the copyright of the author (Alfredo Amendolagine).
This version is distributed as freeware, you may distribute the archive as you
see fit but must include this readme with any distribution.
The right to change the distribution rights of a future version is reserved.

Disclaimer
----------
The software is provided as is, with no guarantee of fitness for purpose.
The author is not responsible for any damage caused to the users data or
hardware as a result of using this software.

Comments
--------
TouchBench should be considered a beta release until version 1.0 is reached.
If you have any problems, comments or bug reports please write to:
project4amiga()gmail.com
or visit my site: https://project4a.webs.com

Changes
-------
0.7 (02-04-2021)
 - Fixed crash on touchscreen disconnection
 - Added tooltypes: MODE , ANTIBOUNCE
0.6 (25-01-2021)
 - Updated to touch.device 0.11
0.5 (20-12-2020)
 - First released version

Special thanks
--------
I would like to thank:
- Luigi Burdo & Thomas Blatt for the icons
- Sinan GÃŒrkan , Tuomas Hokka , Tim O. for betatesting the software