up Inquisit Language Reference

eyetracker element

The eyetracker element enables Inquisit to receive and record real-time gaze data from an eyetracker.

Syntax

<eyetracker>
/ aoidurationthreshold = maxfixationtime
/ calibrationmode = mode
/ calibrationpointcolor = (red value, green value, blue value) or color name or color value
/ calibrationstimulus = stimulus
/ calibrationtargetcolor = (red value, green value, blue value) or color name or color value
/ file = "location"
/ columns = (eyecolumn, eyecolumn, eyecolumn, property, property, property)
/ framerate = framerate
/ ipaddress = ipaddress
/ labels = ("label", "label", "label", ...)
/ plugin = "plugin name"
/ screencolor = (red value, green value, blue value) or color name or color value
</eyetracker>

Properties

eyetracker.aoidurationthreshold
eyetracker.framerate
eyetracker.framerates
eyetracker.lastex
eyetracker.lastey
eyetracker.lastfixationx
eyetracker.lastfixationy
eyetracker.lasthasfixation
eyetracker.lastleftfixationx
eyetracker.lastleftfixationy
eyetracker.lastlefthasfixation
eyetracker.lastleftpupilheight
eyetracker.lastleftpupilwidth
eyetracker.lastleftvalidity
eyetracker.lastleftx
eyetracker.lastlefty
eyetracker.lastmarker
eyetracker.lastpupilheight
eyetracker.lastpupilwidth
eyetracker.lastrightfixationx
eyetracker.lastrightfixationy
eyetracker.lastrighthasfixation
eyetracker.lastrightpupilheight
eyetracker.lastrightpupilwidth
eyetracker.lastrightvalidity
eyetracker.lastrightx
eyetracker.lastrighty
eyetracker.lasttimestamp
eyetracker.lastx
eyetracker.lasty
eyetracker.maxleftpupilheight
eyetracker.maxleftpupilwidth
eyetracker.maxpupilheight
eyetracker.maxpupilwidth
eyetracker.maxrightpupilheight
eyetracker.maxrightpupilwidth
eyetracker.meanleftpupilheight
eyetracker.meanleftpupilwidth
eyetracker.meanpupilheight
eyetracker.meanpupilwidth
eyetracker.meanrightpupilheight
eyetracker.meanrightpupilwidth
eyetracker.minleftpupilheight
eyetracker.minleftpupilwidth
eyetracker.minpupilheight
eyetracker.minpupilwidth
eyetracker.minrightpupilheight
eyetracker.minrightpupilwidth
eyetracker.plugin

Functions

None.

Remarks

The eyetracker requires a custom plugin for a given make of eyetracker that can be purchased separately from Inquisit Lab. To date, we have released a plugin for Tobii eyetrackers, although plugins for other eyetrackers may be released in the future. (Note - Inquisit can send markers to any eye tracker that accepts parallel or serial port input without the use of this element and associated plugin.)

To initialize the plugin and enable access to gaze point data, simply specify the eye tracker element and set the plugin attribute to the name of the plugin (e.g., "tobii"). Each plugin may optionally support additional proprietary attributes specific to the eyetracker (see plugin-specific documentation). The eyetracker element supports a set of properties common to all plugins. These properties report gaze point and pupil size along with basic statistics on those data. The properties can be stored in the data file or used to dynamically determine experimental flow.

Currently available eye tracker plugins:
* Inquisit 6 Tobii Plugin

Examples

The following defines an eyetracker element that communicates with a Tobii eyetracker. The eyetracker element has properties that enable programmatic access to gaze data for use in gaze-contingent tasks.

<eyetracker>
/ plugin = "tobii"
</eyetracker>

Send comments on this topic:
Copyright Millisecond Software, LLC. All rights reserved.