Configure
Sound During Touch
Every complete touch is indicated
by a beep from the system. Touchscreen must be calibrated before using
this functionality. The frequency
and time and beep is configurable.
EloGetBeep
EloSetBeep
|
Save Alignment for Touchscreen Using Calibration API
Elo provides a standard calibration utility for video alignment. The CALIBRATION
is used to convert touches from the Elo coordinate system to Windows virtual coordinate
system.
The driver uses the following equation to convert a raw touch coordinate point from
Elo coordinate system to the Windows screen coordinate system.
Calibration equation is
Xcal = a + m*Xuncal,
where,
Xuncal, is in Elo coordinate system
Xcal, is in Windows coordinate system
m = nScrDx / nEloDx
"a", is the X offset value entry
nScrDx = distance between targets in Windows virtual coordinates
nEloDx = distance between targets in Elo coordinates.
This is specially useful if you want to save the calibration over the network or
some other place, and later configure the touchscreen using one common set of data.
To get the current calibration data from the driver, use EloGetCalibrationData.
For changing the calibration data use EloSetCalibrationData
.
EloGetCalibrationData
EloSetCalibrationData
|
Define
Touchscreen Boundary
Touchscreen boundary defines the bounding rectangle for the touchscreen on Windows
virtual desktop. This allows / prohibits touch on one monitor from being propagated
to the corresponding monitor. Touchscreen must be calibrated before using
this functionality.
EloGetTouchBoundary
EloSetTouchBoundary
|
Swap
Touchscreen Buttons
Use this call to use the
touchscreen with swapped button for next couple of touches on the screen.
Swaps the button for the touch monitor
for the touch count specified. Once the count is exhausted, the SDK notifies the
application by sending a WM_SWAPBUTTON message to the application window. Touchscreen
must be calibrated before using this functionality.
EloSwapButton
|
Configure Touchscreen for Left-handed Users
For left-handed users of mouse, set
the touchscreen mode using EloSetLeftHandedMouse call.
EloSetLeftHandedMouse
|
Retrieve Touchscreen Diagnostic Data
Diagnostic information for
touchscreen can be retrieved using EloGetDiagnosticsData.
This information is also displayed
in the Elo Control panel>Properties tab.
EloGetDiagnosticData
|
Configure Touchscreen for Gaming Specific Mode by Enabling Quick Touch
Quick touch is an enhanced mode of the touchscreen, usually used for gaming purposes.
In standard operation, touches on screen following each other very quickly in "Mouse
Emulation" mode creates a system drag box.
This feature allows the touches following each other quickly to be interpreted as
independent touches resulting in separate mouse clicks.
Touchscreen must be calibrated before using this functionality.
EloGetQuickTouch
EloSetQuickTouch
|
Configure Edge Acceleration Feature
Touching towards the edge of the touchscreen can be difficult at times.
This feature allows the cursor to be accelerated towards the screen edges.
Touchscreen must be calibrated before
using this functionality.
EloGetAcceleration
EloSetAcceleration
|
Define Touchscreen to Automatically Timeout After Constant Touch in Same
Location Using Untouch Timeout Feature
If touches are created in the same constant location, an automatic untouch is generated
by the driver based on this timeout.
For dirt on a screen this is a very handy feature.
Touchscreen must be calibrated before
using this functionality.
EloGetUntouchTimeout
EloSetUntouchTimeout
|
Configure Right Click on Hold Functionality
This feature allows touchscreen to generate right clicks. A right click is generated
when the user continues to touch the screen. Touchscreen must be calibrated before
using this functionality. This can be configured using:
EloGetRightClickOnHold
EloSetRightClickOnHold
|
EloPubIf.lib provides the SDK for
communicating with Elo Serial and USB drivers. In order to communicate with either
of the drivers, add this library to the list of compile time dependencies of your
application and use the appropriate interface function calls in your program. Include the header file, EloInterface.h
and EloErrorCodes.h in your application.
These files can be found on Program
Files\EloTouchsystems folder.
Elo Device
Interface Functions
Function
Name: EloGetScreenInfo
int
EloGetScreenInfo(DWORD dwMonNum[32], int iScrCnt)
Parameters:
dwMonNum [in]: Array of DWORD to receive the Windows monitor number associated with
the touchscreens.
iScrCnt [out]: It retrieves the
total number of Elo touchscreens found.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
It returns the list of Windows monitor
numbers associated with the touchscreens where, the index is the touchscreen number
and the value is the Windows monitor number.
Touchscreens are 0 based and Windows
monitor numbers are 1 based.
If a touchscreen is not calibrated,
the windows monitor is returned as -1.
Maximum of 32 touchscreens are supported.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also
Error Codes
Function Name:
EloGetTouch
int EloGetTouch (PTOUCH_POINT xy,
BOOL xlated, GETPOINTS_CODE getCode, UINT nScrNo)
Parameters:
xy [out]: Pointer to TOUCH_POINT structure
to receive the touch coordinates from the touchscreen. The application is responsible
for allocating / freeing memory. Please see structure definition section for TOUCH_POINT.
xlated [in]: If TRUE, the coordinates
are returned translated for Windows coordinate system. If FALSE, raw coordinate
data are returned.
getCode [in]: This can be one of
the following values: ReturnImmediately, ReturnOnTouch, ReturnOnUntouch, ReturnOnNextValidTouch.
Please see definition for GETPOINTS_CODE.
nScrNo [in/out]: This must be initialized
to the zero based touchscreen number. Returns the zero based touchscreen number
for the touchscreen touched.
Return Values:
Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Unless the ReturnImmediately GetCode value is used, this call will not return until
the user touches the screen specified.
To cancel the blocking wait use
the EloCancel function.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also
EloCancel, EloGetScreenInfo,
Error Codes
Function Name:
EloCancel
int EloCancel()
Parameters:
None.
Return Values: Returns EloSuccess
if the call succeeds, it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Cancels any pending request with the driver.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetTouch,EloGetScreenInfo,
Error Codes
Function
Name: EloGetMouseMode
int EloGetMouseMode (WORD *wMode,UINT
nScrNo)
Parameters:
wMode [out]: Returns the touchscreen mode. Please see Constant definition section
for TOUCHSCREEN_MODE.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Retrieves the touch mode for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloSetMouseMode,
EloGetScreenInfo,
Error Codes
Function
Name: EloSetMouseMode
int EloSetMouseMode (WORD wMode,UINT
nScrNo)
Parameters:
wMode [in]: Touchscreen mode. Please see Constant definition section for
TOUCHSCREEN_MODE.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the touch mode for the specified touchscreen to wMode.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetMouseMode,
EloGetScreenInfo,
Error Codes
Function Name:
EloGetTouchReportingState
int EloGetTouchReportingState (BOOL
*bFlag , UINT nScrNo)
Parameters:
bFlag [out]: Touch state enabled / disabled. If TRUE, touch data is reported. If
FALSE, touch data is not reported.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the touch state for touchscreen specified. It saves it in bFlag.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloSetTouchReportingState,
EloGetScreenInfo,
Error Codes
Function Name:
EloSetTouchReportingState
int EloSetTouchReportingState (BOOL
bFlag, int nScrNo)
Parameters:
bFlag [in]: Touch state enabled / disabled. If TRUE, touch data is reported. If
FALSE, touch data is not reported.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Enables or Disables touch depending on bFlag.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetTouchReportingState,
EloGetScreenInfo,
Error Codes
Function
Name: EloGetDragDelay
int EloGetDragDelay (PDRAG_DELAY
pDragDelay,UINT nScrNo)
Parameters:
pDragDelay [out]: Pointer to DRAG_DELAY
to receive Drag Delay . Please see structure definition section for
PDRAG_DELAY.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the dragdelay parameters for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloSetDragDelay ,EloGetScreenInfo,
Error Codes
Function
Name: EloSetDragDelay
int EloSetDragDelay (PDRAG_DELAY
pDragDelay, UINT nScrNo)
Parameters:
pDragDelay [in]: Dragdelay data. Please see structure definition section for
DRAG_DELAY.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the drag delay for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetDragDelay ,EloGetScreenInfo,
Error Codes
Function Name: EloGetBeep
int EloGetBeep (PBEEP pBeepVal,
UINT nScrNo)
Parameters:
pBeepVal [out]: Pointer to BEEP structure to receive data. Please see structure
definition section for BEEP.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the touchscreen beep data for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloSetBeep,
EloGetScreenInfo,
Error Codes
Function Name: EloSetBeep
int EloSetBeep (PBEEP pBeepVal,
UINT nScrNo)
Parameters:
pBeepVal [in]: Pointer to sound structure to receive data. Please see structure
definition section for BEEP definition.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the touchscreen beep data for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetBeep,
EloGetScreenInfo,
Error Codes
Function Name: EloGetTouchBoundary
int EloGetTouchBoundary(PTOUCH_BOUNDARY
ptBndry , UINT nScrNo)
Parameters:
ptBndry [out]: Pointer to TOUCH_BOUNDARY
structure containing full screen boundary data in pixels. Please see structure definition
section for TOUCH_BOUNDARY.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the full screen bounding rectangle and bounding mode for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloSetTouchBoundary,
EloGetScreenInfo,
Error Codes
Function Name: EloSetTouchBoundary
int EloSetTouchBoundary(PTOUCH_BOUNDARY
ptBndry, UINT nScrNo)
Parameters:
ptBndry [in]: Pointer to TOUCH_BOUNDARY structure containing full screen boundary
data in pixels. Please see structure definition section for TOUCH_BOUNDARY.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the full screen bounding rectangle and bounding mode for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetTouchBoundary,
EloGetScreenInfo,
Error Codes
Function Name: EloGetCalibrationData
int EloGetCalibrationData (PCALIBRATION
pCalData, UINT nScrNo)
Parameters:
pCalData [out]: Pointer to CALIBRATION structure to receive the calibration data.
Please see structure definition section for CALIBRATION.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Retrieves the calibration data for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloSetCalibrationData,
EloGetScreenInfo,Error
Codes
Function Name:
EloSetCalibrationData
int EloSetCalibrationData (CALIBRATION
*pCalData,UINT nScrNo)
Parameters:
pCalData [in]: Pointer to CALIBRATION structure which stores the calibration data
for the touchscreen. Please see structure definition section for
CALIBRATION.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the calibration data for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also EloGetCalibrationData,
EloGetScreenInfo,
Error Codes
Function
Name: EloSwapButton
int EloSwapButton (HWND hWnd, DWORD
dwCnt, UINT nScrNo)
Parameters:
hWnd [in]: Handle to window to receive the WM_ELOSWAPBUTTON message. if NULL, there
is no message.
dwCnt [in]: Touch count for which
the button should be swapped.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Swaps the button for the touch monitor for the touch count specified in dwCnt. Once
the count is exhausted the DLL notifies the application, by sending a WM_ELOSWAPBUTTON
message to the application window specified in hWnd.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also:
EloGetScreenInfo,
Error Codes
Function Name: EloSetLeftHandedMouse
int EloSetLeftHandedMouse (BOOL
bFlag)
Parameters:
bFlag [in]: If TRUE it sets touchscreen mode to left-handed mouse.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the touchscreen mode to left-handed mouse. This does not affect the Windows
left-handed mouse settings.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also:
EloGetScreenInfo,
Error Codes
Function Name: EloGetDiagnosticsData
int EloGetDiagnosticsData(PSCREEN_PROPERTIES
pData, UINT nScrNo)
Parameters:
pData [in]: Pointer to SCREEN_PROPERTIES structure to receive the diagnostics for
the touchscreen. Please see structure definition section for
SCREEN_PROPERTIES.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSucces if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the diagnostics for the specified touchscreen. This information is also displayed
in the Elo Control panel>Properties tab.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also:
EloGetScreenInfo,
Error Codes
Function Name: EloGetQuickTouch
int EloGetQuickTouch (PQUICK_TOUCH
pQTouch, UINT nScrNo)
Parameters:
pQTouch [out]: Pointer to QUICK_TOUCH structure to receive the quick touch configuration
data from the selected touchscreen. Please see structure definition section for
QUICK_TOUCH.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSucces if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the Quick Touch configuration parameters for the specified touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also
EloSetQuickTouch,EloGetScreenInfo,
Error Codes
Function
Name: EloSetQuickTouch
int EloSetQuickTouch (PQUICK_TOUCH
pQTouch, UINT nScrNo)
Parameters:
pQTouch [in]: Pointer to QUICK_TOUCH structure containing the quick touch configuration
data for the touchscreen. Please see structure definition section for
QUICK_TOUCH.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the Quick Touch configuration parameters for all touchscreens.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also
EloGetQuickTouch EloGetScreenInfo,
Error Codes
Function Name: EloGetEdgeAccel
int EloGetEdgeAccel(PEDGE_ACCEL
pAccel, UINT nScrNo)
Parameters:
pAccel [out]: Pointer to EDGE_ACCEL structure to receive the edge accleration data
for the touchscreen. Please see structure definition section for EDGE_ACCEL.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the edge acceleration boundary and acceleration value for the given touchscreen.
Requirements
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also
EloGetScreenInfo, EloSetEdgeAccel,
Error Codes
Function Name: EloSetEdgeAccel
int EloSetEdgeAccel(PEDGE_ACCEL
pAccel, UINT nScrNo)
Parameters:
pAccel [in]: Pointer to EDGE_ACCEL structure to containing the edge accleration
data for the touchscreen. Please see structure definition section for
EDGE_ACCEL.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Sets the edge acceleration boundary and acceleration scale for the given touchscreen.
Requirements:
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also: EloGetScreenInfo, EloGetEdgeAccel, Error
Codes
Function Name: EloGetUntouchTimeout
int EloGetUntouchTimeout(PUNTOUCH_TIMEOUT
pUTimeout, UINT nScrNo)
Parameters:
pUTimeout [out]: Pointer to UNTOUCH_TIMEOUT structure to receive the untouch timeout
data for the touchscreen. Please see structure definition section for
UNTOUCH_TIMEOUT.
nScrNo [in]: 0 based touchscreen
number.
Return Values: Returns EloSuccess if the call succeeds,
it returns an error code otherwise. See
Error Codes section for list of error values.
Remarks:
Gets the untouch timeout data for the given touchscreen.
Requirements:
Included in Version 4.20 and later.
Header: Declared in EloInterface.h; include EloInterface.h.
Library: Use EloPubIf.lib.
See Also:
EloGetScreenInfo, EloSetUntouchTimeout,
Error Codes
Function Name: EloSetUntouchTimeout
int EloSetUntouchTimeout(PUNTOUCH_TIMEOUT
pUTimeout, UINT nScrNo)
Parameters:
