up Inquisit Language Reference

eyetracker element

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

Syntax

<eyetracker>
/ file = "location"
/ encrypt = true("password") or false
/ columns = (eyecolumn, eyecolumn, eyecolumn, property, property, property)
/ format = dataformat
/ framerate = framerate
/ labels = boolean
/ maxfixationtime = maxfixationtime
/ minfixationtime = minfixationtime
/ plugin = "plugin name"
/ saccadethreshold = saccadethreshold
/ separatefiles = boolean
</eyetracker>

Properties

eyetracker.encrypt
eyetracker.encryptionkey
eyetracker.file
eyetracker.filename
eyetracker.framerate
eyetracker.framerates
eyetracker.fullpath
eyetracker.lastex
eyetracker.lastey
eyetracker.lastfixationx
eyetracker.lastfixationy
eyetracker.lasthasfixation
eyetracker.lastlefteyex
eyetracker.lastlefteyey
eyetracker.lastlefteyez
eyetracker.lastleftfixationx
eyetracker.lastleftfixationy
eyetracker.lastleftgazex
eyetracker.lastleftgazey
eyetracker.lastleftgazez
eyetracker.lastlefthasfixation
eyetracker.lastleftpupilheight
eyetracker.lastleftpupilwidth
eyetracker.lastleftvalidity
eyetracker.lastleftx
eyetracker.lastlefty
eyetracker.lastmarker
eyetracker.lastpupilheight
eyetracker.lastpupilwidth
eyetracker.lastrighteyex
eyetracker.lastrighteyey
eyetracker.lastrighteyez
eyetracker.lastrightfixationx
eyetracker.lastrightfixationy
eyetracker.lastrightgazex
eyetracker.lastrightgazey
eyetracker.lastrightgazez
eyetracker.lastrighthasfixation
eyetracker.lastrightpupilheight
eyetracker.lastrightpupilwidth
eyetracker.lastrightvalidity
eyetracker.lastrightx
eyetracker.lastrighty
eyetracker.lasttimestamp
eyetracker.lastx
eyetracker.lasty
eyetracker.maxfixationtime
eyetracker.maxleftpupilheight
eyetracker.maxleftpupilwidth
eyetracker.maxpupilheight
eyetracker.maxpupilwidth
eyetracker.maxrightpupilheight
eyetracker.maxrightpupilwidth
eyetracker.meanpupilheight
eyetracker.meanpupilwidth
eyetracker.minfixationtime
eyetracker.minleftpupilheight
eyetracker.minleftpupilwidth
eyetracker.minpupilheight
eyetracker.minpupilwidth
eyetracker.minrightpupilheight
eyetracker.minrightpupilwidth
eyetracker.name
eyetracker.plugin
eyetracker.recorddata
eyetracker.saccadethreshold

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 5 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.