ai-virtual-mouse-controller 1.2.0__tar.gz → 1.4.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/PKG-INFO +34 -11
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/README.md +33 -8
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/PKG-INFO +34 -11
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/SOURCES.txt +21 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/requires.txt +0 -2
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/config.py +121 -17
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/__init__.py +1 -1
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/camera.py +122 -25
- ai_virtual_mouse_controller-1.4.0/core/camera_select.py +145 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/cursor_controller.py +50 -21
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/gesture_detector.py +124 -41
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hand_anchor.py +89 -5
- ai_virtual_mouse_controller-1.4.0/core/hand_arbiter.py +213 -0
- ai_virtual_mouse_controller-1.4.0/core/hand_gate.py +126 -0
- ai_virtual_mouse_controller-1.4.0/core/hand_gl_renderer.py +347 -0
- ai_virtual_mouse_controller-1.4.0/core/hand_mesh.py +515 -0
- ai_virtual_mouse_controller-1.4.0/core/hand_pose.py +264 -0
- ai_virtual_mouse_controller-1.4.0/core/hand_soft_renderer.py +262 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hand_tracker.py +54 -17
- ai_virtual_mouse_controller-1.4.0/core/hologram_gl_backend.py +345 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hologram_overlay.py +71 -4
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/perf_telemetry.py +11 -4
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/presentation_controller.py +3 -2
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/runtime_settings.py +24 -16
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/settings_panel.py +10 -3
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/smoothing.py +37 -0
- ai_virtual_mouse_controller-1.4.0/core/two_hands.py +200 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/ui_overlay.py +2 -2
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/utils.py +37 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/main.py +78 -2
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/pyproject.toml +6 -8
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/services/virtual_mouse_service.py +565 -210
- ai_virtual_mouse_controller-1.4.0/tests/test_camera.py +118 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_camera_select.py +113 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_cursor_feel.py +92 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_gesture_detector_behavior.py +200 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hand_anchor_bottom.py +33 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_hand_arbiter.py +152 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_hand_gate.py +153 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_hand_mesh.py +75 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_hand_pose.py +111 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_hand_renderers.py +98 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hologram_overlay.py +3 -3
- ai_virtual_mouse_controller-1.4.0/tests/test_motion_quality.py +87 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_overlay_smoke.py +4 -2
- ai_virtual_mouse_controller-1.4.0/tests/test_runtime_settings.py +50 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_service_camera_loss.py +65 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_two_hands.py +416 -0
- ai_virtual_mouse_controller-1.4.0/tests/test_vision_runtime.py +300 -0
- ai_virtual_mouse_controller-1.2.0/core/hand_mesh.py +0 -794
- ai_virtual_mouse_controller-1.2.0/core/hologram_gl_backend.py +0 -964
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/LICENSE +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/dependency_links.txt +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/entry_points.txt +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/ai_virtual_mouse_controller.egg-info/top_level.txt +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/avmc.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/click_burst.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/finger_posture.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/hand_renderer.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/models/hand_landmarker.task +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/core/windows_path.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/services/__init__.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/setup.cfg +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_click_burst.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_cursor_bottom_reach.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_cursor_click_at.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_gesture_detector.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hand_renderer.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_hand_tracker.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_perf_telemetry.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_presentation_controller.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_settings_panel.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_smoothing.py +0 -0
- {ai_virtual_mouse_controller-1.2.0 → ai_virtual_mouse_controller-1.4.0}/tests/test_windows_path.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: ai-virtual-mouse-controller
|
|
3
|
-
Version: 1.
|
|
3
|
+
Version: 1.4.0
|
|
4
4
|
Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
|
|
5
5
|
Author: Guilherme Moraes Franco
|
|
6
6
|
License: MIT
|
|
@@ -32,10 +32,8 @@ Requires-Dist: opencv-contrib-python<5.0.0,>=4.10.0
|
|
|
32
32
|
Requires-Dist: mediapipe>=0.10.18
|
|
33
33
|
Requires-Dist: pyautogui<1.0.0,>=0.9.54
|
|
34
34
|
Requires-Dist: numpy>=1.26.0
|
|
35
|
-
Requires-Dist: moderngl>=5.10.0
|
|
36
35
|
Requires-Dist: PySide6>=6.6.0
|
|
37
36
|
Provides-Extra: hologram
|
|
38
|
-
Requires-Dist: moderngl>=5.10.0; extra == "hologram"
|
|
39
37
|
Requires-Dist: PySide6>=6.6.0; extra == "hologram"
|
|
40
38
|
Provides-Extra: dev
|
|
41
39
|
Requires-Dist: pytest>=8.0.0; extra == "dev"
|
|
@@ -89,7 +87,7 @@ O **AI Virtual Mouse Controller** é um mouse virtual com reconhecimento de gest
|
|
|
89
87
|
|
|
90
88
|
100% local. Sem nuvem, sem telemetria, sem persistir nada da webcam.
|
|
91
89
|
|
|
92
|
-
**Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy ·
|
|
90
|
+
**Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · PySide6 (holograma 3D via OpenGL do Qt)
|
|
93
91
|
|
|
94
92
|
---
|
|
95
93
|
|
|
@@ -118,6 +116,7 @@ Posicione a mão a ~50cm da câmera. Atalhos em runtime:
|
|
|
118
116
|
| Tecla | Ação |
|
|
119
117
|
|---|---|
|
|
120
118
|
| `H` | liga/desliga o holograma 3D |
|
|
119
|
+
| `B` | liga/desliga o modo duas mãos |
|
|
121
120
|
| `S` | abre/fecha o painel de configurações |
|
|
122
121
|
| `T` | alterna janela sempre-no-topo |
|
|
123
122
|
| `ESC` | sai |
|
|
@@ -191,7 +190,26 @@ Histórico de mudanças em [CHANGELOG.md](CHANGELOG.md).
|
|
|
191
190
|
| Punho fechado | ✊ | Cursor congelado |
|
|
192
191
|
| Mão fora do frame | — | Pausa automática |
|
|
193
192
|
|
|
194
|
-
Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico.
|
|
193
|
+
Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico. Pra evitar clique sem querer, a pinça só começa com os outros dedos abertos: fechar a mão não clica.
|
|
194
|
+
|
|
195
|
+
### Modo duas mãos
|
|
196
|
+
|
|
197
|
+
Aperte `B` (ou use o painel) pra usar as duas mãos: as duas aparecem no holograma e fazem os mesmos gestos. O Windows tem um cursor só, então:
|
|
198
|
+
|
|
199
|
+
- o cursor segue a mão **dona**: a primeira que apareceu ou a que se mexeu enquanto a outra estava parada;
|
|
200
|
+
- a outra mão clica na própria posição, e o cursor volta pra dona na hora;
|
|
201
|
+
- só uma mão arrasta por vez; enquanto isso, as ações da outra ficam em espera.
|
|
202
|
+
|
|
203
|
+
O modo é opcional porque detectar duas mãos custa mais processamento, e não funciona junto com o modo apresentação.
|
|
204
|
+
|
|
205
|
+
### Escolher a câmera
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
avmc --list-cameras
|
|
209
|
+
avmc --camera 1
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
A câmera escolhida fica salva pras próximas vezes. Se ela não abrir, o app usa a padrão.
|
|
195
213
|
|
|
196
214
|
---
|
|
197
215
|
|
|
@@ -201,13 +219,15 @@ Toda a calibração vive em [`config.py`](config.py) — constantes nomeadas com
|
|
|
201
219
|
|
|
202
220
|
| Seção | O que controla |
|
|
203
221
|
|---|---|
|
|
204
|
-
| `CAMERA` | índice da câmera, resolução, FPS alvo |
|
|
222
|
+
| `CAMERA` | índice padrão da câmera, resolução, FPS alvo (escolha sem editar: `avmc --list-cameras` e `avmc --camera N`) |
|
|
223
|
+
| `PROFILE` | perfil inicial do painel: `smooth`, `precise`, `responsive`, `stable` |
|
|
205
224
|
| `CURSOR_ANCHOR` | qual ponto da mão o cursor segue (`-2` = âncora robusta, default) |
|
|
206
|
-
| `PINCH` | thresholds de detecção de clique (
|
|
225
|
+
| `PINCH` | thresholds de detecção de clique (escala adaptativa por tamanho da mão + histerese pra soltar) |
|
|
207
226
|
| `DPI` / `SMOOTHING` | sensibilidade do cursor + filtro OneEuro |
|
|
208
227
|
| `SCREEN_MARGIN_*` | margens assimétricas (top/bottom < lateral) pra alcançar cantos |
|
|
209
228
|
| `CURSOR_FOLLOWTHROUGH_*` | cinematic prediction quando a mão sai do FOV |
|
|
210
|
-
| `HOLOGRAM` | backend (
|
|
229
|
+
| `HOLOGRAM` | estilo (`quest`, `graphite`, `neon`), backend (OpenGL/QPainter), tamanho, opacidade, FPS |
|
|
230
|
+
| `TWO_HANDS` | modo duas mãos ao iniciar e tecla de atalho |
|
|
211
231
|
|
|
212
232
|
Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`) — perfis prontos: *smooth*, *precise*, *responsive*, *stable*.
|
|
213
233
|
|
|
@@ -231,6 +251,8 @@ Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`)
|
|
|
231
251
|
```
|
|
232
252
|
webcam → MediaPipe Hands (21 landmarks)
|
|
233
253
|
↓
|
|
254
|
+
HandGate ← descarta mão repetida, fantasma e detecção passageira
|
|
255
|
+
↓
|
|
234
256
|
RobustHandAnchor ← combina anatomia + estabilidade + edge extrapolation
|
|
235
257
|
↓
|
|
236
258
|
GestureDetector ← state machine: shape → event (CLICK, MOVE, DRAG…)
|
|
@@ -240,7 +262,7 @@ webcam → MediaPipe Hands (21 landmarks)
|
|
|
240
262
|
CursorController ← PyAutoGUI move o cursor real
|
|
241
263
|
```
|
|
242
264
|
|
|
243
|
-
Componentes auxiliares: `HologramOverlay` (
|
|
265
|
+
Esse caminho roda em thread própria: holograma e preview ficam na thread principal e não atrasam o cursor. Componentes auxiliares: `HologramOverlay` (mão 3D estilo headset VR: `hand_pose` → `hand_mesh` → shader OpenGL do Qt, com fallback 2D QPainter), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
|
|
244
266
|
|
|
245
267
|
Estrutura de pastas:
|
|
246
268
|
|
|
@@ -249,7 +271,8 @@ core/ # camera, hand_tracker, gesture_detector, hand_anchor, smoothing
|
|
|
249
271
|
services/ # orquestração do loop principal
|
|
250
272
|
config.py # constantes de calibração documentadas
|
|
251
273
|
main.py # entry point
|
|
252
|
-
|
|
274
|
+
scripts/ # eval_motion.py: jitter/atraso/cliques; eval_latency.py: câmera -> cursor
|
|
275
|
+
tests/ # unitários + gate de qualidade de movimento
|
|
253
276
|
docs/ # site estático + assets
|
|
254
277
|
```
|
|
255
278
|
|
|
@@ -269,7 +292,7 @@ make test-gpu # só testes que precisam de display/GPU real
|
|
|
269
292
|
make test-cov # com coverage HTML
|
|
270
293
|
```
|
|
271
294
|
|
|
272
|
-
Testes marcados com `gpu` (overlay PySide6/
|
|
295
|
+
Testes marcados com `gpu` (overlay PySide6/OpenGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
|
|
273
296
|
|
|
274
297
|
---
|
|
275
298
|
|
|
@@ -42,7 +42,7 @@ O **AI Virtual Mouse Controller** é um mouse virtual com reconhecimento de gest
|
|
|
42
42
|
|
|
43
43
|
100% local. Sem nuvem, sem telemetria, sem persistir nada da webcam.
|
|
44
44
|
|
|
45
|
-
**Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy ·
|
|
45
|
+
**Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · PySide6 (holograma 3D via OpenGL do Qt)
|
|
46
46
|
|
|
47
47
|
---
|
|
48
48
|
|
|
@@ -71,6 +71,7 @@ Posicione a mão a ~50cm da câmera. Atalhos em runtime:
|
|
|
71
71
|
| Tecla | Ação |
|
|
72
72
|
|---|---|
|
|
73
73
|
| `H` | liga/desliga o holograma 3D |
|
|
74
|
+
| `B` | liga/desliga o modo duas mãos |
|
|
74
75
|
| `S` | abre/fecha o painel de configurações |
|
|
75
76
|
| `T` | alterna janela sempre-no-topo |
|
|
76
77
|
| `ESC` | sai |
|
|
@@ -144,7 +145,26 @@ Histórico de mudanças em [CHANGELOG.md](CHANGELOG.md).
|
|
|
144
145
|
| Punho fechado | ✊ | Cursor congelado |
|
|
145
146
|
| Mão fora do frame | — | Pausa automática |
|
|
146
147
|
|
|
147
|
-
Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico.
|
|
148
|
+
Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico. Pra evitar clique sem querer, a pinça só começa com os outros dedos abertos: fechar a mão não clica.
|
|
149
|
+
|
|
150
|
+
### Modo duas mãos
|
|
151
|
+
|
|
152
|
+
Aperte `B` (ou use o painel) pra usar as duas mãos: as duas aparecem no holograma e fazem os mesmos gestos. O Windows tem um cursor só, então:
|
|
153
|
+
|
|
154
|
+
- o cursor segue a mão **dona**: a primeira que apareceu ou a que se mexeu enquanto a outra estava parada;
|
|
155
|
+
- a outra mão clica na própria posição, e o cursor volta pra dona na hora;
|
|
156
|
+
- só uma mão arrasta por vez; enquanto isso, as ações da outra ficam em espera.
|
|
157
|
+
|
|
158
|
+
O modo é opcional porque detectar duas mãos custa mais processamento, e não funciona junto com o modo apresentação.
|
|
159
|
+
|
|
160
|
+
### Escolher a câmera
|
|
161
|
+
|
|
162
|
+
```bash
|
|
163
|
+
avmc --list-cameras
|
|
164
|
+
avmc --camera 1
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
A câmera escolhida fica salva pras próximas vezes. Se ela não abrir, o app usa a padrão.
|
|
148
168
|
|
|
149
169
|
---
|
|
150
170
|
|
|
@@ -154,13 +174,15 @@ Toda a calibração vive em [`config.py`](config.py) — constantes nomeadas com
|
|
|
154
174
|
|
|
155
175
|
| Seção | O que controla |
|
|
156
176
|
|---|---|
|
|
157
|
-
| `CAMERA` | índice da câmera, resolução, FPS alvo |
|
|
177
|
+
| `CAMERA` | índice padrão da câmera, resolução, FPS alvo (escolha sem editar: `avmc --list-cameras` e `avmc --camera N`) |
|
|
178
|
+
| `PROFILE` | perfil inicial do painel: `smooth`, `precise`, `responsive`, `stable` |
|
|
158
179
|
| `CURSOR_ANCHOR` | qual ponto da mão o cursor segue (`-2` = âncora robusta, default) |
|
|
159
|
-
| `PINCH` | thresholds de detecção de clique (
|
|
180
|
+
| `PINCH` | thresholds de detecção de clique (escala adaptativa por tamanho da mão + histerese pra soltar) |
|
|
160
181
|
| `DPI` / `SMOOTHING` | sensibilidade do cursor + filtro OneEuro |
|
|
161
182
|
| `SCREEN_MARGIN_*` | margens assimétricas (top/bottom < lateral) pra alcançar cantos |
|
|
162
183
|
| `CURSOR_FOLLOWTHROUGH_*` | cinematic prediction quando a mão sai do FOV |
|
|
163
|
-
| `HOLOGRAM` | backend (
|
|
184
|
+
| `HOLOGRAM` | estilo (`quest`, `graphite`, `neon`), backend (OpenGL/QPainter), tamanho, opacidade, FPS |
|
|
185
|
+
| `TWO_HANDS` | modo duas mãos ao iniciar e tecla de atalho |
|
|
164
186
|
|
|
165
187
|
Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`) — perfis prontos: *smooth*, *precise*, *responsive*, *stable*.
|
|
166
188
|
|
|
@@ -184,6 +206,8 @@ Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`)
|
|
|
184
206
|
```
|
|
185
207
|
webcam → MediaPipe Hands (21 landmarks)
|
|
186
208
|
↓
|
|
209
|
+
HandGate ← descarta mão repetida, fantasma e detecção passageira
|
|
210
|
+
↓
|
|
187
211
|
RobustHandAnchor ← combina anatomia + estabilidade + edge extrapolation
|
|
188
212
|
↓
|
|
189
213
|
GestureDetector ← state machine: shape → event (CLICK, MOVE, DRAG…)
|
|
@@ -193,7 +217,7 @@ webcam → MediaPipe Hands (21 landmarks)
|
|
|
193
217
|
CursorController ← PyAutoGUI move o cursor real
|
|
194
218
|
```
|
|
195
219
|
|
|
196
|
-
Componentes auxiliares: `HologramOverlay` (
|
|
220
|
+
Esse caminho roda em thread própria: holograma e preview ficam na thread principal e não atrasam o cursor. Componentes auxiliares: `HologramOverlay` (mão 3D estilo headset VR: `hand_pose` → `hand_mesh` → shader OpenGL do Qt, com fallback 2D QPainter), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
|
|
197
221
|
|
|
198
222
|
Estrutura de pastas:
|
|
199
223
|
|
|
@@ -202,7 +226,8 @@ core/ # camera, hand_tracker, gesture_detector, hand_anchor, smoothing
|
|
|
202
226
|
services/ # orquestração do loop principal
|
|
203
227
|
config.py # constantes de calibração documentadas
|
|
204
228
|
main.py # entry point
|
|
205
|
-
|
|
229
|
+
scripts/ # eval_motion.py: jitter/atraso/cliques; eval_latency.py: câmera -> cursor
|
|
230
|
+
tests/ # unitários + gate de qualidade de movimento
|
|
206
231
|
docs/ # site estático + assets
|
|
207
232
|
```
|
|
208
233
|
|
|
@@ -222,7 +247,7 @@ make test-gpu # só testes que precisam de display/GPU real
|
|
|
222
247
|
make test-cov # com coverage HTML
|
|
223
248
|
```
|
|
224
249
|
|
|
225
|
-
Testes marcados com `gpu` (overlay PySide6/
|
|
250
|
+
Testes marcados com `gpu` (overlay PySide6/OpenGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
|
|
226
251
|
|
|
227
252
|
---
|
|
228
253
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: ai-virtual-mouse-controller
|
|
3
|
-
Version: 1.
|
|
3
|
+
Version: 1.4.0
|
|
4
4
|
Summary: Controle de cursor por gestos da mao via webcam, com holograma 3D opcional.
|
|
5
5
|
Author: Guilherme Moraes Franco
|
|
6
6
|
License: MIT
|
|
@@ -32,10 +32,8 @@ Requires-Dist: opencv-contrib-python<5.0.0,>=4.10.0
|
|
|
32
32
|
Requires-Dist: mediapipe>=0.10.18
|
|
33
33
|
Requires-Dist: pyautogui<1.0.0,>=0.9.54
|
|
34
34
|
Requires-Dist: numpy>=1.26.0
|
|
35
|
-
Requires-Dist: moderngl>=5.10.0
|
|
36
35
|
Requires-Dist: PySide6>=6.6.0
|
|
37
36
|
Provides-Extra: hologram
|
|
38
|
-
Requires-Dist: moderngl>=5.10.0; extra == "hologram"
|
|
39
37
|
Requires-Dist: PySide6>=6.6.0; extra == "hologram"
|
|
40
38
|
Provides-Extra: dev
|
|
41
39
|
Requires-Dist: pytest>=8.0.0; extra == "dev"
|
|
@@ -89,7 +87,7 @@ O **AI Virtual Mouse Controller** é um mouse virtual com reconhecimento de gest
|
|
|
89
87
|
|
|
90
88
|
100% local. Sem nuvem, sem telemetria, sem persistir nada da webcam.
|
|
91
89
|
|
|
92
|
-
**Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy ·
|
|
90
|
+
**Stack:** Python 3.10+ · OpenCV · MediaPipe · PyAutoGUI · NumPy · PySide6 (holograma 3D via OpenGL do Qt)
|
|
93
91
|
|
|
94
92
|
---
|
|
95
93
|
|
|
@@ -118,6 +116,7 @@ Posicione a mão a ~50cm da câmera. Atalhos em runtime:
|
|
|
118
116
|
| Tecla | Ação |
|
|
119
117
|
|---|---|
|
|
120
118
|
| `H` | liga/desliga o holograma 3D |
|
|
119
|
+
| `B` | liga/desliga o modo duas mãos |
|
|
121
120
|
| `S` | abre/fecha o painel de configurações |
|
|
122
121
|
| `T` | alterna janela sempre-no-topo |
|
|
123
122
|
| `ESC` | sai |
|
|
@@ -191,7 +190,26 @@ Histórico de mudanças em [CHANGELOG.md](CHANGELOG.md).
|
|
|
191
190
|
| Punho fechado | ✊ | Cursor congelado |
|
|
192
191
|
| Mão fora do frame | — | Pausa automática |
|
|
193
192
|
|
|
194
|
-
Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico.
|
|
193
|
+
Os cliques (esquerdo e direito) disparam no **press** — assim que os dedos se encostam — replicando o feedback de um botão físico. Pra evitar clique sem querer, a pinça só começa com os outros dedos abertos: fechar a mão não clica.
|
|
194
|
+
|
|
195
|
+
### Modo duas mãos
|
|
196
|
+
|
|
197
|
+
Aperte `B` (ou use o painel) pra usar as duas mãos: as duas aparecem no holograma e fazem os mesmos gestos. O Windows tem um cursor só, então:
|
|
198
|
+
|
|
199
|
+
- o cursor segue a mão **dona**: a primeira que apareceu ou a que se mexeu enquanto a outra estava parada;
|
|
200
|
+
- a outra mão clica na própria posição, e o cursor volta pra dona na hora;
|
|
201
|
+
- só uma mão arrasta por vez; enquanto isso, as ações da outra ficam em espera.
|
|
202
|
+
|
|
203
|
+
O modo é opcional porque detectar duas mãos custa mais processamento, e não funciona junto com o modo apresentação.
|
|
204
|
+
|
|
205
|
+
### Escolher a câmera
|
|
206
|
+
|
|
207
|
+
```bash
|
|
208
|
+
avmc --list-cameras
|
|
209
|
+
avmc --camera 1
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
A câmera escolhida fica salva pras próximas vezes. Se ela não abrir, o app usa a padrão.
|
|
195
213
|
|
|
196
214
|
---
|
|
197
215
|
|
|
@@ -201,13 +219,15 @@ Toda a calibração vive em [`config.py`](config.py) — constantes nomeadas com
|
|
|
201
219
|
|
|
202
220
|
| Seção | O que controla |
|
|
203
221
|
|---|---|
|
|
204
|
-
| `CAMERA` | índice da câmera, resolução, FPS alvo |
|
|
222
|
+
| `CAMERA` | índice padrão da câmera, resolução, FPS alvo (escolha sem editar: `avmc --list-cameras` e `avmc --camera N`) |
|
|
223
|
+
| `PROFILE` | perfil inicial do painel: `smooth`, `precise`, `responsive`, `stable` |
|
|
205
224
|
| `CURSOR_ANCHOR` | qual ponto da mão o cursor segue (`-2` = âncora robusta, default) |
|
|
206
|
-
| `PINCH` | thresholds de detecção de clique (
|
|
225
|
+
| `PINCH` | thresholds de detecção de clique (escala adaptativa por tamanho da mão + histerese pra soltar) |
|
|
207
226
|
| `DPI` / `SMOOTHING` | sensibilidade do cursor + filtro OneEuro |
|
|
208
227
|
| `SCREEN_MARGIN_*` | margens assimétricas (top/bottom < lateral) pra alcançar cantos |
|
|
209
228
|
| `CURSOR_FOLLOWTHROUGH_*` | cinematic prediction quando a mão sai do FOV |
|
|
210
|
-
| `HOLOGRAM` | backend (
|
|
229
|
+
| `HOLOGRAM` | estilo (`quest`, `graphite`, `neon`), backend (OpenGL/QPainter), tamanho, opacidade, FPS |
|
|
230
|
+
| `TWO_HANDS` | modo duas mãos ao iniciar e tecla de atalho |
|
|
211
231
|
|
|
212
232
|
Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`) — perfis prontos: *smooth*, *precise*, *responsive*, *stable*.
|
|
213
233
|
|
|
@@ -231,6 +251,8 @@ Ajustes em tempo de execução também ficam disponíveis no painel (tecla `S`)
|
|
|
231
251
|
```
|
|
232
252
|
webcam → MediaPipe Hands (21 landmarks)
|
|
233
253
|
↓
|
|
254
|
+
HandGate ← descarta mão repetida, fantasma e detecção passageira
|
|
255
|
+
↓
|
|
234
256
|
RobustHandAnchor ← combina anatomia + estabilidade + edge extrapolation
|
|
235
257
|
↓
|
|
236
258
|
GestureDetector ← state machine: shape → event (CLICK, MOVE, DRAG…)
|
|
@@ -240,7 +262,7 @@ webcam → MediaPipe Hands (21 landmarks)
|
|
|
240
262
|
CursorController ← PyAutoGUI move o cursor real
|
|
241
263
|
```
|
|
242
264
|
|
|
243
|
-
Componentes auxiliares: `HologramOverlay` (
|
|
265
|
+
Esse caminho roda em thread própria: holograma e preview ficam na thread principal e não atrasam o cursor. Componentes auxiliares: `HologramOverlay` (mão 3D estilo headset VR: `hand_pose` → `hand_mesh` → shader OpenGL do Qt, com fallback 2D QPainter), `RuntimeSettings` (perfis e sliders), `PerfTelemetry` (timing p50/p99 por estágio).
|
|
244
266
|
|
|
245
267
|
Estrutura de pastas:
|
|
246
268
|
|
|
@@ -249,7 +271,8 @@ core/ # camera, hand_tracker, gesture_detector, hand_anchor, smoothing
|
|
|
249
271
|
services/ # orquestração do loop principal
|
|
250
272
|
config.py # constantes de calibração documentadas
|
|
251
273
|
main.py # entry point
|
|
252
|
-
|
|
274
|
+
scripts/ # eval_motion.py: jitter/atraso/cliques; eval_latency.py: câmera -> cursor
|
|
275
|
+
tests/ # unitários + gate de qualidade de movimento
|
|
253
276
|
docs/ # site estático + assets
|
|
254
277
|
```
|
|
255
278
|
|
|
@@ -269,7 +292,7 @@ make test-gpu # só testes que precisam de display/GPU real
|
|
|
269
292
|
make test-cov # com coverage HTML
|
|
270
293
|
```
|
|
271
294
|
|
|
272
|
-
Testes marcados com `gpu` (overlay PySide6/
|
|
295
|
+
Testes marcados com `gpu` (overlay PySide6/OpenGL) ficam fora do `pytest` default — eles requerem display real e podem crashar em ambientes headless. Rode-os explicitamente com `make test-gpu` quando estiver mexendo no holograma.
|
|
273
296
|
|
|
274
297
|
---
|
|
275
298
|
|
|
@@ -12,13 +12,19 @@ ai_virtual_mouse_controller.egg-info/requires.txt
|
|
|
12
12
|
ai_virtual_mouse_controller.egg-info/top_level.txt
|
|
13
13
|
core/__init__.py
|
|
14
14
|
core/camera.py
|
|
15
|
+
core/camera_select.py
|
|
15
16
|
core/click_burst.py
|
|
16
17
|
core/cursor_controller.py
|
|
17
18
|
core/finger_posture.py
|
|
18
19
|
core/gesture_detector.py
|
|
19
20
|
core/hand_anchor.py
|
|
21
|
+
core/hand_arbiter.py
|
|
22
|
+
core/hand_gate.py
|
|
23
|
+
core/hand_gl_renderer.py
|
|
20
24
|
core/hand_mesh.py
|
|
25
|
+
core/hand_pose.py
|
|
21
26
|
core/hand_renderer.py
|
|
27
|
+
core/hand_soft_renderer.py
|
|
22
28
|
core/hand_tracker.py
|
|
23
29
|
core/hologram_gl_backend.py
|
|
24
30
|
core/hologram_overlay.py
|
|
@@ -27,23 +33,38 @@ core/presentation_controller.py
|
|
|
27
33
|
core/runtime_settings.py
|
|
28
34
|
core/settings_panel.py
|
|
29
35
|
core/smoothing.py
|
|
36
|
+
core/two_hands.py
|
|
30
37
|
core/ui_overlay.py
|
|
31
38
|
core/utils.py
|
|
32
39
|
core/windows_path.py
|
|
33
40
|
core/models/hand_landmarker.task
|
|
34
41
|
services/__init__.py
|
|
35
42
|
services/virtual_mouse_service.py
|
|
43
|
+
tests/test_camera.py
|
|
44
|
+
tests/test_camera_select.py
|
|
36
45
|
tests/test_click_burst.py
|
|
37
46
|
tests/test_cursor_bottom_reach.py
|
|
38
47
|
tests/test_cursor_click_at.py
|
|
48
|
+
tests/test_cursor_feel.py
|
|
39
49
|
tests/test_gesture_detector.py
|
|
50
|
+
tests/test_gesture_detector_behavior.py
|
|
40
51
|
tests/test_hand_anchor_bottom.py
|
|
52
|
+
tests/test_hand_arbiter.py
|
|
53
|
+
tests/test_hand_gate.py
|
|
54
|
+
tests/test_hand_mesh.py
|
|
55
|
+
tests/test_hand_pose.py
|
|
41
56
|
tests/test_hand_renderer.py
|
|
57
|
+
tests/test_hand_renderers.py
|
|
42
58
|
tests/test_hand_tracker.py
|
|
43
59
|
tests/test_hologram_overlay.py
|
|
60
|
+
tests/test_motion_quality.py
|
|
44
61
|
tests/test_overlay_smoke.py
|
|
45
62
|
tests/test_perf_telemetry.py
|
|
46
63
|
tests/test_presentation_controller.py
|
|
64
|
+
tests/test_runtime_settings.py
|
|
65
|
+
tests/test_service_camera_loss.py
|
|
47
66
|
tests/test_settings_panel.py
|
|
48
67
|
tests/test_smoothing.py
|
|
68
|
+
tests/test_two_hands.py
|
|
69
|
+
tests/test_vision_runtime.py
|
|
49
70
|
tests/test_windows_path.py
|
|
@@ -30,6 +30,7 @@ CAMERA_FPS_TARGET: int = 60
|
|
|
30
30
|
# ---------------------------------------------------------------------
|
|
31
31
|
|
|
32
32
|
MAX_NUM_HANDS: int = 1
|
|
33
|
+
"""Maos detectadas fora do modo duas maos (ver TWO_HANDS_ENABLED)."""
|
|
33
34
|
MIN_DETECTION_CONFIDENCE: float = 0.6
|
|
34
35
|
MIN_TRACKING_CONFIDENCE: float = 0.4
|
|
35
36
|
MODEL_COMPLEXITY: int = 0
|
|
@@ -39,6 +40,27 @@ O HandLandmarker tem um unico modelo (equivalente ao antigo 1=full).
|
|
|
39
40
|
Mantido so pra nao quebrar configs existentes.
|
|
40
41
|
"""
|
|
41
42
|
|
|
43
|
+
VISION_THREAD_ENABLED: bool = True
|
|
44
|
+
"""Roda camera -> MediaPipe -> gestos -> cursor em thread propria.
|
|
45
|
+
|
|
46
|
+
Preview e holograma nao atrasam mais o cursor: sem isso, com o holograma
|
|
47
|
+
ligado, o loop caia de 29 para 16 quadros por segundo e metade dos cliques do
|
|
48
|
+
video de teste se perdia (ver scripts/eval_latency.py)."""
|
|
49
|
+
|
|
50
|
+
POWER_THROTTLING_OFF: bool = True
|
|
51
|
+
"""Windows: tira este processo da economia de energia. Sem foco, ele ia pros
|
|
52
|
+
nucleos economicos e a inferencia ficava mais lenta."""
|
|
53
|
+
|
|
54
|
+
OPENCV_SINGLE_THREAD: bool = True
|
|
55
|
+
"""OpenCV com 1 thread: nao disputa nucleo com o MediaPipe. O que ele faz aqui
|
|
56
|
+
(converter cor, desenhar o preview) nao precisa de mais."""
|
|
57
|
+
|
|
58
|
+
PREVIEW_MAX_FPS: float = 30.0
|
|
59
|
+
"""Limite do preview da camera. O cursor nao depende dele. 0 = sem limite."""
|
|
60
|
+
|
|
61
|
+
HAND_CONFIRM_FRAMES: int = 2
|
|
62
|
+
"""Frames seguidos que uma mao nova precisa aparecer antes de agir."""
|
|
63
|
+
|
|
42
64
|
INFERENCE_PRE_RESIZE_ENABLED: bool = False
|
|
43
65
|
"""Redimensiona o frame BGR antes de enviar pro MediaPipe.
|
|
44
66
|
|
|
@@ -146,6 +168,17 @@ DPI_MULTIPLIER_MIN: float = 0.7
|
|
|
146
168
|
DPI_MULTIPLIER_MAX: float = 1.4
|
|
147
169
|
DPI_FIXED_MULTIPLIER: float = 1.00
|
|
148
170
|
|
|
171
|
+
DPI_SIZE_SMOOTHING_S: float = 0.6
|
|
172
|
+
"""Constante de tempo (s) do tamanho da mao usado no DPI adaptativo.
|
|
173
|
+
|
|
174
|
+
O tamanho da mao no frame estima a DISTANCIA ate a camera — algo que muda
|
|
175
|
+
devagar. Frame a frame ele oscila quando o pulso inclina/gira e com o
|
|
176
|
+
ruido do tracker; como o DPI escala a posicao a partir do centro da tela,
|
|
177
|
+
isso fazia o cursor andar sozinho com a mao parada (ate ~50 px longe do
|
|
178
|
+
centro). 0.6 s filtra a inclinacao e ainda acompanha quem aproxima ou
|
|
179
|
+
afasta a mao da camera. 0 = comportamento antigo (cru).
|
|
180
|
+
"""
|
|
181
|
+
|
|
149
182
|
# ---------------------------------------------------------------------
|
|
150
183
|
# SUAVIZACAO
|
|
151
184
|
# ---------------------------------------------------------------------
|
|
@@ -155,9 +188,18 @@ SMOOTHING_STRATEGY: SmoothingStrategy = "one_euro"
|
|
|
155
188
|
|
|
156
189
|
SMOOTHING_FACTOR: float = 0.6
|
|
157
190
|
|
|
191
|
+
PROFILE: str = "smooth"
|
|
192
|
+
"""Perfil inicial do painel: 'smooth', 'precise', 'responsive' ou
|
|
193
|
+
'stable'. Define suavizacao, sensibilidade, pinca, aim assist, sticky e a
|
|
194
|
+
trava no clique (ver core/runtime_settings.PROFILES)."""
|
|
195
|
+
|
|
158
196
|
ONE_EURO_FREQ: float = 60.0
|
|
197
|
+
# min_cutoff e beta efetivos vem do PERFIL (painel, slider Suavizacao) —
|
|
198
|
+
# os dois abaixo ficam como referencia do perfil 'recommended'.
|
|
199
|
+
# beta esta na escala das coordenadas normalizadas (0-1): valores ~0.02
|
|
200
|
+
# deixavam o filtro sem adaptacao e o cursor arrastando atras da mao.
|
|
159
201
|
ONE_EURO_MIN_CUTOFF: float = 1.2
|
|
160
|
-
ONE_EURO_BETA: float =
|
|
202
|
+
ONE_EURO_BETA: float = 5.7
|
|
161
203
|
ONE_EURO_D_CUTOFF: float = 1.0
|
|
162
204
|
DEAD_ZONE_PIXELS: int = 1
|
|
163
205
|
|
|
@@ -192,9 +234,33 @@ vem do debounce de 2 frames + threshold.
|
|
|
192
234
|
|
|
193
235
|
PINCH_VELOCITY_THRESHOLD: float = 0.008
|
|
194
236
|
|
|
237
|
+
PINCH_OPEN_FINGERS_MIN: float = 0.82
|
|
238
|
+
"""Pra COMECAR uma pinca, os outros dedos precisam estar abertos (extensao
|
|
239
|
+
media; 1 = retos). Fechar a mao aproxima o polegar do indicador, e isso virava
|
|
240
|
+
clique. Em uso real: pinca >= 0.87, dedos fechados <= 0.79. Quem pinca com os
|
|
241
|
+
outros dedos bem dobrados pode abaixar; 0 desliga. Quem ja segura a pinca nao
|
|
242
|
+
e' afetado."""
|
|
243
|
+
|
|
244
|
+
PINCH_REARM_SECONDS: float = 0.12
|
|
245
|
+
"""Tempo minimo com os dedos abertos antes de outra pinca valer como clique.
|
|
246
|
+
Evita rajada quando a pinca oscila (mao na frente do rosto, por exemplo)."""
|
|
247
|
+
|
|
248
|
+
PINCH_RELEASE_RATIO: float = 1.25
|
|
249
|
+
"""Histerese da pinca (Schmitt trigger): pra SOLTAR a pinca, polegar e
|
|
250
|
+
indicador precisam abrir ate threshold * 1.25 (entrar continua em
|
|
251
|
+
threshold). Vale tambem pro clique direito.
|
|
252
|
+
|
|
253
|
+
Com limiar unico, o ruido do tracker com os dedos perto da borda fazia a
|
|
254
|
+
pinca "piscar": clique extra no encostar seguinte ou drag caindo sozinho.
|
|
255
|
+
Mesma tecnica dos detectores de pinca da Ultraleap (distancias separadas
|
|
256
|
+
de ativar/desativar). 1.0 = comportamento antigo (limiar unico).
|
|
257
|
+
Suba (1.35) se ainda notar clique duplo acidental; desca (1.15) se soltar
|
|
258
|
+
o drag ficar dificil.
|
|
259
|
+
"""
|
|
260
|
+
|
|
195
261
|
PINCH_MIN_HOLD_SECONDS: float = 0.015
|
|
196
|
-
"""
|
|
197
|
-
|
|
262
|
+
"""Sem efeito no modelo press-to-click (o clique sai no encostar).
|
|
263
|
+
Mantido so pra nao quebrar configs existentes."""
|
|
198
264
|
|
|
199
265
|
# ---------------------------------------------------------------------
|
|
200
266
|
# CLIQUE DIREITO — pinca polegar+medio
|
|
@@ -416,6 +482,13 @@ alvos pequenos errarem.
|
|
|
416
482
|
0.12s cobre o intervalo entre a deteccao do raw shape PINCH e a
|
|
417
483
|
estabilizacao da pose. Aumente pra 0.15-0.20s se ainda notar deriva.
|
|
418
484
|
Diminua pra 0.08s se sentir cursor "preso" apos clicks consecutivos.
|
|
485
|
+
|
|
486
|
+
Em runtime o valor vem do PERFIL (slider "Trava no clique" do painel);
|
|
487
|
+
este e' o valor de referencia do perfil 'smooth'/'recommended'.
|
|
488
|
+
|
|
489
|
+
Ao destravar, o cursor NAO salta pra onde a mao foi durante a trava: a
|
|
490
|
+
diferenca e' absorvida aos poucos conforme a mao se move (ver
|
|
491
|
+
CursorController._reconcile_offset). Vale tambem pro fim do drag.
|
|
419
492
|
"""
|
|
420
493
|
|
|
421
494
|
DRAG_PRECISION_FACTOR: float = 0.55
|
|
@@ -459,7 +532,7 @@ SHOW_DPI: bool = True
|
|
|
459
532
|
SHOW_DRAG_PROGRESS: bool = True
|
|
460
533
|
SHOW_AIM_ASSIST: bool = True
|
|
461
534
|
DRAW_LANDMARKS: bool = True
|
|
462
|
-
WINDOW_NAME: str = "AI Virtual Mouse
|
|
535
|
+
WINDOW_NAME: str = "AI Virtual Mouse - ESC to quit"
|
|
463
536
|
|
|
464
537
|
# ---------------------------------------------------------------------
|
|
465
538
|
# JANELA DE EXIBICAO
|
|
@@ -511,28 +584,46 @@ parece magica; em uso prolongado pode distrair.
|
|
|
511
584
|
HOLOGRAM_BACKEND: str = "auto"
|
|
512
585
|
"""Backend de renderizacao do holograma.
|
|
513
586
|
|
|
514
|
-
- "auto" :
|
|
515
|
-
|
|
516
|
-
- "
|
|
587
|
+
- "auto" : OpenGL 3D se houver OpenGL 3.3 (testado na inicializacao);
|
|
588
|
+
senao cai pro renderer 2D QPainter no mesmo estilo
|
|
589
|
+
- "gl" : forca OpenGL (mesh 3D + shader)
|
|
590
|
+
- "qpainter" : forca o renderer 2D (compatibilidade/debug)
|
|
591
|
+
|
|
592
|
+
O OpenGL e' o do proprio Qt (PySide6) — nao depende de moderngl/
|
|
593
|
+
glcontext, cuja DLL o Smart App Control do Windows pode bloquear.
|
|
594
|
+
Em ambientes sem GPU/driver (RDP, VM sem aceleracao) o "auto" ja cai
|
|
595
|
+
pro QPainter sozinho.
|
|
596
|
+
"""
|
|
597
|
+
|
|
598
|
+
HOLOGRAM_STYLE: str = "quest"
|
|
599
|
+
"""Aparencia da mao.
|
|
600
|
+
|
|
601
|
+
- "quest" : mao 3D estilo headset VR — azul-acinzentado claro, luz
|
|
602
|
+
suave, borda luminosa, antebraco em fade, pontas brilham
|
|
603
|
+
na pinca (default)
|
|
604
|
+
- "graphite" : mesma mao, grafite translucido com contorno claro (fundos
|
|
605
|
+
claros)
|
|
606
|
+
- "neon" : visual antigo (silhueta neon + particulas, so 2D)
|
|
517
607
|
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
(RDP, VM sem aceleracao), usar "qpainter".
|
|
608
|
+
Nos estilos 3D a mao segue a pose real: aspecto correto da camera,
|
|
609
|
+
profundidade de cada articulacao e escala estavel pela palma (fechar a
|
|
610
|
+
mao nao a "infla"). Ver core/hand_pose.py.
|
|
522
611
|
"""
|
|
523
612
|
|
|
524
613
|
HOLOGRAM_TOGGLE_KEY: str = "h"
|
|
525
614
|
"""Tecla pra alternar o holograma em runtime."""
|
|
526
615
|
|
|
527
|
-
HOLOGRAM_OPACITY: float = 0.
|
|
528
|
-
"""Opacidade
|
|
529
|
-
fracoes
|
|
616
|
+
HOLOGRAM_OPACITY: float = 0.90
|
|
617
|
+
"""Opacidade da mao. No estilo "quest" o corpo fica ~72% opaco (borda
|
|
618
|
+
mais forte); no "neon" as camadas usam fracoes deste valor."""
|
|
530
619
|
|
|
531
620
|
HOLOGRAM_HAND_SIZE_PX: int = 180
|
|
532
|
-
"""Tamanho
|
|
621
|
+
"""Tamanho da mao na tela (px): comprimento da mao aberta, do pulso a
|
|
622
|
+
ponta do dedo medio. Nao muda com o gesto."""
|
|
533
623
|
|
|
534
|
-
HOLOGRAM_FPS: int =
|
|
535
|
-
"""
|
|
624
|
+
HOLOGRAM_FPS: int = 60
|
|
625
|
+
"""Limite de desenhos por segundo. A mao e' desenhada quando chega pose nova,
|
|
626
|
+
entao na pratica segue a camera; parada, nao gasta nada."""
|
|
536
627
|
|
|
537
628
|
HOLOGRAM_COLOR_BONE: str = "#00d4ff"
|
|
538
629
|
"""Cor primaria do holograma — azul neon ciano (linhas/contornos)."""
|
|
@@ -574,6 +665,19 @@ PERF_TELEMETRY_WINDOW: int = 120
|
|
|
574
665
|
PERF_TELEMETRY_REPORT_EVERY: int = 120
|
|
575
666
|
"""Logar report a cada N ticks (= 2s a 60 FPS)."""
|
|
576
667
|
|
|
668
|
+
# ---------------------------------------------------------------------
|
|
669
|
+
# MODO DUAS MAOS
|
|
670
|
+
# ---------------------------------------------------------------------
|
|
671
|
+
# As duas maos aparecem no holograma e executam os mesmos gestos. O sistema
|
|
672
|
+
# tem um cursor so: ele segue a mao dona, a outra clica no proprio ponteiro
|
|
673
|
+
# e so uma arrasta por vez (ver core/two_hands.py). Toggle via tecla B ou
|
|
674
|
+
# painel S; exclusivo com o modo apresentacao. Desligado nao custa nada.
|
|
675
|
+
|
|
676
|
+
TWO_HANDS_ENABLED: bool = False
|
|
677
|
+
"""Comeca com o modo ligado."""
|
|
678
|
+
|
|
679
|
+
TWO_HANDS_TOGGLE_KEY: str = "b"
|
|
680
|
+
|
|
577
681
|
# ---------------------------------------------------------------------
|
|
578
682
|
# MODO APRESENTACAO
|
|
579
683
|
# ---------------------------------------------------------------------
|