Collection of command-line high level features based on ArGaze toolkit.

Use -help to get arguments documentation.

## Ready-to-use commands

Consider that all inline commands below needs to be executed into ArGaze root folder.

- Ask for command help (replace UTILS_SCRIPT)

```
python ./src/argaze/utils/UTILS_SCRIPT.py -h
```

- Export 50 4x4 markers at 300 dpi into an export/markers folder:

```
python ./src/argaze/utils/export_aruco_markers.py -o export/markers
```

- Export a 7 columns and 5 rows calibration board with 5cm squares and 3cm markers inside at 50 dpi into an export folder:

```
python ./src/argaze/utils/export_calibration_board.py 7 5 5 3 -o export
```

- Calibrate Tobii Glasses Pro 2 camera (replace IP_ADDRESS) using a 7 columns and 5 rows calibration board with 5cm squares and 3cm markers inside. Then, export its optical parameters into an tobii_camera.json file:

```
python ./src/argaze/utils/calibrate_tobii_camera.py 7 5 5 3 -t IP_ADDRESS -o export/tobii_camera.json
```

- Display Tobii Glasses Pro 2 camera video stream (replace IP_ADDRESS) and gaze

```
python ./src/argaze/utils/live_tobii_session.py -t IP_ADDRESS
```

- Record a Tobii Glasses Pro 2 'Test' session for a participant '1' on Tobii interface's SD card (replace IP_ADDRESS).

```
python ./src/argaze/utils/record_tobii_session.py -t IP_ADDRESS -p myProject -u mySelf
```

- Explore Tobii Glasses Pro 2 interface's SD Card (replace DRIVE_PATH, PROJECT_PATH, RECORDING_PATH, SEGMENT_PATH)

```
python ./src/argaze/utils/explore_tobii_sdcard.py -d DRIVE_PATH
```

```
python ./src/argaze/utils/explore_tobii_sdcard.py -p PROJECT_PATH
```

```
python ./src/argaze/utils/explore_tobii_sdcard.py -r RECORDING_PATH
```

```
python ./src/argaze/utils/explore_tobii_sdcard.py -s SEGMENT_PATH
```

- Export Tobii segment fixations (replace SEGMENT_PATH) into a fixations.json file into the segment folder

```
python ./src/argaze/utils/export_tobii_segment_fixations.py -s SEGMENT_PATH
```

- Replay a Tobii Glasses Pro 2 session (replace SEGMENT_PATH) synchronizing video and data together.

```
python ./src/argaze/utils/replay_tobii_session.py -s SEGMENT_PATH
```

- Track any 4.5cm Original ArUco marker into calibrated Tobii camera video stream (replace IP_ADDRESS). Load an roi scene (replace ROI_SCENE) .obj file, position it virtually relatively to any detected ArUco markers and project the scene into camera frame. Then, detect if Tobii gaze point is inside any ROI.

```
python ./src/argaze/utils/live_tobii_aruco_rois.py -t IP_ADDRESS -c export/tobii_camera.json -m 4.5 -s ROI_SCENE
```