|
UPDD mouse
emulation
Revision 1.0 – 21st Apr 2008 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Most pointer
devices emulate the actions of the mouse; pen down, cursor movement, pen up
to generate left clicks, right clicks, double clicks etc. These actions have to be derived from the
events generated from the pointer device. In the case of a touch screen these
events are initial touch, movement, stationary touch and last touch -
effectively a complete touch sequence. Emulation Modes
With UPDD version 3 we
had 15 mouse emulation modes. Many
customers suggested we had too many settings in version 3 and part of the
version 4 remit was to simplify the GUI and the settings. As part of this
simplification process we reduced the number of listed emulation modes to 4
and renamed them in the process as shown below:
Although the logic
remains in the driver to support the other modes we have only exposed the new
names in the UPDD Console program to allow for end user manual selection:
The driver can actually
hold two emulation modes against each touch device for each Event [see note
1] that can occur on a device; the Primary click mode (the mode in use after
installation) and an alternative or secondary click mode that can be switched
to as required. The UPDD Console,
Click Mode dialog (shown above) only allows for the Primary click mode to be
changed for the default event [1].
UPDD V3 Console did allow for all primary and secondary click modes for
all events to be updated but it was such a rarely used function we have
removed it under version 4. As standard the UPDD
driver will be supplied with the primary click mode set to ‘Click then drag’
or ‘Interactive touch’ and the secondary (alternative) mode set to ‘TouchDown
Right’ [3] but other default modes can be defined if required. Changing the primary and
secondary click modes
There are various ways to
change the primary and secondary click modes as follows:
Switching between primary
and secondary modes
Once the required primary
and secondary click modes are defined the user/system can switch between the
two click modes as follows: Event Selector A floating desktop icon,
or system tray icon (
The Event Selector also
has a setting such that it switches back automatically after the Secondary
emulation mode has been used once as would be the case if you used the
secondary emulation mode to generate a right click and then revert back to
left click to continue selection. Only available on Windows
but will shortly be available on Mac and Linux. Application Programming Interface An application can call the TBApiSetEventSelectorState(n)
to switch to the primary or secondary modes. n = 0 = Primary, n = 1 = Secondary as required. Mouse Emulation Notes
These notes are
referenced from within this document and should be read in context with the
associated point of reference: [1] Events An Event refers to the
triggers on a touch device that can be associated with a click mode. In 99% of cases a touch device has the UPDD
default event defined and no others. This is configured in the UPDD
controller database for a given controller as follows:
The default event is the
touching of the device and has two trigger points. One, when the stylus
contacts the touch screen for the first time and the other when it leaves the
touch screen for the last time. This
allows for the click modes to be associated with these default event trigger
points. E.g. Pen down on contact, pen up on last touch. However, a touch device
may generate a number of events that can be used as triggers for mouse
emulation actions. Take for example a
PS/2 touch controller that allows a real PS/2 mouse to piggy back on the
touch controller and deliver both touch and mouse packets to the driver. The driver would also receive the mouse
data packets that carry left and right button click data. In this case the controller would be
configured in UPDD for the default touch event but also the Left and Right
button events as shown below:
In this example, the
controller will send both data packets to the driver; Mouse and Touch. The
mouse packet shows where the L (Left button) and R (Right button) are defined
in the incoming data stream and when they are set (=1) then the driver will
perform the click mode associated with the L binding. Depending on the event selector setting the
Primary or Secondary/Alternative click mode will be performed. [2] Settings UPDD settings are held in
the system at various places depending on OS and UPDD release as shown:
For Windows 4.1.x the
click mode settings are held in the .INI file [updd\parameters\N] section For Windows 4.0.x the
click mode settings are held in the registry / registry file at the
[updd\parameters\{..}\N] branch where N = the device handle, normally 1 for
the first device, 2 for the second device etc and are named event alt mode n =
Secondary Click Mode name event bind n = Bind name event mode n =Primary Click Mode name event name n = Event Name These set of click mode
settings will be present for each device event [1] defined where n = 0 for the first event defined, 1 for
the second event defined etc. It is VERY unlikely that the name or bind
setting will need to be changed, only the primary and secondary click mode
names. Valid names are listed in the “UPDD Mouse Click Mode emulation names
table above”. Important: These settings
still utilise the UPDD version 3 click mode names. Example A device is defined in
UPDD with one Event, being the default touch event
This will result is the
following settings: event alt mode
0=Touchdown Right event bind 0=DFLT event mode 0=Touchdown
Left event name 0=Default For UPDD 4.1.x and above
only update these settings via the UPDD Advance Console or the
TBAPISetSettingsSZ API function call if the driver is active. To manually
update the settings via an alternative method, stop the driver (Net Stop tbupddwu),
make the change and then either restart the driver to reread the settings
(Net Start tbupddwu) or reboot the system. If changing either mode
to Interactive Touch, the right click is generated after the stylus has been
held steady for a period of time at dictated by the setting “interactive
touch time”, where: interactive touch
time=0x00000001 = fastest (right click almost immediately) interactive touch
time=0x00000064 = Slowest (right click after about 3 or 4 seconds) [3] TouchDown Right is
effectively ‘Click Down and Drag’ but with the right button down. Related Mouse emulation
system and UPDD settings
There are a number of system or UPDD settings that
can affect the performance of mouse emulation as follows:
ContactFor further information or technical assistance please email the technical support team at technical@touch-base.com |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
) showing a mouse image
indicating the current setting ‘Left button’ image indicates Primary click
mode is selected. ‘Right button’ image indicates Secondary click mode is
selected.
