EyelinkToolbox - aleslab/Psychtoolbox-3-aleslab-fork GitHub Wiki

[EyelinkToolbox](EyelinkToolbox).  

The [EyelinkToolbox](EyelinkToolbox) can be used to ceate eye-movement experiments and  

control the SR-Research Eyelink(c) gazetrackers
(http://www.eyelinkinfo.com/) from within Matlab and Octave.
It is incorporated into the PsychToolbox (http://www.psychtoolbox.org/).
It provides an interface to the Eyelink Gazetracker.
It uses a very similar approach as the PsychToolBox and uses the
functions provided by the PsychToolBox for graphics and sound.

The EyelinkToolbox is a collection of m-files and a Mex file.
The EyelinkToolbox core is the mex/dll-file called Eyelink. The
EyelinkToolbox uses the same approach as the SCREEN mex/dll function
provided in the PsychToolBox. Most of the Eyelink functions that are
avaible in C are also available under Matlab. In addition, the
EyelinkToolbox provides a number of wrapper functions to simplify
creating an eye-tracking program. The main functionality of the
EyelinkToolbox is demonstrated in a number of demos. This is probably
where you want to start if you are new to the EyelinkToolbox.

For a complete list of available functions type "Eyelink" in the Matlab
command window. For an explanation of any particular eyelink function
just add a question mark "?" after a command. E.g. for help on the
function 'Initialize', try either of these equivalent forms:

    Eyelink('Initialize?')  
    Eyelink initialize?  

-Contents.m: this file.  

-Changes.m: file that documents changes to the [EyelinkToolbox](EyelinkToolbox)  

-[EyelinkBasic](EyelinkBasic)  
    Eyelink.mex/dll file and a collection of m-files that provide the  
   core functionality of the toolbox.  

-[EyelinkDemos](EyelinkDemos)  
   [EyelinkShortDemos](EyelinkShortDemos) is the best place to start. Contains relatively   
   simple demos. The SR-Research Demo folder is a slightly more  
   elaborate example. The folder BRMIC contains the original example  
   as shown in the [EyelinkToolbox](EyelinkToolbox) article in BRMIC (Cornelissen,  
   Peters and Palmer 2002). It is obsolete in many ways but left in  
   the toolbox for historic reasons.  

-EyelinkOneLiners
Handy routines that provide less essential functionality

We welcome any observations, suggestions that may help us improve this  
toolbox. If any particular function you need is still missing, let us know  
and we'll try to incorporate it into a next release. In case you decide  

to add or modify functions yourself, please send us the modified code.
If you think you've found a bug, please tell us. It will help greatly
if you can supply a minimal-length program that exhibits the bug.
If you're interested in the c-source code of this project, it is part
of the source code of the PsychToolbox (http://www.psychtoolbox.org/).

******Citing the use of the Eyelink Toolbox******

We would very much appreciate it if you would (also) cite the EyelinkToolbox
paper when you have used the toolbox in your work. You could write something
like:

We wrote our experiments in Matlab, using the Psychophysics and Eyelink
Toolbox extensions (Brainard, 1997; Pelli, 1997; Cornelissen, Peters &
Palmer, 2002; see http://psychtoolbox.org/).

Brainard, D. H. (1997) The Psychophysics Toolbox, Spatial Vision 10:433-436.
Cornelissen, F.W., Peters. E., Palmer, J. (2002).

The Eyelink Toolbox: Eye tracking with MATLAB and the Psychophysics
Toolbox. Behavior Research Methods, Instruments & Computers, 34,
613-617.

Pelli, D. G. (1997) The VideoToolbox software for visual psychophysics:
Transforming numbers into movies, Spatial Vision 10:437-442.
This toolbox is also actively supported and co-developed by SR-Research
(http://www.eyelinkinfo.com), the manufacturer of the Eyelink
gazetrackers. You can contact them about it. However, if your problem
is likely of interest to other users as well, then please post
questions on the PsychToolbox mailinglist, which is also monitored by
SR-Research.

The EyelinkToolbox and its source code are copyright
Enno Peters, Frans Cornelissen and John Palmer. Additional copyrights
for some contributed functions are SR-Research and the respective
individual developers of those functions.

(Type "Eyelink" or Eyelink('Version') for authors). The
toolbox is freely useable and redistributable under the terms of the
MIT license. The exact license text is included inside License.txt in
the root folder of any Psychtoolbox-3 installation.

Disclaimer: we cannot be hold responsible for any damage that may
(appear to) be caused by the use of this toolbox. Use at
your own risk!

Frans W. Cornelissen
22nd July 2010
email: [email protected]

Enno Peters, Frans Cornelissen and John Palmer  
Groningen, 27-11-2002  

{{category}}