Skip to content

Eye Tracker Validation Step

Martin Konopka edited this page Mar 6, 2019 · 7 revisions

Display a point sequence animation to focus participant's attention to predefined locations on screen. The point animation is similar to the Eye Tracker Calibration step. The default 9-point plan consists of 9 combinations of { 0.1, 0.5, 0.9 } values from the top left to the bottom right locations on the screen:

[ 0.1, 0.1 ], [ 0.1, 0.5 ], [ 0.1, 0.9 ], 
[ 0.5, 0.1 ], [ 0.5, 0.5 ], [ 0.5, 0.9 ], 
[ 0.9, 0.1 ], [ 0.9, 0.5 ], [ 0.9, 0.9 ]

This sequence results in the following animation starting in the top left corner.

[*]      *       *
 |     / |     / |
 |    /  |    /  |
 *   /   *   /   *
 |  /    |  /    |
 | /     | /     |
 *       *       *

Any custom sequence may defined in the definition which will override the default 9-plan, together with duration of each animation step:

Definition

  • actionType : "EyeTrackerValidation" (required)
  • points : Point2D[] (optional) - custom point sequence, if null or empty, the default 9-plan is used. Points may be defined in 2 ways, e.g, for (0.4, 0.3) location:
    • As a tuple [ 0.4, 0.3 ]
    • As a Point2D object { x : 0.4, y : 0.3 }
  • pointDuration : int (millisecond, optional) - how long the point stays on the location.
    • default: 2000
  • movementDuration : int (millisecond, optional) - duration of the movement animation.
  • messageDuration : TimeSpan (optional) - how long the instruction message should be displayed.
    • default: 00:00:03
  • message : string (optional) - brief instructions displayed before the animation starts.
    • default: "Follow the green point"
  • pointColor : Color - fill color of the animated point.

Eye Tracker Validation step is a content step, it can be configured with additional settings common for all content steps. See Content Step styling for details.

Result

Contains detailed information about the animation.

  • resultType - "Successful", if the sequence completed; "Skipped", if step timeout expired or hotkey was pressed; otherwise, "Failed".
  • points : PointDisplayTime[] - array of objects with points and timestamps. Each object contains:
    • point : Point2D - validation point location, as defined in the step definition.
    • startTime : DateTime - local timestamp when the point was displayed on the target location.
    • endTime : DateTime - local timestamp when the point started animating to the next location.
Clone this wiki locally