Touch Input Device

Available on iOS

Description

Interface to the built-in touchscreen on an iOS device.

This device detects and tracks the movement of a single touch (e.g. finger) on the screen. If the screen is touched in multiple locations simultaneously, only the first detected touch is tracked. All other touches are ignored.

Signature

iodevice/touch_input

Required Parameters

touch_position_x

Variable in which to store the horizontal position of the touch (in degrees) on the screen

touch_position_y

Variable in which to store the vertical position of the touch (in degrees) on the screen

touch_in_progress

Variable in which to store the touch state (true if a touch is in progress, false otherwise)

Optional Parameters

display

Name of the display on which to track touches. If omitted, the default display (if available) will be used.

autostart

Default:

NO

If YES, the device will start I/O automatically (as if by an implicit Start IO Device action) when the experiment starts running.

Note: Device I/O will always stop automatically when the experiment stops running, irrespective of this setting.

alt

Alternative device to use if this one fails to initialize (e.g. because the required hardware is not available). If #allowAltFailover is set to 0 or false, this parameter is ignored.

Placement

Allowed at top level:

Yes

Allowed parent:

Folder