Fixation Target Object
The Fixation Target object draws a fixation symbol on a canvas frame, in one of seven styles. It stays sharp at any size, needs no image file, and its style, color and size can differ per condition or change during the experiment through events. The default is a plain cross (+).
Each style has one numeric parameter, so one style covers several variants such as a disc with and without a hole. Together the styles include all targets compared by Thaler et al. (2013), including the combination of bullseye and cross hair that the study recommends for experiments that require stable fixation.
Table of Contents
Adding the Fixation Target Object
In the task editor toolbar, open the Images & Drawing group and select Fixation Target to add a Fixation Target object to the current frame.
A new fixation target is 40 wide and 40 high, with Keep Aspect Ratio on, a black stroke 2 wide and the Cross (+) style. Set X, Y, Width and Height in the Object Properties panel, or drag on the frame. A selected target shows eight resize handles and a rotation handle above its top edge.
Shapes can be added to canvas frames. The Images & Drawing group is not offered on page frames or website frames.
Object Properties
All settings below are found in the properties panel when the Fixation Target is selected. They appear in the shape's own section, under a header with the shape's name.
Fixation Target settings
| Property | Default | Description |
|---|---|---|
Style | Cross (+) | An icon picker with the seven styles. Each icon is a style with a typical parameter value. See Fixation Target Styles. |
| Style parameter | 0 | The second setting below the picker. Its label depends on the style (Hole size, Gap size or Dot size) and its value is a share of the target size (× size), from 0 to 1 in steps of 0.05. |
Stroke width | 2 | Width of the bars and lines of the symbol in frame units. |
Stroke color | Black | Color of the symbol. |
Fill | Off | A checkbox plus a color picker. It paints the inside of the circle in the circle styles. |
Hit margin | 0 | An extra band around the hit area, in frame units. See Hit Area and Hit Margin. |
Like other object properties, each setting can differ per trial type, and a value that differs from the default is shown with a dark gray background.
Style
Visibility works as for any other object. The generic Scaling, Border-Size, Border-Color, BG-Color, Transparent, Roundness, Overflow-X, Overflow-Y and Scroll Margin settings are hidden for shapes. Use Stroke color and Fill instead.
Custom CSS
The Change CSS Properties option works as for other objects. See Object Properties.
Fixation Target Styles
Pick the style from the Style icon picker. Each column of the picker is a style, and each icon in it is a variant with a typical parameter value. The name of the selected variant shows below the picker. You can also type any parameter value between 0 and 1. The picker then shows the style name without a variant label.
| Style | Parameter label | Variants offered in the picker |
|---|---|---|
Disc | Hole size | Disc, Disc with hole |
Cross (+) | Gap size | Cross (+), Cross (+) with centre gap |
Cross (×) | Gap size | Cross (×), Cross (×) with centre gap |
Circle | Dot size | Circle, Bullseye (circle with dot) |
Circle with + | Gap size | Circle with +, Circle with + and centre gap |
Circle with × | Gap size | Circle with ×, Circle with × and centre gap |
Disc with cut-out cross | Dot size | Disc with cut-out cross (BC), Disc with cut-out cross and dot (ABC) |
The variant names BC and ABC follow Thaler et al. (2013), who recommend the combination of bullseye and cross hair (ABC) for experiments that require stable fixation. In Labvanced, Disc with cut-out cross and dot (ABC) is that target. The cross bars and the cut-out cross are as wide as Stroke width, while the target size follows Width and Height.
Hit Area and Hit Margin
The hit area of a Fixation Target is always the ellipse inscribed in its box, a circle with the default square box, plus the hit margin. The thin bars of a cross are too narrow to work as a gaze target, so a fixation check on the target tests the whole circle. Hit margin widens this region by the given number of frame units on every side and is invisible to participants.
Events Integration
The Fixation Target can be the target of the general object triggers. Common examples:
Mouse: react to aClick,PressDown,PressUp,Hover,LeaveorMoveon the object, measured against its hit area.Eyetracking GazeandEyetracking Fixation: limit the trigger to the Fixation Target as a target to react when gaze or a fixation lands in its hit area. See the Eyetracking Fixation Trigger and Eyetracking Gaze Trigger pages.
To change a fixation target while the experiment runs, use the Set Object Property Action. The properties are listed with their panel names: Stroke color, Stroke width, Fill, Fill color, Hit margin, Style and Style parameter. The box values (X, Y, Width, Height, Rotation and Visibility) are available as for every object. The same properties can be read into a variable with Set / Record Variable, using Object Property as the value source.
Style takes the style as a short id: dot, plus, cross, circle, circlePlus, circleCross or abc, in the order of the table above. Use the id, not the name shown in the picker. Style parameter is the number between 0 and 1.
Example: continue once the participant fixates the target
Trigger:
Eyetracking Fixation→ select your Fixation Target as a target
Action:Jump to Next Frame
Webcam gaze estimates scatter around the true fixation point, so give a gaze target a Hit margin that allows for this.
Changing the symbol between conditions
Select a condition in Trials & Conditions and change Style to another style. The target keeps its position and size, and only the symbol changes.
Reference
Thaler, L., Schütz, A. C., Goodale, M. A., & Gegenfurtner, K. R. (2013). What is the best fixation target? The effect of target shape on stability of fixational eye movements. Vision Research, 76, 31-42. https://doi.org/10.1016/j.visres.2012.10.012
Further Reading
Eyetracking Fixation Trigger
React when a participant fixates a shape, using its hit area and hit margin.
Object Properties
The properties panel all objects share, including the shape settings for stroke, fill and hit margin.
All Objects
A full index of all objects available in the Labvanced experiment editor, including display, input, media, and recording elements.