# Examples

User-facing demo scripts for the Orisys SDK. Run from the repository root.

## Layout

- `basic_pipeline.py` — compound-eye sensor, OpenCV visualization
- `plot_data.py` — compound-eye sensor, force charts (PyQtGraph)
- `two_sensor_pipeline.py` — dual-sensor multiprocessing demo
- `finger_pipeline.py` — finger UV minimal pipeline
- `finger_pipeline_3dview.py` — finger UV unified Qt dashboard
- `pipeline/` — runtime acquisition (`FingerPipeline`, `FingerFrameView`)
- `gui/` — Qt dashboard composition (3D + 2D + charts in one window)
- `viz/` — rendering helpers (offscreen mesh, 2D panels, charts)

## Typical usage

```bash
pip install -e ".[gui]"

python examples/finger_pipeline_3dview.py -v 0 -c ./config/dd02-ov.json

# Sales-demo shim
python scripts/qt_viewer_finger.py -v 0 -c ./config/dd02-ov.json
```

## Requirements

- SDK installed (`pip install -e .`)
- camera or test video
- JSON config under `./config/`

GUI examples additionally require:

```bash
pip install -e ".[gui]"
```

## Notes

- Dashboard: click **启动** to start acquisition; `Q` quit, `R` reset, `S`/`E` record, `Esc` fullscreen.