BrightSign Object Reference Manual (FW 5.1) - Manual (Page 124)

116
roTouchScreen
This object allows you to accept events from touchscreen panels or mice. Not all touchscreens are supported. However,
we are always working on more driver support. Please see this
FAQ for a full list of supported touchscreens, or
contact [email protected] if you want to know whether a specific touch-screen model supported.
An roTouchScreen instance responds to the clicks of a USB mouse in the same way it responds to touch events on a
touchscreen.
To use a touchscreen, follow these general steps:
1. Create an roTouchScreen object.
2. Use
SetPort() to specify which roMessagePort should receive touch events.
3. Define one or more touch regions.
a. A touch region may be rectangular or circular.
b. When someone touches the screen anywhere inside the area of a touch region, an event will be sent to the
message port.
4. Process the events.
Note: If touch areas overlap such that a touch hits multiple regions, an event for each affected region will be sent.
The roTouchScreen object supports rollover regions. Rollovers are based around touch regions. When a rectangular or
circular region is added, it defaults to having no rollover. You can enable a rollover using the touch region’s ID and
specifying an on and off image. Whenever the mouse cursor is within that region, the on image is displayed. In all other
cases, the off image is displayed. This allows buttons to be highlighted as the mouse cursor moves over them.
Interfaces:
ifTouchScreen , ifSetMessagePort , ifTouchScreenCalibration , ifSerialControl