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.
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__"]