Demonstrations scripts
======================

Collection of command-line scripts for demonstration purpose.

!!! note
      *Consider that all inline commands below have to be executed at the root of ArGaze package folder.*

!!! note
      *Use -h option to get command arguments documentation.*

## Random context

Load **random_context.json** file to analyze random gaze positions.

```shell
python -m argaze ./src/argaze/utils/demo/random_context.json
```

## OpenCV window context

Load **opencv_window_context.json** file to analyze mouse pointer positions over OpenCV window.

```shell
python -m argaze ./src/argaze/utils/demo/opencv_window_context.json
```

## Tobii Pro Glasses 2

### Tobii live stream context

!!! note
    this demonstration requires to print **A3_demo.pdf** file located in *./src/argaze/utils/demo/* folder on A3 paper sheet.

Edit **tobii_live_stream_context.json** file as below with your own parameters values:

```json
{
    "argaze.utils.contexts.TobiiProGlasses2.LiveStream" : {
        "name": "Tobii Pro Glasses 2 live stream",
        "address": "10.34.0.17",
        "project": "MyProject",
        "participant": "NewParticipant",
        "configuration": {
            "sys_ec_preset": "Indoor",
            "sys_sc_width": 1920,
            "sys_sc_height": 1080,
            "sys_sc_fps": 25,
            "sys_sc_preset": "Auto",
            "sys_et_freq": 50,
            "sys_mems_freq": 100
        },
        "pipeline": "aruco_markers_pipeline.json",
        "catch_exceptions": true,
        "image_parameters": {
            "draw_times": true,
            "draw_exceptions": true
        }
    }
}
```

Then, execute this command:

```shell
python -m argaze ./src/argaze/utils/demo/tobii_live_stream_context.json
```

### Tobii post-processing context

!!! note
    this demonstration requires to print **A3_demo.pdf** file located in *./src/argaze/utils/demo/* folder on A3 paper sheet.

Edit **tobii_post_processing_context.json** file as below with your own parameters values:

```json
{
    "argaze.utils.contexts.TobiiProGlasses2.PostProcessing" : {
        "name": "Tobii Pro Glasses 2 post-processing",
        "segment": "record/segments/1",
        "pipeline": "aruco_markers_pipeline.json",
        "catch_exceptions": true,
        "image_parameters": {
            "draw_times": true,
            "draw_exceptions": true
        }
    }
}
```

Then, execute this command:

```shell
python -m argaze ./src/argaze/utils/demo/tobii_post_processing_context.json
```

## Pupil Invisible

### Pupil Invisible live stream context

!!! note
    this demonstration requires to print **A3_demo.pdf** file located in *./src/argaze/utils/demo/* folder on A3 paper sheet.

Edit **pupillabs_live_stream_context.json** file as below with your own parameters values:

```json
{
    "argaze.utils.contexts.PupilLabs.LiveStream" : {
        "name": "PupilLabs",
        "pipeline": "aruco_markers_pipeline.json",
        "catch_exceptions": true,
        "image_parameters": {
            "draw_times": true,
            "draw_exceptions": true
        }
    }
}
```

Then, execute this command:

```shell
python -m argaze ./src/argaze/utils/demo/pupillabs_live_stream_context.json
```