ai-virtual-mouse-controller 1.0.1__py3-none-any.whl
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.0.1.dist-info/METADATA +130 -0
- ai_virtual_mouse_controller-1.0.1.dist-info/RECORD +27 -0
- ai_virtual_mouse_controller-1.0.1.dist-info/WHEEL +5 -0
- ai_virtual_mouse_controller-1.0.1.dist-info/entry_points.txt +2 -0
- ai_virtual_mouse_controller-1.0.1.dist-info/licenses/LICENSE +21 -0
- ai_virtual_mouse_controller-1.0.1.dist-info/top_level.txt +4 -0
- config.py +550 -0
- core/__init__.py +14 -0
- core/camera.py +205 -0
- core/click_burst.py +206 -0
- core/cursor_controller.py +305 -0
- core/finger_posture.py +131 -0
- core/gesture_detector.py +1056 -0
- core/hand_anchor.py +358 -0
- core/hand_mesh.py +804 -0
- core/hand_renderer.py +421 -0
- core/hand_tracker.py +238 -0
- core/hologram_gl_backend.py +993 -0
- core/hologram_overlay.py +894 -0
- core/perf_telemetry.py +166 -0
- core/runtime_settings.py +310 -0
- core/smoothing.py +233 -0
- core/ui_overlay.py +748 -0
- core/utils.py +126 -0
- main.py +47 -0
- services/__init__.py +1 -0
- services/virtual_mouse_service.py +839 -0
config.py
ADDED
|
@@ -0,0 +1,550 @@
|
|
|
1
|
+
"""
|
|
2
|
+
config.py (v6.5 - Easier Pinch)
|
|
3
|
+
================================
|
|
4
|
+
|
|
5
|
+
GESTOS:
|
|
6
|
+
- Mao aberta 🖐️ → move cursor
|
|
7
|
+
- Pinca 🤏 → clique simples (MAIS FACIL na v6.5)
|
|
8
|
+
- Pinca mantida 2s → iniciar arrasto
|
|
9
|
+
- Dois dedos ✌️ → DUPLO CLIQUE (cursor congela)
|
|
10
|
+
- Punho ✊ → cursor congelado
|
|
11
|
+
- Mao fora do frame → pausa
|
|
12
|
+
|
|
13
|
+
MUDANCAS v6.5 (pinch mais facil de disparar):
|
|
14
|
+
1. PINCH_DISTANCE_THRESHOLD: 0.055 → 0.075 (pinca mais "solta" funciona)
|
|
15
|
+
2. PINCH_THRESHOLD_FLOOR: novo (piso minimo do threshold adaptativo)
|
|
16
|
+
3. PINCH_DUAL_DETECTION: True → False (dual estava rejeitando cliques validos)
|
|
17
|
+
4. PINCH_MIN_HOLD_SECONDS: 0.03 → 0.015 (cliques mais rapidos passam)
|
|
18
|
+
5. CLICK_COOLDOWN_SECONDS: 0.35 → 0.25 (cliques consecutivos mais rapidos)
|
|
19
|
+
|
|
20
|
+
Mantem todas melhorias da v6.4:
|
|
21
|
+
- Sticky targeting (cursor "agarra" ao mirar)
|
|
22
|
+
- Aim assist com pre-ativacao + holdover
|
|
23
|
+
- Curva ballistica suavizada
|
|
24
|
+
"""
|
|
25
|
+
|
|
26
|
+
from typing import Literal, Tuple
|
|
27
|
+
|
|
28
|
+
# ---------------------------------------------------------------------
|
|
29
|
+
# CAMERA
|
|
30
|
+
# ---------------------------------------------------------------------
|
|
31
|
+
|
|
32
|
+
CAMERA_INDEX: int = 0
|
|
33
|
+
CAMERA_WIDTH: int = 960
|
|
34
|
+
CAMERA_HEIGHT: int = 540
|
|
35
|
+
CAMERA_FPS_TARGET: int = 60
|
|
36
|
+
|
|
37
|
+
# ---------------------------------------------------------------------
|
|
38
|
+
# MEDIAPIPE HANDS
|
|
39
|
+
# ---------------------------------------------------------------------
|
|
40
|
+
|
|
41
|
+
MAX_NUM_HANDS: int = 1
|
|
42
|
+
MIN_DETECTION_CONFIDENCE: float = 0.6
|
|
43
|
+
MIN_TRACKING_CONFIDENCE: float = 0.4
|
|
44
|
+
MODEL_COMPLEXITY: int = 0
|
|
45
|
+
"""
|
|
46
|
+
0=lite, 1=full.
|
|
47
|
+
|
|
48
|
+
PERF: lite reduz inference em ~40-50% vs full. Gesture pinch e' robusto
|
|
49
|
+
o suficiente pra rodar com lite sem perda perceptivel. Volta pra 1 se
|
|
50
|
+
notar drop na deteccao em iluminacao ruim ou mao longe da camera.
|
|
51
|
+
"""
|
|
52
|
+
|
|
53
|
+
INFERENCE_PRE_RESIZE_ENABLED: bool = False
|
|
54
|
+
"""
|
|
55
|
+
PERF: redimensiona o frame BGR antes de enviar pro MediaPipe.
|
|
56
|
+
MediaPipe rescale internamente — fazer antes corta memcpy + acelera.
|
|
57
|
+
|
|
58
|
+
Default False (compatibilidade). Liga pra testar ganho.
|
|
59
|
+
"""
|
|
60
|
+
|
|
61
|
+
INFERENCE_PRE_RESIZE_WIDTH: int = 320
|
|
62
|
+
"""Largura alvo do resize. Altura calculada mantendo aspect ratio."""
|
|
63
|
+
|
|
64
|
+
CV2_USE_POLLKEY: bool = True
|
|
65
|
+
"""
|
|
66
|
+
PERF: usa cv2.pollKey() (non-blocking) em vez de cv2.waitKeyEx(1).
|
|
67
|
+
|
|
68
|
+
waitKeyEx(1) no Windows respeita o timer default de 15.6 ms → cap em
|
|
69
|
+
~64 FPS na pratica. pollKey() (disponivel em opencv >= 4.7) nao tem
|
|
70
|
+
esse cap.
|
|
71
|
+
|
|
72
|
+
Fallback automatico pra waitKeyEx se pollKey nao existir na versao
|
|
73
|
+
de cv2 instalada. Coloca False se notar problema de window refresh.
|
|
74
|
+
"""
|
|
75
|
+
|
|
76
|
+
# ---------------------------------------------------------------------
|
|
77
|
+
# CURSOR — PONTO DE ANCORA
|
|
78
|
+
# ---------------------------------------------------------------------
|
|
79
|
+
#
|
|
80
|
+
# Define qual ponto da mao a posicao do cursor segue.
|
|
81
|
+
#
|
|
82
|
+
# Opcoes:
|
|
83
|
+
# -2 = ANCORA ROBUSTA DA MAO TODA — DEFAULT v6.9.11
|
|
84
|
+
# Combinacao ponderada de TODOS os 21 landmarks, com pesos por
|
|
85
|
+
# anatomia (palma > fingertips > intermediarios), por proximidade
|
|
86
|
+
# da borda do frame (landmark cortado pesa menos) e por estabilidade
|
|
87
|
+
# local (variancia curta = mais peso). Histerese suaviza queda de
|
|
88
|
+
# confianca. Resolve casos onde a webcam nao enxerga o centro da
|
|
89
|
+
# palma (mao de perfil, cantos do frame, oclusao parcial) — o
|
|
90
|
+
# cursor migra organicamente pros landmarks ainda visiveis sem
|
|
91
|
+
# saltos. Ver core/hand_anchor.py.
|
|
92
|
+
# -1 = MIDPOINT DO PINCH (polegar 4 + indicador 8)
|
|
93
|
+
# Alinha 1-pra-1 com a ancora do holograma; pinch fecha sobre o
|
|
94
|
+
# cursor. Vulneravel se polegar OU indicador for ocluido.
|
|
95
|
+
# 0 = pulso
|
|
96
|
+
# 8 = ponta do indicador
|
|
97
|
+
# 9 = palma (middle MCP) — comportamento legado pre-v6.9.10
|
|
98
|
+
# 12 = ponta do medio
|
|
99
|
+
#
|
|
100
|
+
CURSOR_ANCHOR_LANDMARK: int = -2
|
|
101
|
+
|
|
102
|
+
# ---------------------------------------------------------------------
|
|
103
|
+
# POSITION HOLD
|
|
104
|
+
# ---------------------------------------------------------------------
|
|
105
|
+
|
|
106
|
+
POSITION_HOLD_FRAMES: int = 2
|
|
107
|
+
"""
|
|
108
|
+
PERF/UX: 3 → 2 frames. Cursor reage 1 frame mais rapido a mudanca de
|
|
109
|
+
posicao. Pequeno mas perceptivel. Volta pra 3 se notar instabilidade.
|
|
110
|
+
"""
|
|
111
|
+
|
|
112
|
+
# ---------------------------------------------------------------------
|
|
113
|
+
# AIM ASSIST
|
|
114
|
+
# ---------------------------------------------------------------------
|
|
115
|
+
|
|
116
|
+
AIM_ASSIST_ENABLED: bool = True
|
|
117
|
+
AIM_ASSIST_SLOWDOWN_FACTOR: float = 0.40
|
|
118
|
+
AIM_ASSIST_TRIGGER_SHAPES: Tuple[str, ...] = ("peace", "pinch")
|
|
119
|
+
AIM_ASSIST_PRE_ACTIVATION: bool = True
|
|
120
|
+
AIM_ASSIST_PRE_PINCH_THRESHOLD: float = 0.12
|
|
121
|
+
"""v6.5: 0.10 → 0.12 (combina com novo threshold de pinca)"""
|
|
122
|
+
|
|
123
|
+
AIM_ASSIST_HOLDOVER_SECONDS: float = 0.30
|
|
124
|
+
PRECISION_MODE_DEAD_ZONE: int = 4
|
|
125
|
+
|
|
126
|
+
# ---------------------------------------------------------------------
|
|
127
|
+
# STICKY TARGETING
|
|
128
|
+
# ---------------------------------------------------------------------
|
|
129
|
+
|
|
130
|
+
STICKY_TARGETING_ENABLED: bool = True
|
|
131
|
+
STICKY_DECELERATION_THRESHOLD: float = 0.7
|
|
132
|
+
STICKY_FRICTION_FACTOR: float = 0.75
|
|
133
|
+
STICKY_MIN_VELOCITY: float = 0.005
|
|
134
|
+
|
|
135
|
+
# ---------------------------------------------------------------------
|
|
136
|
+
# CURVA BALLISTICA
|
|
137
|
+
# ---------------------------------------------------------------------
|
|
138
|
+
|
|
139
|
+
VELOCITY_CURVE_ENABLED: bool = True
|
|
140
|
+
VELOCITY_TREMOR_THRESHOLD: float = 0.003
|
|
141
|
+
VELOCITY_PRECISION_ZONE: float = 0.025
|
|
142
|
+
VELOCITY_SLOW_FACTOR: float = 0.55
|
|
143
|
+
VELOCITY_FAST_THRESHOLD: float = 0.12
|
|
144
|
+
VELOCITY_FAST_FACTOR: float = 1.15
|
|
145
|
+
|
|
146
|
+
# ---------------------------------------------------------------------
|
|
147
|
+
# DPI ADAPTATIVO
|
|
148
|
+
# ---------------------------------------------------------------------
|
|
149
|
+
|
|
150
|
+
DPI_ADAPTIVE_ENABLED: bool = True
|
|
151
|
+
HAND_SIZE_REFERENCE: float = 0.22
|
|
152
|
+
DPI_MULTIPLIER_MIN: float = 0.7
|
|
153
|
+
DPI_MULTIPLIER_MAX: float = 1.4
|
|
154
|
+
DPI_FIXED_MULTIPLIER: float = 0.85
|
|
155
|
+
|
|
156
|
+
# ---------------------------------------------------------------------
|
|
157
|
+
# SUAVIZACAO
|
|
158
|
+
# ---------------------------------------------------------------------
|
|
159
|
+
|
|
160
|
+
SmoothingStrategy = Literal["ema", "one_euro"]
|
|
161
|
+
SMOOTHING_STRATEGY: SmoothingStrategy = "one_euro"
|
|
162
|
+
|
|
163
|
+
SMOOTHING_FACTOR: float = 0.6
|
|
164
|
+
|
|
165
|
+
ONE_EURO_FREQ: float = 60.0
|
|
166
|
+
ONE_EURO_MIN_CUTOFF: float = 1.2
|
|
167
|
+
ONE_EURO_BETA: float = 0.020
|
|
168
|
+
ONE_EURO_D_CUTOFF: float = 1.0
|
|
169
|
+
DEAD_ZONE_PIXELS: int = 1
|
|
170
|
+
|
|
171
|
+
# ---------------------------------------------------------------------
|
|
172
|
+
# PINCA (v6.5: MAIS FACIL DE DISPARAR)
|
|
173
|
+
# ---------------------------------------------------------------------
|
|
174
|
+
|
|
175
|
+
PINCH_DISTANCE_THRESHOLD: float = 0.075
|
|
176
|
+
"""
|
|
177
|
+
v6.5: 0.055 → 0.075 (+36% mais permissivo).
|
|
178
|
+
Pinca natural (dedos proximos mas nao encostando) agora funciona.
|
|
179
|
+
Antes: precisava encostar polegar no indicador para disparar.
|
|
180
|
+
"""
|
|
181
|
+
|
|
182
|
+
PINCH_THRESHOLD_FLOOR: float = 0.045
|
|
183
|
+
"""
|
|
184
|
+
NOVO v6.5: piso MINIMO do threshold apos escala adaptativa.
|
|
185
|
+
Quando mao esta longe (hand_size < reference), o threshold cai proporcionalmente.
|
|
186
|
+
Sem o piso: mao a 0.10 fazia threshold virar 0.034 (impossivel de fechar).
|
|
187
|
+
Com piso 0.045: garantia de que nunca fica absurdamente apertado.
|
|
188
|
+
"""
|
|
189
|
+
|
|
190
|
+
PINCH_ADAPTIVE_TO_HAND_SIZE: bool = True
|
|
191
|
+
|
|
192
|
+
PINCH_DUAL_DETECTION: bool = False
|
|
193
|
+
"""
|
|
194
|
+
v6.5: True → False (DESABILITADO).
|
|
195
|
+
A deteccao dual (distancia + velocidade de aproximacao) estava
|
|
196
|
+
REJEITANDO pincas legitimas quando o usuario relaxava os dedos
|
|
197
|
+
para soltar. Sem ela, deteccao volta a ser confiavel.
|
|
198
|
+
A protecao contra falsos positivos vem do debounce de 2 frames + threshold
|
|
199
|
+
mais cuidadoso.
|
|
200
|
+
"""
|
|
201
|
+
|
|
202
|
+
PINCH_VELOCITY_THRESHOLD: float = 0.008 # ainda existe se voce quiser reabilitar
|
|
203
|
+
|
|
204
|
+
PINCH_MIN_HOLD_SECONDS: float = 0.015
|
|
205
|
+
"""
|
|
206
|
+
NOVO v6.5: tempo minimo da pinca para contar como click.
|
|
207
|
+
Antes era hardcoded em 0.03s (30ms). Agora 0.015s (15ms).
|
|
208
|
+
Permite cliques mais rapidos e fluidos.
|
|
209
|
+
"""
|
|
210
|
+
|
|
211
|
+
# ---------------------------------------------------------------------
|
|
212
|
+
# CLIQUE DIREITO — pinca polegar+medio (NOVO v6.9)
|
|
213
|
+
# ---------------------------------------------------------------------
|
|
214
|
+
|
|
215
|
+
PINCH_MIDDLE_THRESHOLD: float = 0.075
|
|
216
|
+
"""
|
|
217
|
+
v6.9: distancia maxima polegar (lm 4) → ponta do dedo medio (lm 12)
|
|
218
|
+
para classificar como pinca do clique direito.
|
|
219
|
+
|
|
220
|
+
Mesmo valor da pinca normal (PINCH_DISTANCE_THRESHOLD) para manter
|
|
221
|
+
sensacao consistente entre os dois gestos.
|
|
222
|
+
"""
|
|
223
|
+
|
|
224
|
+
PINCH_MIDDLE_INDEX_GUARD: float = 0.090
|
|
225
|
+
"""
|
|
226
|
+
v6.9: distancia MINIMA polegar → indicador (lm 4 → lm 8) para
|
|
227
|
+
permitir o clique direito.
|
|
228
|
+
|
|
229
|
+
Por que: ao fechar polegar+medio, o indicador tende a se aproximar
|
|
230
|
+
junto (mecanica natural da mao). Sem essa guarda, dispararia pinca
|
|
231
|
+
normal (CLICK) tambem. Esse threshold forca o usuario a manter o
|
|
232
|
+
indicador afastado do polegar para o clique direito ser reconhecido.
|
|
233
|
+
|
|
234
|
+
Resultado: pinca normal e clique direito ficam mutuamente exclusivos.
|
|
235
|
+
"""
|
|
236
|
+
|
|
237
|
+
# ---------------------------------------------------------------------
|
|
238
|
+
# POSTURA ANATOMICA — anti acoplamento de tendoes (v6.9.12)
|
|
239
|
+
# ---------------------------------------------------------------------
|
|
240
|
+
# Durante PINCH (polegar+indicador), o dedo medio cai naturalmente 30-50%
|
|
241
|
+
# do quanto o indicador caiu — efeito do flexor digitorum profundus (FDP)
|
|
242
|
+
# que controla os 4 dedos juntos. Isso fazia o classificador antigo
|
|
243
|
+
# disparar PINCH_MIDDLE (RIGHT_CLICK) inadvertidamente durante CLICK.
|
|
244
|
+
#
|
|
245
|
+
# Fix: alem das distancias par-a-par, validamos a POSTURA dos dedos via
|
|
246
|
+
# score de extensao (razao distancia direta MCP→TIP / soma de segmentos).
|
|
247
|
+
# Score ∈ [0,1]: ~1.0 = dedo reto, ~0.65 = curvado, ~0.40 = fechado.
|
|
248
|
+
|
|
249
|
+
PINCH_MIDDLE_INDEX_EXTENSION_MIN: float = 0.88
|
|
250
|
+
"""
|
|
251
|
+
Score MINIMO de extensao do indicador para validar PINCH_MIDDLE.
|
|
252
|
+
|
|
253
|
+
0.88 = indicador claramente apontando (apenas leve flexao natural).
|
|
254
|
+
Durante um PINCH normal, o indicador esta CURVADO (score 0.65-0.80) —
|
|
255
|
+
nessa faixa, a porta de PINCH_MIDDLE fica fechada. So abre quando o
|
|
256
|
+
usuario estende deliberadamente o indicador, indicando intencao real
|
|
257
|
+
de fazer o gesto de clique direito.
|
|
258
|
+
|
|
259
|
+
Ajuste UP (0.92+) se ainda houver falsos positivos.
|
|
260
|
+
Ajuste DOWN (0.80-) se o gesto intencional for rejeitado por sobra
|
|
261
|
+
de flexao natural do indicador.
|
|
262
|
+
"""
|
|
263
|
+
|
|
264
|
+
PINCH_MIDDLE_MIDDLE_EXTENSION_MAX: float = 0.92
|
|
265
|
+
"""
|
|
266
|
+
Score MAXIMO de extensao do dedo medio para validar PINCH_MIDDLE.
|
|
267
|
+
|
|
268
|
+
0.92 = medio nao pode estar totalmente reto. Para PINCH_MIDDLE real
|
|
269
|
+
o medio precisa ter dobrado para encontrar o polegar — entao deve
|
|
270
|
+
estar pelo menos em flexao leve. Sem esse limite, um gesto onde
|
|
271
|
+
todos os dedos estao estendidos e por acidente o medio passa perto do
|
|
272
|
+
polegar dispararia o clique direito.
|
|
273
|
+
|
|
274
|
+
Ajuste UP (0.96) para aceitar gestos mais sutis.
|
|
275
|
+
Ajuste DOWN (0.85) se houver falsos positivos com medio quase reto.
|
|
276
|
+
"""
|
|
277
|
+
|
|
278
|
+
# ---------------------------------------------------------------------
|
|
279
|
+
# DRAG
|
|
280
|
+
# ---------------------------------------------------------------------
|
|
281
|
+
|
|
282
|
+
DRAG_HOLD_SECONDS: float = 1.5
|
|
283
|
+
"""
|
|
284
|
+
1.5s = aggressive: drag dispara rapido.
|
|
285
|
+
|
|
286
|
+
Compat: press-to-click ja disparou em ~0ms. Quem so quer clicar
|
|
287
|
+
solta antes de 1.5s → sem drag acidental. Mas pinch sustentado >1.5s
|
|
288
|
+
sem mover muito ja entra em drag — risco maior se voce hesitar
|
|
289
|
+
durante um clique.
|
|
290
|
+
"""
|
|
291
|
+
|
|
292
|
+
# ---------------------------------------------------------------------
|
|
293
|
+
# CLIQUE E COOLDOWNS (v6.5: cliques consecutivos mais rapidos)
|
|
294
|
+
# ---------------------------------------------------------------------
|
|
295
|
+
|
|
296
|
+
CLICK_COOLDOWN_SECONDS: float = 0.25
|
|
297
|
+
"""v6.5: 0.35 → 0.25 (cliques consecutivos mais rapidos)"""
|
|
298
|
+
|
|
299
|
+
DOUBLE_CLICK_COOLDOWN_SECONDS: float = 2.5
|
|
300
|
+
DOUBLE_CLICK_WINDOW_SECONDS: float = 0.35
|
|
301
|
+
|
|
302
|
+
# ---------------------------------------------------------------------
|
|
303
|
+
# HISTERESE DE GESTOS
|
|
304
|
+
# ---------------------------------------------------------------------
|
|
305
|
+
|
|
306
|
+
GESTURE_DEBOUNCE_FRAMES: int = 2
|
|
307
|
+
GESTURE_EXIT_FRAMES: int = 3
|
|
308
|
+
|
|
309
|
+
# ---------------------------------------------------------------------
|
|
310
|
+
# TELA E MAPEAMENTO
|
|
311
|
+
# ---------------------------------------------------------------------
|
|
312
|
+
|
|
313
|
+
SCREEN_MARGIN_PERCENTAGE: float = 0.10
|
|
314
|
+
"""
|
|
315
|
+
v6.9.13: 0.18 → 0.10. Margem reduzida significa que o usuario nao precisa
|
|
316
|
+
levar a mao ate o ULTIMO 18% da borda da camera pra atingir a borda da
|
|
317
|
+
tela — bordas do desktop, taskbar, cantos pra fechar janela ficam
|
|
318
|
+
alcancaveis sem forcar a mao pra fora do quadro util do MediaPipe (que
|
|
319
|
+
e' onde os landmarks comecam a falhar).
|
|
320
|
+
|
|
321
|
+
Trade-off: cursor fica ligeiramente mais sensivel no centro. Compensado
|
|
322
|
+
pelo drag_precision_factor (DPI baixo durante drag) e pelo aim_assist
|
|
323
|
+
slowdown (DPI baixo perto de cliques). Resultado liquido: precisao
|
|
324
|
+
maior nas tarefas que IMPORTAM (clicks finos, selecao) e alcance fluido
|
|
325
|
+
nas bordas que ANTES travavam.
|
|
326
|
+
"""
|
|
327
|
+
|
|
328
|
+
# ---------------------------------------------------------------------
|
|
329
|
+
# FEEL DE MOUSE FISICO (v6.9.13)
|
|
330
|
+
# ---------------------------------------------------------------------
|
|
331
|
+
# Replicam dois fundamentos que fazem mouse fisico ser preciso:
|
|
332
|
+
# 1. Apertar o botao NUNCA desloca o cursor.
|
|
333
|
+
# 2. DPI baixo durante movimentos finos (texto, drag).
|
|
334
|
+
|
|
335
|
+
CLICK_FREEZE_SECONDS: float = 0.12
|
|
336
|
+
"""
|
|
337
|
+
Quanto tempo o cursor fica TRAVADO no pixel atual logo apos um click.
|
|
338
|
+
|
|
339
|
+
Problema que resolve: ao fechar a pinca (polegar+indicador), o midpoint
|
|
340
|
+
4+8 (= ancora do cursor) inerentemente se desloca alguns pixels — o
|
|
341
|
+
polegar avanca em direcao ao indicador. Sem freeze, o cursor "viaja"
|
|
342
|
+
2-10px durante o click, o que faz cliques em alvos pequenos errarem.
|
|
343
|
+
|
|
344
|
+
0.12s = 120ms: cobre o intervalo entre a deteccao do raw shape PINCH e
|
|
345
|
+
a estabilizacao da pose pos-fechamento. Aumente para 0.15-0.20s se ainda
|
|
346
|
+
notar deriva no click. Diminua para 0.08s se sentir cursor "preso" apos
|
|
347
|
+
clicks rapidos consecutivos.
|
|
348
|
+
"""
|
|
349
|
+
|
|
350
|
+
DRAG_PRECISION_FACTOR: float = 0.55
|
|
351
|
+
"""
|
|
352
|
+
Multiplicador do delta do cursor enquanto DRAG esta ativo.
|
|
353
|
+
|
|
354
|
+
0.55 = mao precisa percorrer ~1.8x a distancia pra cobrir o mesmo pixel
|
|
355
|
+
range. Replica o feel de "ajustar DPI pra baixo" que profissionais
|
|
356
|
+
fazem fisicamente quando vao selecionar texto, fazer drag de selecao
|
|
357
|
+
retangular, ou arrastar icones pra um local preciso.
|
|
358
|
+
|
|
359
|
+
Sem isso, a tremedeira da mao no ar (3-5 pixels naturais) atrapalha a
|
|
360
|
+
selecao de palavras / linhas no editor. Com 0.55, a mesma tremedeira
|
|
361
|
+
vira 1.6-2.7 pixels — abaixo do limite perceptual.
|
|
362
|
+
|
|
363
|
+
Ajuste UP (0.7-0.8) se o drag estiver lento demais.
|
|
364
|
+
Ajuste DOWN (0.4) pra precisao maxima em telas 4K+.
|
|
365
|
+
"""
|
|
366
|
+
|
|
367
|
+
# ---------------------------------------------------------------------
|
|
368
|
+
# DEBUG E PREVIEW
|
|
369
|
+
# ---------------------------------------------------------------------
|
|
370
|
+
|
|
371
|
+
ENABLE_PREVIEW: bool = True
|
|
372
|
+
SHOW_FPS: bool = True
|
|
373
|
+
SHOW_GESTURE_NAME: bool = True
|
|
374
|
+
SHOW_DPI: bool = True
|
|
375
|
+
SHOW_DRAG_PROGRESS: bool = True
|
|
376
|
+
SHOW_AIM_ASSIST: bool = True
|
|
377
|
+
DRAW_LANDMARKS: bool = True
|
|
378
|
+
WINDOW_NAME: str = "AI Virtual Mouse v6.5 — ESC to quit"
|
|
379
|
+
|
|
380
|
+
# ---------------------------------------------------------------------
|
|
381
|
+
# JANELA DE EXIBICAO (NOVO v6.9 — UX webcam de streamer)
|
|
382
|
+
# ---------------------------------------------------------------------
|
|
383
|
+
|
|
384
|
+
DISPLAY_COMPACT_WIDTH: int = 480
|
|
385
|
+
DISPLAY_COMPACT_HEIGHT: int = 270
|
|
386
|
+
"""
|
|
387
|
+
Tamanho da janela em modo COMPACTO (sem painel de settings).
|
|
388
|
+
A camera continua capturando em CAMERA_WIDTH x CAMERA_HEIGHT (resolucao
|
|
389
|
+
cheia para a IA), mas o frame e redimensionado antes de ser exibido.
|
|
390
|
+
Detec
|
|
391
|
+
cao da mao nao perde precisao."""
|
|
392
|
+
|
|
393
|
+
DISPLAY_EXPANDED_WIDTH: int = 760
|
|
394
|
+
DISPLAY_EXPANDED_HEIGHT: int = 540
|
|
395
|
+
"""
|
|
396
|
+
Tamanho quando o painel de settings esta aberto (tecla S).
|
|
397
|
+
Mais alto e mais largo para acomodar o painel lateral sem cortar
|
|
398
|
+
nem distorcer os controles.
|
|
399
|
+
"""
|
|
400
|
+
|
|
401
|
+
DISPLAY_POSITION_BOTTOM_RIGHT: bool = True
|
|
402
|
+
"""
|
|
403
|
+
Se True, posiciona a janela automaticamente no canto inferior direito
|
|
404
|
+
da tela ao iniciar (estilo webcam de streamer/OBS). Se False, deixa o
|
|
405
|
+
sistema operacional decidir a posicao inicial.
|
|
406
|
+
"""
|
|
407
|
+
|
|
408
|
+
DISPLAY_POSITION_MARGIN: int = 20
|
|
409
|
+
"""Distancia em pixels da borda da tela ao posicionar automaticamente."""
|
|
410
|
+
|
|
411
|
+
DISPLAY_ALWAYS_ON_TOP: bool = True
|
|
412
|
+
"""
|
|
413
|
+
NOVO v6.9: mantem a janela da webcam SEMPRE visivel acima de outras janelas.
|
|
414
|
+
|
|
415
|
+
Por que: sem isso, ao clicar em qualquer outra aplicacao (browser, codigo,
|
|
416
|
+
documentos) a janela da webcam vai pra tras e voce nao consegue ver sua
|
|
417
|
+
mao para controlar o cursor.
|
|
418
|
+
|
|
419
|
+
Mesmo comportamento que webcams de streamers no OBS Studio: a previa fica
|
|
420
|
+
sempre vivivel acima de tudo, mas voce continua podendo clicar e trabalhar
|
|
421
|
+
nas outras janelas normalmente.
|
|
422
|
+
|
|
423
|
+
Se quiser desabilitar (ex: durante apresentacao em tela cheia), use a tecla
|
|
424
|
+
T para alternar em runtime, ou mude esta constante para False.
|
|
425
|
+
"""
|
|
426
|
+
|
|
427
|
+
DISPLAY_TOPMOST_TOGGLE_KEY: str = "t"
|
|
428
|
+
"""Tecla para alternar always-on-top em runtime. Use 't'."""
|
|
429
|
+
|
|
430
|
+
# ---------------------------------------------------------------------
|
|
431
|
+
# HOLOGRAMA (mao virtual desenhada na tela)
|
|
432
|
+
# ---------------------------------------------------------------------
|
|
433
|
+
|
|
434
|
+
HOLOGRAM_ENABLED: bool = False
|
|
435
|
+
"""
|
|
436
|
+
Se True, abre uma janela fullscreen transparente sobre o desktop e desenha
|
|
437
|
+
uma mao "holografica" pequena seguindo o cursor. Pode ser ligada em runtime
|
|
438
|
+
pela tecla H.
|
|
439
|
+
|
|
440
|
+
Default False porque adiciona overhead visual. Em modo demonstracao/onboarding
|
|
441
|
+
ela faz a experiencia parecer mais magica; em uso prolongado pode distrair.
|
|
442
|
+
"""
|
|
443
|
+
|
|
444
|
+
HOLOGRAM_BACKEND: str = "auto"
|
|
445
|
+
"""
|
|
446
|
+
Backend de renderizacao do holograma (v6.9.8):
|
|
447
|
+
- "auto" : tenta GL primeiro; cai pra QPainter se ModernGL/driver falhar
|
|
448
|
+
- "gl" : forca ModernGL (mesh 3D + GLSL shader, look hologram real)
|
|
449
|
+
- "qpainter" : forca pipeline 2D vetorial original (compatibilidade/debug)
|
|
450
|
+
|
|
451
|
+
ModernGL backend renderiza a mao como mesh 3D real (palm ellipsoide +
|
|
452
|
+
finger capsules) com shader holografico (fresnel rim, depth fade, cyan
|
|
453
|
+
volumetric). Visualmente proximo de "mao 3D translucida projetada".
|
|
454
|
+
|
|
455
|
+
Tradeoff: requer driver OpenGL 3.3+. Em ambientes sem GPU/driver (RDP,
|
|
456
|
+
VM sem aceleracao), usar "qpainter" pra forcar fallback.
|
|
457
|
+
"""
|
|
458
|
+
|
|
459
|
+
HOLOGRAM_TOGGLE_KEY: str = "h"
|
|
460
|
+
"""Tecla pra alternar o holograma em runtime."""
|
|
461
|
+
|
|
462
|
+
HOLOGRAM_OPACITY: float = 0.70
|
|
463
|
+
"""
|
|
464
|
+
Opacidade base. Camadas (palm/finger outline, particles, tips) usam
|
|
465
|
+
fracoes desse valor. 0.70 + paleta azul ciano da contraste suficiente
|
|
466
|
+
sem virar barulho.
|
|
467
|
+
"""
|
|
468
|
+
|
|
469
|
+
HOLOGRAM_HAND_SIZE_PX: int = 180
|
|
470
|
+
"""
|
|
471
|
+
Tamanho do bounding box da mao em pixels. 180 da presenca visual sem
|
|
472
|
+
estorvar — com curvas Catmull-Rom + glow PySide6 a mao ja parece anatomica.
|
|
473
|
+
"""
|
|
474
|
+
|
|
475
|
+
HOLOGRAM_FPS: int = 30
|
|
476
|
+
"""Taxa de redesenho. 30 Hz e' suave + economico em CPU."""
|
|
477
|
+
|
|
478
|
+
HOLOGRAM_COLOR_BONE: str = "#00d4ff"
|
|
479
|
+
"""
|
|
480
|
+
Cor primaria do holograma — azul neon ciano. Estilo HUD futurista.
|
|
481
|
+
Usado nas linhas/contornos da mao. Substitui o vermelho do MVP.
|
|
482
|
+
"""
|
|
483
|
+
|
|
484
|
+
HOLOGRAM_COLOR_POINT: str = "#e0f7ff"
|
|
485
|
+
"""
|
|
486
|
+
Cor dos pontos brilhantes (tips, particulas). Branco azulado para
|
|
487
|
+
contraste com o azul ciano do contorno.
|
|
488
|
+
"""
|
|
489
|
+
|
|
490
|
+
HOLOGRAM_PARTICLES_ENABLED: bool = False
|
|
491
|
+
"""
|
|
492
|
+
Liga nuvem densa de particles dentro da silhueta. Default False = visual
|
|
493
|
+
clean moderno (sem ruido visual). True = particle cloud densa.
|
|
494
|
+
"""
|
|
495
|
+
|
|
496
|
+
HOLOGRAM_PARTICLE_COUNT: int = 180
|
|
497
|
+
"""
|
|
498
|
+
Numero de particles na nuvem. 180 = densidade boa sem custo de FPS.
|
|
499
|
+
Aumentar pra ~300 da look mais "particle cloud". Acima disso pode
|
|
500
|
+
comecar a impactar perceptivelmente.
|
|
501
|
+
"""
|
|
502
|
+
|
|
503
|
+
HOLOGRAM_VIEW_DORSAL: bool = False
|
|
504
|
+
"""
|
|
505
|
+
Vista anatomica do holograma.
|
|
506
|
+
|
|
507
|
+
True = dorsal (costas da mao na tela) — espelha X dos landmarks
|
|
508
|
+
False = palm view — segue webcam mirroreada (sua mao real "transmitida"
|
|
509
|
+
na tela em 3a pessoa)
|
|
510
|
+
|
|
511
|
+
Default False = visual coerente com a imagem da webcam.
|
|
512
|
+
"""
|
|
513
|
+
|
|
514
|
+
HOLOGRAM_TRANSPARENT_COLOR: str = "#010203"
|
|
515
|
+
"""
|
|
516
|
+
Cor "magica" pintada como fundo do canvas que vira transparente no compositor
|
|
517
|
+
do Windows. Tem que ser uma cor que nao apareca em mais nada desenhado.
|
|
518
|
+
"""
|
|
519
|
+
|
|
520
|
+
# ---------------------------------------------------------------------
|
|
521
|
+
# PERFORMANCE TELEMETRY (instrumentation per estagio do tick loop)
|
|
522
|
+
# ---------------------------------------------------------------------
|
|
523
|
+
|
|
524
|
+
PERF_TELEMETRY_ENABLED: bool = True
|
|
525
|
+
"""
|
|
526
|
+
Liga timing por estagio (camera/inference/gesture/events/hologram/preview/
|
|
527
|
+
waitkey). Reporta p50/p99 a cada N ticks via logger.info.
|
|
528
|
+
|
|
529
|
+
Custo: ~100ns por entry/exit (desprezivel). Coloca False em producao se
|
|
530
|
+
quiser zero overhead.
|
|
531
|
+
"""
|
|
532
|
+
|
|
533
|
+
PERF_TELEMETRY_WINDOW: int = 120
|
|
534
|
+
"""Tamanho do rolling window de samples por estagio (= 2s a 60 FPS)."""
|
|
535
|
+
|
|
536
|
+
PERF_TELEMETRY_REPORT_EVERY: int = 120
|
|
537
|
+
"""Logar report a cada N ticks (= 2s a 60 FPS)."""
|
|
538
|
+
|
|
539
|
+
# ---------------------------------------------------------------------
|
|
540
|
+
# SEGURANCA
|
|
541
|
+
# ---------------------------------------------------------------------
|
|
542
|
+
|
|
543
|
+
PYAUTOGUI_FAILSAFE: bool = False
|
|
544
|
+
PYAUTOGUI_PAUSE: float = 0.0
|
|
545
|
+
|
|
546
|
+
# ---------------------------------------------------------------------
|
|
547
|
+
# LOGGING
|
|
548
|
+
# ---------------------------------------------------------------------
|
|
549
|
+
|
|
550
|
+
LOG_LEVEL: str = "INFO"
|
core/__init__.py
ADDED
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
"""Core components: camera, hand tracking, smoothing, gestures, cursor.
|
|
2
|
+
|
|
3
|
+
Esta camada concentra a logica de dominio do projeto. Modulos foram
|
|
4
|
+
escritos para serem importaveis isoladamente — quem precisa de
|
|
5
|
+
`RobustHandAnchor` nao precisa instanciar `HologramOverlay`.
|
|
6
|
+
|
|
7
|
+
Versao do pacote vive em `__version__` e e' a fonte unica de verdade
|
|
8
|
+
(consumida por `pyproject.toml` se quisermos no futuro via dynamic).
|
|
9
|
+
"""
|
|
10
|
+
|
|
11
|
+
from __future__ import annotations
|
|
12
|
+
|
|
13
|
+
__version__ = "1.0.1"
|
|
14
|
+
__all__ = ["__version__"]
|