EyeLogic SDK  1.2.2
ELApi Namespace Reference

Classes

class  ELApi
 main class for communication with the EyeLogic server More...
 
class  ELDeviceEvent
 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
 
 DeviceEventCallback = 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:387
ELApi.ELApi.DeviceConfig.__init__
def __init__(self, deviceSerial)
constructor
Definition: ELApi.py:432
ELApi.ELApi.validateCustom
(ReturnValidate, ValidationResult) validateCustom(self, c_int backgroundColor, str targetFilename)
perform validation (method is blocking until calibration finished) - calibration must be performed pr...
Definition: ELApi.py:795
ELApi.ELApi.connectRemote
ReturnConnect connectRemote(self, ServerInfo server)
initialize connection to a remote server (method is blocking until connection established)
Definition: ELApi.py:238
ELApi.ELApi.calibrateCustom
def calibrateCustom(self, c_int calibrationModeInd, c_int backgroundColor, str targetFilename)
perform calibration (method is blocking until calibration finished)
Definition: ELApi.py:664
ELApi.ELEyeImage
contains an eye image at a specific time
Definition: ELApi.py:103
ELApi.ELApi.getNextDeviceEvent
(ReturnNextData, ELDeviceEvent) getNextDeviceEvent(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:527
ELApi.ELApi.ServerInfo
connection information for an EyeLogic server
Definition: ELApi.py:222
ELApi.ELApi.DeviceConfig.isDemoDevice
isDemoDevice
whether the device is for DEMO use only, not for public sale
Definition: ELApi.py:440
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:553
ELApi.ELApi.abortCalibValidation
def abortCalibValidation(self)
abort a running calibration / validation
Definition: ELApi.py:674
ELApi.ELApi.connect
ReturnConnect connect(self)
initialize connection to the server (method is blocking until connection established).
Definition: ELApi.py:215
ELApi.ELApi.unrequestTracking
def unrequestTracking(self)
unrequest tracking
Definition: ELApi.py:620
ELApi.ELApi.__del__
def __del__(self)
destructor
Definition: ELApi.py:165
ELApi.ELApi.ReturnConnect
return values of connect( )
Definition: ELApi.py:199
ELApi.ELApi.setActiveScreen
ReturnSetActiveScreen setActiveScreen(self, str id, DeviceGeometry deviceGeometry)
Make a screen connected to this machine to the active screen.
Definition: ELApi.py:412
ELApi.ELApi.calibrate
def calibrate(self, c_int calibrationModeInd)
perform calibration (method is blocking until calibration finished)
Definition: ELApi.py:646
ELApi.ELApi
main class for communication with the EyeLogic server
Definition: ELApi.py:150
ELApi.ELApi.DeviceConfig.deviceName
deviceName
name of the device
Definition: ELApi.py:436
ELApi.ELApi.ReturnStart
return values of requestTracking( )
Definition: ELApi.py:588
ELApi.ELApi.ValidationPointResult.validationPointPxY
validationPointPxY
ELInvalidValue or y-coordinate of stimulus point position.
Definition: ELApi.py:713
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:719
ELApi.ELApi.registerGazeSampleCallback
def registerGazeSampleCallback(self, GazeSampleCallback sampleCallback)
registers sample callback listener
Definition: ELApi.py:170
ELApi.ELApi.ValidationPointResult.meanDeviationRightPx
meanDeviationRightPx
ELInvalidValue or mean deviation between right eye POR and stimulus position in [px] in the stimulus ...
Definition: ELApi.py:722
ELApi.ELApi.__init__
def __init__(self, str clientName)
constructor
Definition: ELApi.py:156
ELApi.ELApi.DeviceConfig.deviceSerial
deviceSerial
serial number
Definition: ELApi.py:434
ELApi.ELGazeSample
contains all information about the state of the eyes at a specific time
Definition: ELApi.py:65
ELApi.ELApi.DeviceConfig.brandedName
brandedName
name of the license owner
Definition: ELApi.py:438
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:725
ELApi.ELApi.ValidationResult.pointsData
pointsData
Number of validation points.
Definition: ELApi.py:735
ELApi.ELApi.DeviceConfig.frameRates
frameRates
list of supported frame rates
Definition: ELApi.py:442
ELApi.ELApi.ReturnStreamEyeImages
return values of streamEyeImages( )
Definition: ELApi.py:479
ELApi.ELApi.DeviceGeometry.mmBelowScreen
mmBelowScreen
distance of eye tracker below the bottom line of the screen [mm]
Definition: ELApi.py:389
ELApi.ELApi.registerEyeImageCallback
def registerEyeImageCallback(self, EyeImageCallback eyeImageCallback)
registers eye image callback listener
Definition: ELApi.py:180
ELApi.ELApi.ReturnSetActiveScreen
return values of setActiveScreen( )
Definition: ELApi.py:394
ELApi.ELApi.ReturnCalibrate
return values of calibrate( )
Definition: ELApi.py:627
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:716
ELApi.ELApi.ValidationPointResult.validationPointPxX
validationPointPxX
ELInvalidValue or x-coordinate of stimulus point position.
Definition: ELApi.py:711
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:261
ELApi.ELApi.ReturnNextData
return values of getNextDeviceEvent( ), getNextGazeSample( ) and getNextEyeImage( )
Definition: ELApi.py:501
ELApi.ELApi.ServerInfo.__init__
def __init__(self)
constructor
Definition: ELApi.py:224
ELApi.ELApi.DeviceGeometry
geometric position of the device related to the active monitor
Definition: ELApi.py:382
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:579
ELApi.ELApi.disconnect
def disconnect(self)
closes connection to the server
Definition: ELApi.py:283
ELApi.ELApi.registerDeviceEventCallback
def registerDeviceEventCallback(self, DeviceEventCallback deviceEventCallback)
registers event callback listener
Definition: ELApi.py:190
ELApi.ELApi.DeviceConfig
configuration of the eye tracker
Definition: ELApi.py:429
ELApi.ELApi.ScreenConfig.physicalSizeY_mm
physicalSizeY_mm
vertical physical dimension of the screen [mm]
Definition: ELApi.py:313
ELApi.ELApi.requestTracking
ReturnStart requestTracking(self, c_int frameRateModeInd)
request tracking
Definition: ELApi.py:610
ELApi.ELApi.streamEyeImages
ReturnStreamEyeImages streamEyeImages(self, c_bool enable)
Enabled/disables eye image stream.
Definition: ELApi.py:493
ELApi.ELApi.ValidationResult
ValidationResult.
Definition: ELApi.py:731
ELApi.ELApi.ScreenConfig
configuration of the stimulus screen
Definition: ELApi.py:297
ELApi.ELApi.ServerInfo.port
port
port of server
Definition: ELApi.py:228
ELApi.ELApi.ServerInfo.ip
ip
IP address of server as 0-terminated string.
Definition: ELApi.py:226
ELApi.ELApi.ScreenConfig.localMachine
localMachine
whether this screen is connected to the local PC
Definition: ELApi.py:301
ELApi.ELApi.DeviceGeometry.mmTrackerInFrontOfScreen
mmTrackerInFrontOfScreen
distance of front panel of the eye tracker in front of the screen[mm]
Definition: ELApi.py:391
ELApi.ELApi.isConnected
bool isConnected(self)
whether a connection to the server is established
Definition: ELApi.py:290
ELApi.ELApi.getDeviceConfig
DeviceConfig getDeviceConfig(self)
get configuration of actual eye tracker device
Definition: ELApi.py:448
ELApi.ELApi.ScreenConfig.name
name
Name of the screen.
Definition: ELApi.py:305
ELApi.ELApi.ScreenConfig.id
id
ID of the screen.
Definition: ELApi.py:303
ELApi.ELApi.ScreenConfig.physicalSizeX_mm
physicalSizeX_mm
horizontal physical dimension of the screen [mm]
Definition: ELApi.py:311
ELApi.ELApi.ValidationPointResult
ValidationPointResult.
Definition: ELApi.py:708
ELApi.ELApi.ScreenConfig.resolutionY
resolutionY
screen Y resolution [px]
Definition: ELApi.py:309
ELApi.ELApi.ScreenConfig.resolutionX
resolutionX
screen X resolution [px]
Definition: ELApi.py:307
ELApi.ELApi.ScreenConfig.__init__
def __init__(self)
constructor
Definition: ELApi.py:299
ELApi.ELDeviceEvent
Events coming from the eye tracker.
Definition: ELApi.py:89
ELApi.ELApi.getAvailableScreens
[ScreenConfig] getAvailableScreens(self)
Get a list of screens connected to the local machine.
Definition: ELApi.py:350
ELApi.ELApi.DeviceConfig.calibrationMethods
calibrationMethods
list of supported calibration methods (number of shown points)
Definition: ELApi.py:444
ELApi.ELApi.ReturnValidate
return values of validate( )
Definition: ELApi.py:679
ELApi.ELApi.getActiveScreen
ScreenConfig getActiveScreen(self)
get stimulus screen configuration
Definition: ELApi.py:317
ELApi.ELApi.validate
(ReturnValidate, ValidationResult) validate(self)
perform validation (method is blocking until calibration finished) - calibration must be performed pr...
Definition: ELApi.py:743