GUI for finger v1

2026-06-18 22:18:19 +08:00
parent f19f092b64
commit 3fd9b839a9
42 changed files with 2326 additions and 1186 deletions
@@ -1,41 +1,41 @@
-# 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 + Open3D mesh viewer
- `finger_plot_data.py` — finger UV + force charts
- `viz/` — shared visualization helpers used by plot and finger examples
-  - `mesh_viewer.py` — re-exports `UVMeshViewer` / `build_uv_surface_mesh` from `orisys.finger`
-  - `finger_panels.py` — 2D OpenCV panels for finger demos
-
-## Typical usage
-
-```bash
-python examples/basic_pipeline.py -v 0 -c ./config/ddjx01.json
-python examples/plot_data.py -v 0 -c ./config/ddjx01.json
-python examples/finger_plot_data.py -v 0 -c ./config/dd02-ov.json
-```
-
-## Requirements
-
- SDK installed (`pip install -e .`)
- camera or test video
- JSON config under `./config/`
-
-Plot examples additionally require:
-
-```bash
-pip install pyqt5 pyqtgraph
-```
-
-## Notes
-
- Press `q` to quit OpenCV windows where applicable.
- Plot examples: `s` starts recording, `e` stops recording.
-
+# 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.