Ready-made scripts
==================

Collection of command-line scripts to provide useful features.

!!! 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.*

## ArContext handler

Load and execute any ArContext from a JSON CONFIGURATION file

```shell
python -m argaze load CONFIGURATION
```

### Send command

Use -p option to enable pipe communication at given address:

```shell
python -m argaze load CONFIGURATION -p /tmp/argaze
```

Open another tab in the **same** Terminal window then, you can send any Python command into the pipe.

For example:

* Print context:
```shell
echo "print(context)" > /tmp/argaze
```

* Pause context processing:

```shell
echo "context.pause()" > /tmp/argaze
```

* Resume context processing:

```shell
echo "context.resume()" > /tmp/argaze
```

## ArUco markers group exporter

Detect DICTIONARY and SIZE ArUco markers inside a MOVIE frame then, export detected ArUco markers group as .obj file into an OUTPUT folder.

```shell
python ./src/argaze/utils/aruco_marker_group_export.py MOVIE DICTIONARY SIZE -o OUTPUT
```