aboutsummaryrefslogtreecommitdiff
path: root/src/examples/README.md
blob: ac24dc1d60c2160cacf113375cef5830647e8dc0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
# ArGaze examples

_All examples requires argaze package._

## export_aruco_markers.py

Generates ArUco markers to place into a scene.

## export_calibration_board.py

Generates ArUco board to calibrate a camera.

## tobii_camera_calibration.py

Captures board pictures and finally outputs camera calibration data into an \_export/tobii_camera.json file.

* Print the **A3_board_35cmx25cm_markers_4X4_3cm.pdf** file from ArUcoMarkers/utils folder on a A3 sheet to get the correct square and markers length (3 cm).
* Launch the script.
* Place the board in order to view it entirely on screen and move the camera in many configurations (orientation and distance) : the script will automatically take pictures. Do this step with a good lighting and a clear background.
* Once enough pictures have been captured (~20), press Esc key then, wait for the camera calibration processing.
* Finally, open \_export/tobii_camera.json file to see the calibration data : the rms parameter should be between 0. and 1. if the calibration suceeded (lower is better).

## tobii_argaze

Coordinates several tasks to :

* Receive gaze data from Tobii glasses Pro 2,
* Detect ArUco markers inside video stream from Tobii glasses Pro 2,
* Synchronise gaze data and ArUcos detection using timestamp,
* Build 3D AR ROIs from **roi3D_scene.obj** file through ArUcos markers pose estimation and project them onto video frame coordinate system,
* Check if gaze is inside an ROI,
* Store gathered data into unified csv file for further analysis.

The **scene.blend** file is a Blender project to build and export roi3D_scene.obj file.