Ellipse Object
The Ellipse object draws a vector ellipse on a canvas frame. In a square box it is a circle, which makes it the object for dots, rings and circular placeholders. It stays sharp at any size and needs no image file. Stroke and fill can differ per condition and can change during the experiment through events.
The outline of the ellipse is also its hit area: a click inside the ellipse counts as a click on the object whether or not it is filled, and a click in the empty corner of its bounding box does not. The same region is used when a gaze or fixation trigger is limited to the ellipse as a target. For other outlines, see the Rectangle, Line, Arrow and Polygon objects.
Table of Contents
Adding the Ellipse Object
In the task editor toolbar, open the Images & Drawing group and select Ellipse to add an Ellipse object to the current frame.
A new ellipse is 200 wide and 200 high, so it starts as a circle, with a black stroke 2 wide and no fill.
Shapes can be added to canvas frames. The Images & Drawing group is not offered on page frames or website frames.
The For Each Object demo in the Labvanced library moves a set of circles on a frame, colors each one, and updates their positions every second.
Sizing, Moving and Rotating
The ellipse always fills its box. Set X, Y, Width, Height and Rotation in the Object Properties panel, or drag on the frame. Keep Width and Height equal for a circle. A selected ellipse shows eight resize handles and a rotation handle above its top edge. Hold Shift while resizing to keep the aspect ratio, or while rotating to snap to 15 degree steps.
Object Properties
All settings below are found in the properties panel when the Ellipse is selected. They appear in the shape's own section, under a header with the shape's name.
Ellipse settings
| Property | Default | Description |
|---|---|---|
Stroke width | 2 | Width of the outline in frame units. 0 draws no outline. The stroke is drawn inside the box, so the box is the outer visible edge. |
Stroke color | Black | Color of the outline. |
Fill | Off | A checkbox plus a color picker. When checked, the inside of the ellipse is painted in the chosen color. When unchecked, the inside is transparent. |
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.
Common looks
- Dot: a small box with
Fillon and aStroke widthof0. - Ring:
Filloff and a thickStroke width. - Placeholder circle:
Filloff and the default stroke.
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.
Hit Area and Hit Margin
The hit area of an Ellipse is the whole ellipse, whether it is filled or not. Hit margin widens this region by the given number of frame units on every side, also beyond the box. The margin is invisible to participants.
Use a hit margin to make a small dot easier to click, or to give a gaze target some tolerance. The same region is used for mouse triggers in the player and for Eyetracking Gaze and Eyetracking Fixation triggers that are limited to target objects.
Events Integration
The Ellipse 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 ellipse 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 an ellipse 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 and Hit margin. 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.
Example: highlight a circle when it is clicked
Trigger:
Mouse→Set Target: your Ellipse →Click
Action:Set Object Property→Set Target: your Ellipse →Stroke color→ a highlight color
Example: continue once the participant looks at a circle
Trigger:
Eyetracking Fixation→ select your Ellipse 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.
Further Reading
Object Properties
The properties panel all objects share, including the shape settings for stroke, fill and hit margin.
Eyetracking Fixation Trigger
React when a participant fixates a shape, using its hit area and hit margin.
All Objects
A full index of all objects available in the Labvanced experiment editor, including display, input, media, and recording elements.