GazefilterEvent

Title: GazefilterEvent

Description: Events from gazefilter.app.

JSON schema source for the events is available at gazefilter.app/event.schema.json.

One of(Option)
GazefilterChannelEvent
GazefilterInterfaceEvent
GazefilterFocusEvent
GazefilterVisibilityEvent
GazefilterConfigEvent
GazefilterConnectEvent
GazefilterCaptureEvent
GazefilterDisposeEvent

1. Property GazefilterChannelEvent

Title: GazefilterChannelEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Handshake event. Sent once the app is ready to communicate.

1.1. [Required] Property type

Type	const
Required	Yes

Specific value: "channel"

1.2. [Required] Property timeOrigin

Type	number
Required	Yes
Format	double

Description: Timestamp of the web application initialization.

See performance.timeOrigin.

1.3. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

2. Property GazefilterInterfaceEvent

Title: GazefilterInterfaceEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Interface type change event.

2.1. [Required] Property type

Type	const
Required	Yes

Specific value: "interface"

2.2. [Required] Property interfaceMode

Type	enum (of string)
Required	Yes
Defined in	#/$defs/InterfaceMode

Description: Updated interface mode.

Must be one of:

• “status”
• “tracker”
• “calibration”

2.3. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

3. Property GazefilterFocusEvent

Title: GazefilterFocusEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Browser focus event. Sent every time window is focused or blurred.

3.1. [Required] Property type

Type	const
Required	Yes

Specific value: "focus"

3.2. [Required] Property hasFocus

Type	boolean
Required	Yes

Description: Whether the application window has focus.

See document.hasFocus.

3.3. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

4. Property GazefilterVisibilityEvent

Title: GazefilterVisibilityEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Document visibility change event. Sent every time the document is hidden or shown.

4.1. [Required] Property type

Type	const
Required	Yes

Specific value: "visibility"

4.2. [Required] Property visibilityState

Type	enum (of string)
Required	Yes
Defined in	#/$defs/VisibilityState

Description: Current visibility state of the document.

See document.visibilityState.

Must be one of:

• “unknown”
• “hidden”
• “visible”

4.3. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

5. Property GazefilterConfigEvent

Title: GazefilterConfigEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Gazefilter configuration update event.

5.1. [Required] Property type

Type	const
Required	Yes

Specific value: "config"

5.2. [Required] Property gazefilterConfig

Type	object
Required	Yes
Additional properties	[Any type: allowed]
Defined in	#/$defs/GazefilterConfig

Description: Updated gazefilter configuration.

5.2.1. [Optional] Property user

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
UserConfig
item 1

5.2.1.1. Property UserConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/UserConfig

5.2.1.1.1. [Optional] Property face_model

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
FaceModel
item 1

5.2.1.1.1.1. Property FaceModel

Type	object
Required	No
Additional properties	[Should-conform]
Defined in	#/$defs/FaceModel

5.2.1.1.1.1.1. Property additionalProperties

Type	array of number
Required	No

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
additionalProperties items	-

5.2.1.1.1.1.1.1. additionalProperties items

Type	number
Required	No
Format	float

5.2.1.1.1.2. Property item 1

Type	null
Required	No

5.2.1.1.2. [Optional] Property vision

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
Vision
item 1

5.2.1.1.2.1. Property Vision

Type	combining
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/Vision

One of(Option)
item 0
item 1

5.2.1.1.2.1.1. Property item 0

Type	object
Required	No
Additional properties	[Any type: allowed]

5.2.1.1.2.1.1.1. [Required] Property type

Type	const
Required	Yes

Specific value: "binocular"

5.2.1.1.2.1.2. Property item 1

Type	object
Required	No
Additional properties	[Any type: allowed]

5.2.1.1.2.1.2.1. [Required] Property type

Type	const
Required	Yes

Specific value: "monocular"

5.2.1.1.2.1.2.2. [Required] Property side

Type	combining
Required	Yes
Additional properties	[Any type: allowed]
Defined in	#/$defs/Side

One of(Option)
item 0
item 1

5.2.1.1.2.1.2.2.1. Property item 0

Type	const
Required	No

Description: Left side.

Specific value: "left"

5.2.1.1.2.1.2.2.2. Property item 1

Type	const
Required	No

Description: Right side.

Specific value: "right"

5.2.1.1.2.2. Property item 1

Type	null
Required	No

5.2.1.2. Property item 1

Type	null
Required	No

5.2.2. [Optional] Property camera

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
CameraConfig
item 1

5.2.2.1. Property CameraConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/CameraConfig

5.2.2.1.1. [Optional] Property intrinsics

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
CameraIntrinsicsConfig
item 1

5.2.2.1.1.1. Property CameraIntrinsicsConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/CameraIntrinsicsConfig

5.2.2.1.1.1.1. [Optional] Property focals

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
focals item 0	-
focals item 1	-

5.2.2.1.1.1.1.1. focals item 0

Type	number
Required	No
Format	double

5.2.2.1.1.1.1.2. focals item 1

Type	number
Required	No
Format	double

5.2.2.1.1.1.2. [Optional] Property principal

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
principal item 0	-
principal item 1	-

5.2.2.1.1.1.2.1. principal item 0

Type	number
Required	No
Format	double

5.2.2.1.1.1.2.2. principal item 1

Type	number
Required	No
Format	double

5.2.2.1.1.1.3. [Optional] Property skew

Type	number or null
Required	No
Format	double
Default	null

5.2.2.1.1.2. Property item 1

Type	null
Required	No

5.2.2.1.2. [Optional] Property specs

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
CameraSpecificationConfig
item 1

5.2.2.1.2.1. Property CameraSpecificationConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/CameraSpecificationConfig

5.2.2.1.2.1.1. [Optional] Property pixels

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
pixels item 0	-
pixels item 1	-

5.2.2.1.2.1.1.1. pixels item 0

Type	integer
Required	No
Format	uint

Restrictions
Minimum	≥ 0

5.2.2.1.2.1.1.2. pixels item 1

Type	integer
Required	No
Format	uint

Restrictions
Minimum	≥ 0

5.2.2.1.2.1.2. [Optional] Property dimensions

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
dimensions item 0	-
dimensions item 1	-

5.2.2.1.2.1.2.1. dimensions item 0

Type	number
Required	No
Format	double

5.2.2.1.2.1.2.2. dimensions item 1

Type	number
Required	No
Format	double

5.2.2.1.2.2. Property item 1

Type	null
Required	No

5.2.2.1.3. [Optional] Property fps

Type	number or null
Required	No
Format	double
Default	null

5.2.2.1.4. [Optional] Property fov

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
FieldOfView
item 1

5.2.2.1.4.1. Property FieldOfView

Type	combining
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/FieldOfView

Description: Camera Field of View in degrees.

One of(Option)
item 0
item 1
item 2

5.2.2.1.4.1.1. Property item 0

Type	object
Required	No
Additional properties	[Not allowed]

5.2.2.1.4.1.1.1. [Required] Property horizontal

Type	number
Required	Yes
Format	double

5.2.2.1.4.1.2. Property item 1

Type	object
Required	No
Additional properties	[Not allowed]

5.2.2.1.4.1.2.1. [Required] Property vertical

Type	number
Required	Yes
Format	double

5.2.2.1.4.1.3. Property item 2

Type	object
Required	No
Additional properties	[Not allowed]

5.2.2.1.4.1.3.1. [Required] Property diagonal

Type	number
Required	Yes
Format	double

5.2.2.1.4.2. Property item 1

Type	null
Required	No

5.2.2.2. Property item 1

Type	null
Required	No

5.2.3. [Optional] Property screen

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
ScreenConfig
item 1

5.2.3.1. Property ScreenConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/ScreenConfig

5.2.3.1.1. [Optional] Property offset

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
offset item 0	-
offset item 1	-

5.2.3.1.1.1. offset item 0

Type	integer
Required	No
Format	int32

5.2.3.1.1.2. offset item 1

Type	integer
Required	No
Format	int32

5.2.3.1.2. [Optional] Property resolution

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
resolution item 0	-
resolution item 1	-

5.2.3.1.2.1. resolution item 0

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

5.2.3.1.2.2. resolution item 1

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

5.2.3.1.3. [Optional] Property pixel

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
pixel item 0	-
pixel item 1	-

5.2.3.1.3.1. pixel item 0

Type	number
Required	No
Format	float

5.2.3.1.3.2. pixel item 1

Type	number
Required	No
Format	float

5.2.3.2. Property item 1

Type	null
Required	No

5.2.4. [Optional] Property core

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
CoreConfig
item 1

5.2.4.1. Property CoreConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/CoreConfig

5.2.4.1.1. [Optional] Property seed

Type	integer or null
Required	No
Format	uint64
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.2. [Optional] Property face

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
FaceTrackerConfig
item 1

5.2.4.1.2.1. Property FaceTrackerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/FaceTrackerConfig

5.2.4.1.2.1.1. [Optional] Property tolerance

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.2. [Optional] Property threshold

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.3. [Optional] Property detect

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
DetectConfig
item 1

5.2.4.1.2.1.3.1. Property DetectConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/DetectConfig

5.2.4.1.2.1.3.1.1. [Optional] Property multiscaler

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
MultiscalerConfig
item 1

5.2.4.1.2.1.3.1.1.1. Property MultiscalerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/MultiscalerConfig

5.2.4.1.2.1.3.1.1.1.1. [Optional] Property min_size

Type	integer or null
Required	No
Format	uint32
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.2.1.3.1.1.1.2. [Optional] Property max_size

Type	integer or null
Required	No
Format	uint32
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.2.1.3.1.1.1.3. [Optional] Property shift_factor

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.3.1.1.1.4. [Optional] Property scale_factor

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.3.1.1.2. Property item 1

Type	null
Required	No

5.2.4.1.2.1.3.1.2. [Optional] Property padding

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PaddingConfig
item 1

5.2.4.1.2.1.3.1.2.1. Property PaddingConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PaddingConfig

5.2.4.1.2.1.3.1.2.1.1. [Optional] Property top

Type	integer or null
Required	No
Format	int32
Default	null

5.2.4.1.2.1.3.1.2.1.2. [Optional] Property left

Type	integer or null
Required	No
Format	int32
Default	null

5.2.4.1.2.1.3.1.2.1.3. [Optional] Property right

Type	integer or null
Required	No
Format	int32
Default	null

5.2.4.1.2.1.3.1.2.1.4. [Optional] Property bottom

Type	integer or null
Required	No
Format	int32
Default	null

5.2.4.1.2.1.3.1.2.2. Property item 1

Type	null
Required	No

5.2.4.1.2.1.3.1.3. [Optional] Property clusterizer

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
ClusterizerConfig
item 1

5.2.4.1.2.1.3.1.3.1. Property ClusterizerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/ClusterizerConfig

5.2.4.1.2.1.3.1.3.1.1. [Optional] Property intersection_threshold

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.3.1.3.1.2. [Optional] Property score_threshold

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.3.1.3.2. Property item 1

Type	null
Required	No

5.2.4.1.2.1.3.2. Property item 1

Type	null
Required	No

5.2.4.1.2.1.4. [Optional] Property redetect

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
RedetectConfig
item 1

5.2.4.1.2.1.4.1. Property RedetectConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/RedetectConfig

5.2.4.1.2.1.4.1.1. [Optional] Property shift_factor

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.4.1.2. [Optional] Property stride_count

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.2.1.4.2. Property item 1

Type	null
Required	No

5.2.4.1.2.1.5. [Optional] Property filter

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
FilterConfig
item 1

5.2.4.1.2.1.5.1. Property FilterConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/FilterConfig

5.2.4.1.2.1.5.1.1. [Optional] Property beta

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.5.1.2. [Optional] Property mincutoff

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.5.1.3. [Optional] Property dcutoff

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.2.1.5.2. Property item 1

Type	null
Required	No

5.2.4.1.2.2. Property item 1

Type	null
Required	No

5.2.4.1.3. [Optional] Property pose

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PoseTrackerConfig
item 1

5.2.4.1.3.1. Property PoseTrackerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PoseTrackerConfig

5.2.4.1.3.1.1. [Optional] Property solver

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PoseSolverConfig
item 1

5.2.4.1.3.1.1.1. Property PoseSolverConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PoseSolverConfig

5.2.4.1.3.1.1.1.1. [Optional] Property consensus

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PoseConsensusConfig
item 1

5.2.4.1.3.1.1.1.1.1. Property PoseConsensusConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PoseConsensusConfig

5.2.4.1.3.1.1.1.1.1.1. [Optional] Property initialization_hypotheses

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.1.1.2. [Optional] Property initialization_blocks

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.1.1.3. [Optional] Property max_candidate_hypotheses

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.1.1.4. [Optional] Property estimations_per_block

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.1.1.5. [Optional] Property block_size

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.1.1.6. [Optional] Property likelihood_ratio_threshold

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.3.1.1.1.1.1.7. [Optional] Property inlier_threshold

Type	number or null
Required	No
Format	double
Default	null

5.2.4.1.3.1.1.1.1.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.1.1.2. [Optional] Property estimator

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PoseEstimatorConfig
item 1

5.2.4.1.3.1.1.1.2.1. Property PoseEstimatorConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PoseEstimatorConfig

5.2.4.1.3.1.1.1.2.1.1. [Optional] Property gauss_newton_iterations

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.2.1.2. [Optional] Property rotation_convergence_iterations

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.2.1.3. [Optional] Property rotation_convergence_epsilon

Type	number or null
Required	No
Format	double
Default	null

5.2.4.1.3.1.1.1.2.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.1.1.3. [Optional] Property optimizer

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PoseOptimizerConfig
item 1

5.2.4.1.3.1.1.1.3.1. Property PoseOptimizerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PoseOptimizerConfig

5.2.4.1.3.1.1.1.3.1.1. [Optional] Property ftol

Type	number or null
Required	No
Format	double
Default	null

5.2.4.1.3.1.1.1.3.1.2. [Optional] Property xtol

Type	number or null
Required	No
Format	double
Default	null

5.2.4.1.3.1.1.1.3.1.3. [Optional] Property gtol

Type	number or null
Required	No
Format	double
Default	null

5.2.4.1.3.1.1.1.3.1.4. [Optional] Property stepbound

Type	number or null
Required	No
Format	double
Default	null

5.2.4.1.3.1.1.1.3.1.5. [Optional] Property patience

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.3.1.1.1.3.1.6. [Optional] Property scale_diag

Type	boolean or null
Required	No
Default	null

5.2.4.1.3.1.1.1.3.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.1.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.2. [Optional] Property filter

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PoseFilterConfig
item 1

5.2.4.1.3.1.2.1. Property PoseFilterConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PoseFilterConfig

5.2.4.1.3.1.2.1.1. [Optional] Property translation

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
KalmanFilter3DConfig
item 1

5.2.4.1.3.1.2.1.1.1. Property KalmanFilter3DConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/KalmanFilter3DConfig

5.2.4.1.3.1.2.1.1.1.1. [Optional] Property process_error_covariance

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.3.1.2.1.1.1.2. [Optional] Property measurement_error_covariance

Type	number or null
Required	No
Format	float
Default	null

5.2.4.1.3.1.2.1.1.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.2.1.2. [Optional] Property rotation

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
KalmanFilter3DConfig
item 1

5.2.4.1.3.1.2.1.2.1. Property KalmanFilter3DConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Same definition as	KalmanFilterConfig

5.2.4.1.3.1.2.1.2.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.2.2. Property item 1

Type	null
Required	No

5.2.4.1.3.1.3. [Optional] Property keys

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	N/A
Max items	N/A
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
FacePin	-

5.2.4.1.3.1.3.1. FacePin

Type	enum (of string)
Required	No
Defined in	#/$defs/FacePin

Must be one of:

• “nose_bottom”
• “nose_top”
• “nose_tip”
• “left_eye_inner_corner”
• “left_eye_outer_corner”
• “right_eye_inner_corner”
• “right_eye_outer_corner”
• “left_eye_lower_lid”
• “left_eye_upper_lid”
• “right_eye_lower_lid”
• “right_eye_upper_lid”
• “left_mouth_corner”
• “right_mouth_corner”
• “chin_tip”

5.2.4.1.3.2. Property item 1

Type	null
Required	No

5.2.4.1.4. [Optional] Property eye

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
EyeTrackerConfig
item 1

5.2.4.1.4.1. Property EyeTrackerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/EyeTrackerConfig

5.2.4.1.4.1.1. [Optional] Property scale

Type	number or null
Required	No
Format	float

5.2.4.1.4.2. Property item 1

Type	null
Required	No

5.2.4.1.5. [Optional] Property pupil

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PupilTrackerConfig
item 1

5.2.4.1.5.1. Property PupilTrackerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PupilTrackerConfig

5.2.4.1.5.1.1. [Optional] Property localize

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
LocalizeConfig
item 1

5.2.4.1.5.1.1.1. Property LocalizeConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/LocalizeConfig

5.2.4.1.5.1.1.1.1. [Optional] Property perturbator

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
PerturbatorConfig
item 1

5.2.4.1.5.1.1.1.1.1. Property PerturbatorConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/PerturbatorConfig

5.2.4.1.5.1.1.1.1.1.1. [Optional] Property translate

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
translate item 0	-
translate item 1	-

5.2.4.1.5.1.1.1.1.1.1.1. translate item 0

Type	number
Required	No
Format	float

5.2.4.1.5.1.1.1.1.1.1.2. translate item 1

Type	number
Required	No
Format	float

5.2.4.1.5.1.1.1.1.1.2. [Optional] Property scale

Type	array or null
Required	No
Default	null

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
scale item 0	-
scale item 1	-

5.2.4.1.5.1.1.1.1.1.2.1. scale item 0

Type	number
Required	No
Format	float

5.2.4.1.5.1.1.1.1.1.2.2. scale item 1

Type	number
Required	No
Format	float

5.2.4.1.5.1.1.1.1.2. Property item 1

Type	null
Required	No

5.2.4.1.5.1.1.1.2. [Optional] Property perturbations

Type	integer or null
Required	No
Format	uint
Default	null

Restrictions
Minimum	≥ 0

5.2.4.1.5.1.1.2. Property item 1

Type	null
Required	No

5.2.4.1.5.1.2. [Optional] Property filter

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
FilterConfig
item 1

5.2.4.1.5.1.2.1. Property FilterConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Same definition as	oneOf_i4_gazefilterConfig_core_anyOf_i0_face_anyOf_i0_filter_anyOf_i0

5.2.4.1.5.1.2.2. Property item 1

Type	null
Required	No

5.2.4.1.5.2. Property item 1

Type	null
Required	No

5.2.4.1.6. [Optional] Property gaze

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
GazeTrackerConfig
item 1

5.2.4.1.6.1. Property GazeTrackerConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/GazeTrackerConfig

5.2.4.1.6.1.1. [Optional] Property threshold

Type	number or null
Required	No
Format	float

5.2.4.1.6.1.2. [Optional] Property tolerance

Type	number or null
Required	No
Format	float

5.2.4.1.6.1.3. [Optional] Property filter

Type	combining
Required	No
Additional properties	[Any type: allowed]

Any of(Option)
FilterConfig
item 1

5.2.4.1.6.1.3.1. Property FilterConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Same definition as	oneOf_i4_gazefilterConfig_core_anyOf_i0_face_anyOf_i0_filter_anyOf_i0

5.2.4.1.6.1.3.2. Property item 1

Type	null
Required	No

5.2.4.1.6.2. Property item 1

Type	null
Required	No

5.2.4.2. Property item 1

Type	null
Required	No

5.2.5. [Optional] Property backend

Type	combining
Required	No
Additional properties	[Any type: allowed]
Default	null

Any of(Option)
BackendConfig
item 1

5.2.5.1. Property BackendConfig

Type	object
Required	No
Additional properties	[Any type: allowed]
Defined in	#/$defs/BackendConfig

5.2.5.1.1. [Optional] Property face_detector

Type	string or null
Required	No
Default	null

5.2.5.1.2. [Optional] Property face_shaper

Type	string or null
Required	No
Default	null

5.2.5.1.3. [Optional] Property face_pinmap

Type	string or null
Required	No
Default	null

5.2.5.1.4. [Optional] Property pupil_localizer

Type	string or null
Required	No
Default	null

5.2.5.1.5. [Optional] Property gaze_calibration

Type	string or null
Required	No
Default	null

5.2.5.2. Property item 1

Type	null
Required	No

5.3. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

6. Property GazefilterConnectEvent

Title: GazefilterConnectEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Device connect event.

6.1. [Required] Property type

Type	const
Required	Yes

Specific value: "connect"

6.2. [Required] Property frameRate

Type	number
Required	Yes
Format	double

Description: Frames per second of the connected device.

See MediaTrackSettings.frameRate.

6.3. [Required] Property frameSize

Type	array
Required	Yes

Description: Frame size in pixels of the connected device as width and height.

See MediaTrackSettings.width and MediaTrackSettings.height.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
frameSize item 0	-
frameSize item 1	-

6.3.1. frameSize item 0

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

6.3.2. frameSize item 1

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

6.4. [Required] Property deviceLabel

Type	string
Required	Yes

Description: Label of the connected device.

See MediaDeviceInfo.label.

6.5. [Optional] Property facingMode

Type	combining
Required	No
Additional properties	[Any type: allowed]

Description: Facing mode of the connected device.

See MediaTrackSettings.facingMode.

Any of(Option)
FacingMode
item 1

6.5.1. Property FacingMode

Type	enum (of string)
Required	No
Defined in	#/$defs/FacingMode

Must be one of:

• “user”
• “environment”
• “left”
• “right”

6.5.2. Property item 1

Type	null
Required	No

6.6. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

7. Property GazefilterCaptureEvent

Title: GazefilterCaptureEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Tracking event. Sent every time the new frame is processed.

7.1. [Required] Property type

Type	const
Required	Yes

Specific value: "capture"

7.2. [Required] Property presentedFrames

Type	integer
Required	Yes
Format	uint32

Description: See presentedFrames in HTMLVideoElement.requestVideoFrameCallback#metadata

Restrictions
Minimum	≥ 0

7.3. [Required] Property frameSize

Type	array
Required	Yes

Description: See width and height in HTMLVideoElement.requestVideoFrameCallback#metadata

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
frameSize item 0	-
frameSize item 1	-

7.3.1. frameSize item 0

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

7.3.2. frameSize item 1

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

7.4. [Required] Property presentationTime

Type	number
Required	Yes
Format	double

Description: See presentationTime in HTMLVideoElement.requestVideoFrameCallback#metadata

7.5. [Required] Property expectedDisplayTime

Type	number
Required	Yes
Format	double

Description: See expectedDisplayTime in HTMLVideoElement.requestVideoFrameCallback#metadata

7.6. [Required] Property mediaTime

Type	number
Required	Yes
Format	double

Description: See mediaTime in HTMLVideoElement.requestVideoFrameCallback#metadata

7.7. [Optional] Property processingDuration

Type	number
Required	No
Format	double
Default	null

Description: See processingDuration in HTMLVideoElement.requestVideoFrameCallback#metadata

7.8. [Optional] Property captureTime

Type	number
Required	No
Format	double
Default	null

Description: See captureTime in HTMLVideoElement.requestVideoFrameCallback#metadata

7.9. [Optional] Property trackTime

Type	number
Required	No
Format	double
Default	0.0

Description: Monotonic time in milliseconds since the tracking initialization.

7.10. [Optional] Property frameOffset

Type	array of integer
Required	No
Default	[0, 0]

Description: Difference between camera model frame and processed image in pixels.

Positive values means camera frame is bigger than image, and negative values means camera frame is smaller than image.

Default values are [0, 0] and means that camera frame is same as image.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
frameOffset items	-

7.10.1. frameOffset items

Type	integer
Required	No
Format	int32

7.11. [Optional] Property frameOrigin

Type	array of integer
Required	No
Default	[0, 0]

Description: Camera model frame center coordinates in pixels.

Denormalize data point to frame coordinates:

(data_point + 1) * frame_origin.

To convert to image coordinates:

(data_point + 1) * frame_origin + frame_offset.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
frameOrigin items	-

7.11.1. frameOrigin items

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

7.12. [Optional] Property cameraFocal

Type	array of number
Required	No
Default	[1.0, 1.0]

Description: Pinhole camera model focal values in sensor pixel size.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
cameraFocal items	-

7.12.1. cameraFocal items

Type	number
Required	No
Format	float

7.13. [Optional] Property screenOffset

Type	array of integer
Required	No
Default	[0, 0]

Description: Current screen position on virtual screen in pixels.

Default values are [0, 0] and means that current screen is primary.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
screenOffset items	-

7.13.1. screenOffset items

Type	integer
Required	No
Format	int32

7.14. [Optional] Property screenOrigin

Type	array of integer
Required	No
Default	[0, 0]

Description: Screen center coordinates in pixels.

Denormalize gaze point to screen coordinates:

• current: (gaze_point + 1) * screen_origin,
• virtual: (gaze_point + 1) * screen_origin + screen_offset.

Default values are zero and means that screen is not set by the runtime environment.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
screenOrigin items	-

7.14.1. screenOrigin items

Type	integer
Required	No
Format	uint32

Restrictions
Minimum	≥ 0

7.15. [Optional] Property screenPixel

Type	array of number
Required	No
Default	[1.0, 1.0]

Description: Screen pixel size.

Default values are [1.0, 1.0].

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
screenPixel items	-

7.15.1. screenPixel items

Type	number
Required	No
Format	float

7.16. [Optional] Property calibConfidence

Type	object
Required	No
Additional properties	[Any type: allowed]
Default	{"left": -1.0, "right": -1.0}
Defined in	#/$defs/Pair_for_float

Description: Gaze calibration confidence.

Values are in range 0..1. In case gaze is not calibrated values are negative (-1).

7.16.1. [Required] Property left

Type	number
Required	Yes
Format	float

7.16.2. [Required] Property right

Type	number
Required	Yes
Format	float

7.17. [Optional] Property calibOrigin

Type	array of number
Required	No
Default	[0.0, 0.0, -1.0]

Description: Calibration bounding box center in camera space.

If no calibration is performed X and Y values are zero and Z is negative.

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
calibOrigin items	-

7.17.1. calibOrigin items

Type	number
Required	No
Format	float

7.18. [Optional] Property calibSpace

Type	array of number
Required	No
Default	[0.0, 0.0, 0.0]

Description: Half-size of the calibration bounding box in each direction.

If no calibration is performed, values are zero. Use calib_confidence field for validation.

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
calibSpace items	-

7.18.1. calibSpace items

Type	number
Required	No
Format	float

7.19. [Optional] Property calibTarget

Type	array of number
Required	No
Default	[0.0, 0.0, 0.0]

Description: Calibration target

Values are [X, Y, W], where X and Y normalized values on screen axes and W is the weight of the calibration target. Data is not valid if W is negative.

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
calibTarget items	-

7.19.1. calibTarget items

Type	number
Required	No
Format	float

7.20. [Optional] Property trackEvent

Type	enum (of integer)
Required	No
Default	0
Defined in	#/$defs/TrackEventType

Description: Track event enumeration.

Possible values are:

• -1 - lost,
• 0 - unknown (default),
• 1 - found,
• 2 - tracking.

Properties:

• if greater than 0, the face is detected and tracked,
• if less equal than 0, no face detected or it was lost.

Must be one of:

• -1
• 0
• 1
• 2

7.21. [Optional] Property faceConfidence

Type	number
Required	No
Format	float
Default	0.0

Description: Face confidence value.

Negative values means face is not detected.

7.22. [Optional] Property gazeEvent

Type	enum (of integer)
Required	No
Default	0
Defined in	#/$defs/GazeEventType

Description: Gaze event.

Possible values are:

• -1 - blink,
• 0 - unknown (default),
• 1 - saccade,
• 2 - fixation,
• 3 - pursuit.

Must be one of:

• -1
• 0
• 1
• 2
• 3

7.23. [Optional] Property gazeDuration

Type	number
Required	No
Format	double
Default	0.0

Description: Current gaze event duration on the screen.

Values are in milliseconds and default is zero.

7.24. [Optional] Property gazePoint

Type	object
Required	No
Additional properties	[Any type: allowed]
Default	{"left": [0.0, 0.0], "right": [0.0, 0.0]}
Defined in	#/$defs/Pair_for_Array_size_2_of_float

Description: Gaze point on the screen.

For denormalization use screen_origin field values. Default values are zero. Use gaze_confidence field for validation.

7.24.1. [Required] Property left

Type	array of number
Required	Yes

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
left items	-

7.24.1.1. left items

Type	number
Required	No
Format	float

7.24.2. [Required] Property right

Type	array of number
Required	Yes

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
right items	-

7.24.2.1. right items

Type	number
Required	No
Format	float

7.25. [Optional] Property gazeBestPoint

Type	array of number
Required	No
Default	[0.0, 0.0]

Description: Best gaze point on the screen.

Default values are zero. Use gaze_confidence field for validation.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
gazeBestPoint items	-

7.25.1. gazeBestPoint items

Type	number
Required	No
Format	float

7.26. [Optional] Property fixationPoint

Type	array of number
Required	No
Default	[0.0, 0.0]

Description: Gaze fixation point on the screen.

Default values are zero. Valid if gaze_event is fixation.

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
fixationPoint items	-

7.26.1. fixationPoint items

Type	number
Required	No
Format	float

7.27. [Optional] Property facePosition

Type	array of number
Required	No
Default	[0.0, 0.0, -1.0]

Description: Estimated face position in camera 3D space.

Values are in centimeters and coordinate system is right-handed Y-axis down (X - Right, Y - Down, Z - Forward) from camera looking point.

In case of face not detected or position cannot be estimated, Z value is negative.

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
facePosition items	-

7.27.1. facePosition items

Type	number
Required	No
Format	float

7.28. [Optional] Property faceRotation

Type	array of number
Required	No
Default	[0.0, 0.0, 0.0]

Description: Estimated face rotation as Euler angles.

Values are as follows [yaw, pitch, roll] in radians and coordinate system is right-handed Y-axis up (X - Right, Y - Up, Z - Back) from users point of view.

Examples:

• zero angles - face is looking towards the camera sensor plane,
• chin goes up - pitch is positive, down - pitch is negative,
• head turns right - yaw is positive, left - yaw is negative,
• head tilts right - roll is positive, left - roll is negative.

In case of face not detected or position cannot be estimated, values are [0, 0, 0]. These values are valid only if face_position.z is positive.

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
faceRotation items	-

7.28.1. faceRotation items

Type	number
Required	No
Format	float

7.29. [Optional] Property pupilConfidence

Type	object
Required	No
Additional properties	[Any type: allowed]
Default	{"left": -1.0, "right": -1.0}
Defined in	#/$defs/Pair_for_float

Description: Pupil detection confidence for each eye.

Values are in range 0..1, and in case of face not detected or pupil cannot be estimated, values are negative (-1).

7.29.1. [Required] Property left

Type	number
Required	Yes
Format	float

7.29.2. [Required] Property right

Type	number
Required	Yes
Format	float

7.30. [Optional] Property eyeAspectRatio

Type	object
Required	No
Additional properties	[Any type: allowed]
Default	{"left": -1.0, "right": -1.0}
Defined in	#/$defs/Pair_for_float

Description: Aspect ratio value for each eye.

In case of face not detected or ratio cannot be estimated, values are negative (-1).

7.30.1. [Required] Property left

Type	number
Required	Yes
Format	float

7.30.2. [Required] Property right

Type	number
Required	Yes
Format	float

7.31. [Optional] Property pupilCenter

Type	object
Required	No
Additional properties	[Any type: allowed]
Default	{"left": [0.0, 0.0], "right": [0.0, 0.0]}
Defined in	#/$defs/Pair_for_Array_size_2_of_float

Description: Estimated pupil center position on the frame for each eye.

If face is not detected or pupil point cannot be estimated values are [-1, -1].

7.31.1. [Required] Property left

Type	array of number
Required	Yes

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
left items	-

7.31.1.1. left items

Type	number
Required	No
Format	float

7.31.2. [Required] Property right

Type	array of number
Required	Yes

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
right items	-

7.31.2.1. right items

Type	number
Required	No
Format	float

7.32. [Optional] Property eyeTarget

Type	object
Required	No
Additional properties	[Any type: allowed]
Default	{"left": [0.0, 0.0, -1.0], "right": [0.0, 0.0, -1.0]}
Defined in	#/$defs/Pair_for_Array_size_3_of_float

Description: Tracking regions of interest for each eye.

Describes region of interest for the tracking eyes on the frame as [x, y, size]. Negative size means face is not detected or ROI cannot be estimated.

7.32.1. [Required] Property left

Type	array of number
Required	Yes

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
left items	-

7.32.1.1. left items

Type	number
Required	No
Format	float

7.32.2. [Required] Property right

Type	array of number
Required	Yes

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
right items	-

7.32.2.1. right items

Type	number
Required	No
Format	float

7.33. [Optional] Property faceTarget

Type	array of number
Required	No
Default	[0.0, 0.0, -1.0]

Description: Tracking face ROI.

Describes region of interest for the tracking face on the frame as [x, y, size]. Negative size means face is not detected.

	Array restrictions
Min items	3
Max items	3
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
faceTarget items	-

7.33.1. faceTarget items

Type	number
Required	No
Format	float

7.34. [Optional] Property faceShape

Type	array of array
Required	No
Default	[]

Description: Face shape points (landmarks) on the frame.

If face is not detected then array is empty.

	Array restrictions
Min items	N/A
Max items	N/A
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
faceShape items	-

7.34.1. faceShape items

Type	array of number
Required	No

	Array restrictions
Min items	2
Max items	2
Items unicity	False
Additional items	False
Tuple validation	See below

Each item of this array must be	Description
faceShape items items	-

7.34.1.1. faceShape items items

Type	number
Required	No
Format	float

7.35. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.

8. Property GazefilterDisposeEvent

Title: GazefilterDisposeEvent

Type	object
Required	No
Additional properties	[Any type: allowed]

Description: Device disconnect event.

8.1. [Required] Property type

Type	const
Required	Yes

Specific value: "dispose"

8.2. [Required] Property disposeReason

Type	enum (of string)
Required	Yes
Defined in	#/$defs/DisposeReason

Description: Reason for the device disconnect.

Must be one of:

• “unknown”

8.3. [Optional] Property timeStamp

Type	number
Required	No
Defined in	#/$defs/EventTimestamp

Description: Timestamp of the event initialization.