TouchBench
Description:	Mouse emulator for touchscreens
Download:	touchbench.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	61kb
Version:	0.9b
Date:	01 Oct 2023
Author:	Alfredo Amendolagine
Submitter:	Alfredo Amendolagine
Email:	project4amiga/gmail com
Homepage:	https://project4a.eu
Requirements:	touch.device 0.12
Category:	utility/misc
Replaces:	utility/misc/touchbench.lha
License:	Freeware
Distribute:	yes
Min OS Version:	4.1
FileID:	12682
Videos:
Comments:	0
Snapshots:	0
Videos:	3
Downloads:	74  (Current version)
	218  (Accumulated)
Votes:	6 (0/0)  (30 days/7 days)

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 and point-and-click games.
- 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
-----
To start touchbench:
   - double-click on the touchbench icon will run the application in background.
To stop touchbench you can:
   - type 'touchbench BREAK' from CLI
   - send a CTRL_C signal to the touchbench process
Note: TouchBench is an amigaos application, so you can use "exchanger" to
control the running state.

Known problems & limitations
--------------
- Missing GUI.
- It currently supports no more than 16 touch devices at a time.

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.eu

Changes
-------
0.9 (01-10-2023)
 - Now can handle more than 1 touch device at a time (max 16)
 - Added BREAK switch to stop touchbench from CLI.
0.8 (24-09-2023)
 - Fixed bug: single click events emitted with wrong qualifiers
 - Fixed random crash on timer transitions
 - Added default tooltype: DONOWAIT (useful if executed from WBStartup)
 - Fixed: missing reconnect when a device is removed and reattached
 - Compiled with gcc 11.3.0
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. , Bill Borsari for betatesting the
software