EyeLogic SDK  1.1.9
ELApi Namespace Reference

Classes

class  ELApi
 main class for communication with the EyeLogic server More...
 
class  ELEvent
 Events coming from the eye tracker. More...
 
class  ELEyeImage
 contains an eye image at a specific time More...
 
class  ELGazeSample
 contains all information about the state of the eyes at a specific time More...
 

Functions

def check_bool (result, func, args)
 

Variables

 GazeSampleCallback = CFUNCTYPE(None, POINTER(ELGazeSample))
 callback function type, new gaze samples
 
 EventCallback = CFUNCTYPE(None, c_int32)
 callback function type, event occurred
 
 EyeImageCallback = CFUNCTYPE(None, POINTER(ELEyeImage))
 callback function type, new eye image
 
 libname = os.path.join("x64", "ELCApi")
 
 baseDir = os.path.dirname(os.path.abspath(__file__))
 
 libnameGlobal = os.path.join(baseDir, libname + ".dll")
 
 kernel32 = WinDLL('kernel32', use_last_error=True)
 
 errcheck
 
 restype
 
 argtypes
 
 c_libH = kernel32.LoadLibraryExW(libnameGlobal, None, 0x00000008)
 
 c_lib = WinDLL(libname, handle=c_libH)
 
 ELInvalidValue = c_double.in_dll(c_lib, "ELCInvalidValue").value
 marker for an invalid double value
 

Detailed Description

This module contains the python prototype declaration for all functions which are neccessary to control the EyeLogic software from an API client.

ELApi.ELApi.DeviceGeometry.__init__
def __init__(self, mmBelowScreen, mmTrackerInFrontOfScreen)
constructor
Definition: ELApi.py:375
ELApi.ELApi.DeviceConfig.__init__
def __init__(self, deviceSerial)
constructor
Definition: ELApi.py:420
ELApi.ELApi.connectRemote
ReturnConnect connectRemote(self, ServerInfo server)
initialize connection to a remote server (method is blocking until connection established)
Definition: ELApi.py:226
ELApi.ELEyeImage
contains an eye image at a specific time
Definition: ELApi.py:91
ELApi.ELApi.ServerInfo
connection information for an EyeLogic server
Definition: ELApi.py:210
ELApi.ELApi.getNextGazeSample
(ReturnNextData, ELGazeSample) getNextGazeSample(self, c_int timeoutMillis)
Obtains the next unread gazeSample or blocks until a new GazeSample is received or the given timeout ...
Definition: ELApi.py:529
ELApi.ELApi.connect
ReturnConnect connect(self)
initialize connection to the server (method is blocking until connection established).
Definition: ELApi.py:203
ELApi.ELApi.unrequestTracking
def unrequestTracking(self)
unrequest tracking
Definition: ELApi.py:596
ELApi.ELApi.registerEventCallback
def registerEventCallback(self, EventCallback eventCallback)
registers event callback listener
Definition: ELApi.py:178
ELApi.ELApi.__del__
def __del__(self)
destructor
Definition: ELApi.py:153
ELApi.ELApi.ReturnConnect
return values of connect( )
Definition: ELApi.py:187
ELApi.ELApi.setActiveScreen
ReturnSetActiveScreen setActiveScreen(self, str id, DeviceGeometry deviceGeometry)
Make a screen connected to this machine to the active screen.
Definition: ELApi.py:400
ELApi.ELApi.calibrate
def calibrate(self, c_int calibrationModeInd)
perform calibration (method is blocking until calibration finished)
Definition: ELApi.py:620
ELApi.ELApi
main class for communication with the EyeLogic server
Definition: ELApi.py:138
ELApi.ELApi.ReturnStart
return values of requestTracking( )
Definition: ELApi.py:564
ELApi.ELApi.ValidationPointResult.validationPointPxY
validationPointPxY
ELInvalidValue or y-coordinate of stimulus point position.
Definition: ELApi.py:661
ELApi.ELApi.ValidationPointResult.meanDeviationLeftDeg
meanDeviationLeftDeg
ELInvalidValue or mean deviation of left eye gaze direction in [deg] in the 3-D world system.
Definition: ELApi.py:667
ELApi.ELApi.registerGazeSampleCallback
def registerGazeSampleCallback(self, GazeSampleCallback sampleCallback)
registers sample callback listener
Definition: ELApi.py:158
ELApi.ELApi.ValidationPointResult.meanDeviationRightPx
meanDeviationRightPx
ELInvalidValue or mean deviation between right eye POR and stimulus position in [px] in the stimulus ...
Definition: ELApi.py:670
ELApi.ELApi.__init__
def __init__(self, str clientName)
constructor
Definition: ELApi.py:144
ELApi.ELApi.DeviceConfig.deviceSerial
deviceSerial
serial number
Definition: ELApi.py:422
ELApi.ELGazeSample
contains all information about the state of the eyes at a specific time
Definition: ELApi.py:53
ELApi.ELEvent
Events coming from the eye tracker.
Definition: ELApi.py:77
ELApi.ELApi.ValidationPointResult.meanDeviationRightDeg
meanDeviationRightDeg
ELInvalidValue or mean deviation of right eye gaze direction in [deg] in the 3-D world system.
Definition: ELApi.py:673
ELApi.ELApi.ValidationResult.pointsData
pointsData
Number of validation points.
Definition: ELApi.py:683
ELApi.ELApi.DeviceConfig.frameRates
frameRates
list of supported frame rates
Definition: ELApi.py:424
ELApi.ELApi.ReturnStreamEyeImages
return values of streamEyeImages( )
Definition: ELApi.py:455
ELApi.ELApi.DeviceGeometry.mmBelowScreen
mmBelowScreen
distance of eye tracker below the bottom line of the screen [mm]
Definition: ELApi.py:377
ELApi.ELApi.registerEyeImageCallback
def registerEyeImageCallback(self, EyeImageCallback eyeImageCallback)
registers eye image callback listener
Definition: ELApi.py:168
ELApi.ELApi.ReturnSetActiveScreen
return values of setActiveScreen( )
Definition: ELApi.py:382
ELApi.ELApi.ReturnCalibrate
return values of calibrate( )
Definition: ELApi.py:603
ELApi.ELApi.ValidationPointResult.meanDeviationLeftPx
meanDeviationLeftPx
ELInvalidValue or mean deviation between left eye POR and stimulus position in [px] in the stimulus p...
Definition: ELApi.py:664
ELApi.ELApi.ValidationPointResult.validationPointPxX
validationPointPxX
ELInvalidValue or x-coordinate of stimulus point position.
Definition: ELApi.py:659
ELApi.ELApi.requestServerList
[ServerInfo] requestServerList(self, c_int32 blockingDurationMS, c_int32 maxNumServer)
Ping all running EyeLogic servers in the local network and wait some time for their response.
Definition: ELApi.py:249
ELApi.ELApi.ReturnNextData
return values of getNextEvent( ), getNextGazeSample( ) and getNextEyeImage( )
Definition: ELApi.py:477
ELApi.ELApi.ServerInfo.__init__
def __init__(self)
constructor
Definition: ELApi.py:212
ELApi.ELApi.DeviceGeometry
geometric position of the device related to the active monitor
Definition: ELApi.py:370
ELApi.ELApi.getNextEyeImage
(ReturnNextData, ELEyeImage) getNextEyeImage(self, c_int timeoutMillis)
Obtains the next unread eye image or blocks until a new eye image is received or the given timeout is...
Definition: ELApi.py:555
ELApi.ELApi.disconnect
def disconnect(self)
closes connection to the server
Definition: ELApi.py:271
ELApi.ELApi.DeviceConfig
configuration of the eye tracker
Definition: ELApi.py:417
ELApi.ELApi.ScreenConfig.physicalSizeY_mm
physicalSizeY_mm
vertical physical dimension of the screen [mm]
Definition: ELApi.py:301
ELApi.ELApi.requestTracking
ReturnStart requestTracking(self, c_int frameRateModeInd)
request tracking
Definition: ELApi.py:586
ELApi.ELApi.streamEyeImages
ReturnStreamEyeImages streamEyeImages(self, c_bool enable)
Enabled/disables eye image stream.
Definition: ELApi.py:469
ELApi.ELApi.ValidationResult
ValidationResult.
Definition: ELApi.py:679
ELApi.ELApi.ScreenConfig
configuration of the stimulus screen
Definition: ELApi.py:285
ELApi.ELApi.ServerInfo.port
port
port of server
Definition: ELApi.py:216
ELApi.ELApi.ServerInfo.ip
ip
IP address of server as 0-terminated string.
Definition: ELApi.py:214
ELApi.ELApi.ScreenConfig.localMachine
localMachine
whether this screen is connected to the local PC
Definition: ELApi.py:289
ELApi.ELApi.DeviceGeometry.mmTrackerInFrontOfScreen
mmTrackerInFrontOfScreen
distance of front panel of the eye tracker in front of the screen[mm]
Definition: ELApi.py:379
ELApi.ELApi.getNextEvent
(ReturnNextData, ELEvent) getNextEvent(self, c_int timeoutMillis)
Obtains the next unread event or blocks until a new event occurs or the given timeout is reached.
Definition: ELApi.py:503
ELApi.ELApi.isConnected
bool isConnected(self)
whether a connection to the server is established
Definition: ELApi.py:278
ELApi.ELApi.getDeviceConfig
DeviceConfig getDeviceConfig(self)
get configuration of actual eye tracker device
Definition: ELApi.py:430
ELApi.ELApi.ScreenConfig.name
name
Name of the screen.
Definition: ELApi.py:293
ELApi.ELApi.ScreenConfig.id
id
ID of the screen.
Definition: ELApi.py:291
ELApi.ELApi.ScreenConfig.physicalSizeX_mm
physicalSizeX_mm
horizontal physical dimension of the screen [mm]
Definition: ELApi.py:299
ELApi.ELApi.ValidationPointResult
ValidationPointResult.
Definition: ELApi.py:656
ELApi.ELApi.ScreenConfig.resolutionY
resolutionY
screen Y resolution [px]
Definition: ELApi.py:297
ELApi.ELApi.ScreenConfig.resolutionX
resolutionX
screen X resolution [px]
Definition: ELApi.py:295
ELApi.ELApi.ScreenConfig.__init__
def __init__(self)
constructor
Definition: ELApi.py:287
ELApi.ELApi.getAvailableScreens
[ScreenConfig] getAvailableScreens(self)
Get a list of screens connected to the local machine.
Definition: ELApi.py:338
ELApi.ELApi.DeviceConfig.calibrationMethods
calibrationMethods
list of supported calibration methods (number of shown points)
Definition: ELApi.py:426
ELApi.ELApi.ReturnValidate
return values of validate( )
Definition: ELApi.py:627
ELApi.ELApi.getActiveScreen
ScreenConfig getActiveScreen(self)
get stimulus screen configuration
Definition: ELApi.py:305
ELApi.ELApi.validate
(ReturnValidate, ValidationResult) validate(self)
perform calibration (method is blocking until calibration finished) - calibration must be performed p...
Definition: ELApi.py:691