The physical setup settings defines the physical setup of eye-tracker in the test environment and also defines the properies of the camera lens. Knowing the setup geometry enables the system to convert visual gaze angles to screen pixels or millimeters.

These settings can be written to a settings file .eyevec-setuprc (in your home directory) using the eyevec-control application. This makes the physical setup settings persistent across eye-tracking sessions. You can edit the settings file using any plain text editor.

The SDK contains get and set functions for all settings.

See also: Physical setup settings functions

Details

The names of all settings are in lowercase with dashes between the parts that make up the name. In the settings file however the dashes are removed. For instance the setting named subject-distance is called subjectdistance in the settings file.

Name Valid range / options Default Description

focal-length-px

0 or [2000, 8000]
where 0 means calculate on open:
focal-length[mm] / sensor-resolution[mm/px]

0

Focal length of the camera-lens system [px]

focal-length-mm

0 or [8, 50]
where 0 means choose device specific default on open:
16mm for the R1, 25mm for the R2

0

Metric focal length of the camera lens [mm]

focal-ratio

0 or [1.4, 4]
where 0 means choose device specific default on open:
2.0 for the R1, 2.2 for the R2

0

Focal ratio (i.e. f-number) of the camera lens

circle-of-confusion-limit

[0.001, 0.04]

0.025

Acceptable circle of confusion [mm].

This defines the depth-of-field for given subject-distance, focal-length and focal-ratio:
depth-of-field = 2 * subject-distance2 * focal-ratio * coc-limit / focal-length2

camera-lens-distance

[30, 80]

50

Distance from camera pivot axis to camera lens [mm]

camera-horizontally-flipped

0: false
1: true

0

If set, the camera image will be flipped horizontally

Enable this if the eye-tracker is mounted up-side down.

camera-vertically-flipped

0: false
1: true

0

If set, the camera image will be flipped vertically

Enable this if the eye-tracker is mounted up-side down.

eye-tracker-stand

0: EyeVec stand lower notch
1: EyeVec stand middle notch
2: EyeVec stand upper notch
3: tripod/other

2

Eye-tracker stand

camera-height

[40, 300]

depends on eye-tracker stand

Vertical distance from base (desktop) to camera pivot axis [mm]

camera-screen-distance

[0, 5000]

160

Horizontal distance from camera pivot axis to vertical screen center [mm]

screen-center-height

[0, 500]

250

Vertical distance from base (desktop) to vertical screen center [mm]

eye-height

[250, 650]

475

Vertical distance from base (desktop) to eye [mm]

subject-distance

[500, 800]

600

Subject distance from camera [mm]

This is the distance the camera is focussed on.

screen-number

0 or [1, 6]
where 0 means use same screen as control application

1

Number of the screen below which the eye-tracker is placed

screen-width

0 or [100, 5000]
where 0 means retrieve screen size from system

0

Screen width [mm]

Only define this if presenting stimuli using a beamer or if other means of stimulus presentation are used.

screen-height

0 or [100, 2000]
where 0 means retrieve screen size from system

0

Screen height [mm]

Only define this if presenting stimuli using a beamer or if other means of stimulus presentation are used.