Page History: Tobii Tracker Element
Compare Page Revisions
Page Revision: 2011/11/16 15:11
|
New Element
|
Info |
Category: |
|
|
AddIn: |
Base Elements |
Creator: |
OkazoLab Team |
|
Scope: |
Parent Event |
Owns Snippets: |
no |
|
Usage: |
Runtime Screen,Snippets |
The element allows/is capable of doing something in experiments
Description
Short description
Snapshots
Snapshot 1
| Snapshot 2 |
Practical Use
Technique 1
- Step 1
- Step 2
Technique 2
- Step 1
- Step 2
// Check the trial outcome. Result and RT just other user variables
// insert code snippet here..
Element actions aligned with different epochs of the parent event
Epoche | Actions |
---|
Initialized |
Rendered |
Activating |
Activated |
Running |
Deactivated |
Deinitialized |
Notes
Insert Notes here..
Properties
Generic Properties
=== Generic Properties ===
Name | Description | Attributes | Value Type | Proxy Changed Actions |
---|
Tobii settings |
Tobii device | Tobii device selected for tracking | | EyetrackerInfo | |
Tracking target | Indicates which eye is used for tracking within EventIDE
(via the radar properties of the parent event) | | enTrackingTarget | |
Sampling |
Sample count | Indicates which eye is used for tracking within EventIDE
(via the radar properties of the parent event) | | enTrackingTarget | |
Samples | Array that represents a block of the most recent Tobii samples. The array is composed of stTobiiSample structs | | stTobiiSample[] |
LastSample | The most recent Tobii sample | | stTobiiSample | |
Perfomance |
Buffer size | Size of a circular memory buffer, in samples, that stores realtime eyetracker data | | Int32 | |
Amount of the lost data | The total amount of eyetracking data that have been lost due to a perfomance lag, in bytes. If the value greater than 0 after runtime, consider an increase of the memory buffer size | | UInt64 | |
MaxRefreshTime | Largest time interval between two read-outs that has been registred for the last runtime, in ms | | UInt64 | |
LastRefreshTime | The current time interval between two read-outs, in ms | | UInt64 | |
Drift Correction |
Recalibrate Now | If set to true in a code snippet, the drift correction is performed - the calibration offsets are adjusted to match the current eye position and custom recalibration point. This action can be used for the runtime drift correction. | | Boolean | |
Recalibration Point | Custom recalibration point for the runtime drift correction. Empty value by default denotes the screen center in any resolution. | | clPoint | |
+=== Sample properties ===
Name | Description | Attributes | Value Type | Proxy Changed Actions |
---|
TimeStamp of the sample | | | Int64 | |
LeftEye | Raw screen position of the left eye. | | clPoint | |
RightEye | Raw screen position of the right eye. | | clPoint | |
CalibratedLeftEye | Screen calibrated position of the left eye. | | clPoint | |
CalibratedRightEye | Screen calibrated position of the right eye. | | clPoint | |
LeftEye3D | Raw 3D Position of the left eye. | | Point3D | |
RightEye3D | Raw 3D Position of the right eye. | | Point3D | |
LeftEyeValidity | Tobii validity status of this sample for the left eye. | | Int32 | |
RightEyeValidity | Tobii validity status of this sample for the right eye. | | Int32 | |
LeftEyeToScreenDistance | Raw distance between the left eye and screen. | | Double | |
RightEyeToScreenDistance | Raw distance between the right eye and screen. | | Double | |
LeftPupilDiameter | Left pupil diameter. | | Double | |
RightPupilDiameter | Right pupil diameter. | | Double | |
+=== Properties inherited from clTrackerElement ===
Name | Description | Constraints | Type | Upon Runtime Change |
---|
GLM Calibration |
Run GLM Calibration | Runs the GLM calibration procedure, which calculates two pairs of linear coefficients for mapping of the tracker input into the screen coordinates. The calculated coefficients are automatically applied at runtime. | | Boolean |
Gain X | Defines the gain coefficient for the X axis in the GLM calibration model: X='GainX'*x+OffsetX | | Double | |
Gain Y | Defines the gain coefficient for the Y axis in the GLM calibration model: Y=GainY*y+OffsetY | | Double |
Offset X | Defines the offset coefficient for the X axis in the GLM calibration model: X=GainX*x+OffsetX | | Double | |
Offset Y | Defines the offset coefficient for the Y axis in the GLM calibration model: Y=GainY*y+OffsetY | | Double | |
Drift Correction |
Recalibrate Now | Runtime command that helps to correct drifts in tracking data.Correction is done by recalibration of the latest tracker position into a custom screen point defined by the 'Recalibration Point' property.nAs result, the offsets of the GLM calibration get adjusted (but not gains) to compensate a drift in further data. | | Boolean |
Recalibration Point | Defines the screen point to which the tracker position will be recalibrated on calling 'Recalibrate Now' action. The default auto value always denotes the screen center. | | clPoint |
Logging |
Log Folder | Opens the dialog for selecting a local folder that will hold all tracking logs | | String |
Open Log Designer | Opens a designer window where the log format can be defined. | | Boolean |
Is Logging | Defines whether logging is turn on/off. The value can be changed at any moment at runtime allowing selective logging during the relevant periods only. | | Boolean | |
User Field | Defines the custom user data that is added to every line in the log file. The property can be used for recording varying status information (e.g. trial number) together with the tracker data. The string value may contains multiple fields separated by delimiter. | | String | Once a string value is assigned, it is added to every new upcoming line in the log until a new assignment is made. |
+=== Properties inherited from clElement ===
Inherited properties of clElement
Name | Description | Constraints | Value Type | Upon Change |
---|
Control |
Is Enabled | If set to false the element is completely omitted when the experiment is run. | | Boolean |
|
Title | Title of the element. | | String |
|