Detecção de Objeto — Rastreamento de Taco de Golfe e Bola
O Que É a Detecção de Objeto?
Quando a Detecção de Objeto está ativada, o Swing Catalyst detecta o taco de golfe e a bola em cada quadro do vídeo e desenha sobreposições 3D sobre a visualização do esqueleto. Você verá:
- Sobreposição do taco — cinco pontos-chave ao longo do cabo (topo da cabeça, base da cabeça, base do cabo, meio e ponta do grip) conectados por linhas com cores codificadas. As cores vão do amarelo, na cabeça do taco, ao ciano, no grip, para que a orientação fique imediatamente clara.
- Sobreposição da bola — uma única esfera branca na posição detectada da bola.
As sobreposições aparecem tanto na visualização ao vivo da câmera quanto na reprodução de gravações. Gravações feitas sem a Detecção de Objeto são reproduzidas normalmente, apenas com a visualização do corpo.
Por Que a Detecção de Objeto É Exclusiva para Golfe
No momento, a Detecção de Objeto oferece suporte apenas a golfe. Os modelos subjacentes (RTMDet-M para a detecção de objeto e RTMPose-M para a estimativa de pose do taco) são treinados especificamente com equipamentos de golfe. Estender o suporte a outros esportes (beisebol, tênis) requer modelos adicionais treinados, que ainda não estão disponíveis. A arquitetura foi projetada para suportar outros esportes no futuro; nenhuma alteração de código no pipeline será necessária quando novos modelos forem lançados.
Como Ativar ou Desativar a Detecção de Objeto
Modo de Detecção (configuração global)
- Abra Configurações → Vídeo e Captura.
- Role até a seção Configurações Avançadas.
- Localize o menu suspenso Modo de Detecção.
- MultiClass — executa a detecção de pessoas E a Detecção de Objeto. Esta é a opção padrão.
- HumanOnly — executa apenas a detecção de pessoas. Use esta opção se você não precisar do rastreamento de taco e bola, ou se estiver enfrentando problemas de desempenho.
- Alterar o modo reinicia os serviços de detecção automaticamente. Não é necessário reiniciar o aplicativo.
Alternador Ativar Detecção de Objeto (por sessão)
Quando o Modo de Detecção está definido como MultiClass, um alternador separado, Ativar Detecção de Objeto, fica disponível. Desative-o para ignorar temporariamente a Detecção de Objeto na sessão atual, sem alterar o Modo de Detecção global. Este alternador fica desabilitado (em cinza) quando o Modo de Detecção é HumanOnly.
Mostrar/ocultar sobreposições na janela de visualização
Use a barra de ferramentas acima da janela de visualização para mostrar ou ocultar as sobreposições de taco e bola de forma independente:
- Mostrar Taco — alterna a sobreposição dos pontos-chave e das linhas do taco.
- Mostrar Bola — alterna a sobreposição da esfera da bola.
Esses alternadores têm efeito imediato, sem reiniciar a detecção, e permanecem entre sessões.
Requisitos de Hardware
A Detecção de Objeto exige mais memória de GPU do que a Captura de Movimento apenas do corpo.
| Modo | VRAM Mínima | VRAM Recomendada |
|---|---|---|
| HumanOnly (somente corpo) | 6 GB | 8 GB |
| MultiClass (corpo + equipamento de golfe) | 8 GB | 10 GB+ |
Para todos os detalhes e a lista completa de placas de vídeo compatíveis, consulte Especificações de computador recomendadas .
Em sistemas com menos de 8 GB de VRAM, o aplicativo pode reverter automaticamente para a detecção apenas de pessoas. Um banner de notificação aparecerá em Configurações → Vídeo e Captura se isso acontecer.
Placas gráficas integradas Intel (UHD 620/770): a Detecção de Objeto é desativada automaticamente em configurações com iGPU Intel, porque o orçamento de VRAM atribuído pelo sistema operacional (normalmente 400–800 MB) é insuficiente. A Captura de Movimento apenas de pessoas continua funcionando normalmente.
O Que Você Vê na Reprodução
Ao abrir uma gravação feita com a Detecção de Objeto ativada:
- As sobreposições de taco e bola aparecem na linha do tempo junto com o esqueleto do corpo.
- As sobreposições permanecem sincronizadas com o quadro de vídeo ao navegar pela linha do tempo.
- Detecções de baixa confiança se dissipam gradualmente, em vez de saltar para posições incorretas.
- Você pode alternar a visibilidade do taco e da bola de forma independente usando os controles da barra de ferramentas descritos acima.
Gravações feitas antes da disponibilidade da Detecção de Objeto, ou com o Modo de Detecção definido como HumanOnly, mostram apenas o esqueleto do corpo. Não é necessário reprocessamento para visualizá-las — elas abrem normalmente.
Para adicionar dados de Detecção de Objeto a uma gravação existente, abra a gravação no modo de análise, clique no botão Captura de Movimento na barra de ferramentas e escolha Reprocess MoCap. Isso executa novamente tanto a detecção de pessoas quanto a Detecção de Objeto nos quadros gravados.
Solução de Problemas
As sobreposições de taco e bola não aparecem
- Verifique se Configurações → Vídeo e Captura → Modo de Detecção está definido como MultiClass.
- Verifique se o alternador Ativar Detecção de Objeto está ativado.
- Verifique se o banner de notificação “Os modelos de rastreamento de taco e bola ainda não estão disponíveis” aparece nas configurações. Se aparecer, os arquivos de modelo necessários estão faltando no diretório de componentes. Reinstale os componentes de Captura de Movimento seguindo o Guia de Instalação de Componentes .
Aviso de VRAM / reversão automática para detecção apenas de pessoas
O aplicativo registra um aviso e reverte para a detecção apenas de pessoas quando:
- o DirectML relata menos de 600 MB de VRAM livre na inicialização do serviço, ou
- o sistema possui uma GPU integrada Intel.
Para resolver isso: certifique-se de que nenhum outro aplicativo intensivo em GPU esteja em execução e verifique se sua placa de vídeo atende às especificações recomendadas para a detecção MultiClass (mínimo de 8 GB de VRAM).
As sobreposições aparecem para a atividade errada
A Detecção de Objeto só está ativa para atividades de golfe. Se você estiver gravando um esporte que não seja golfe e não vir sobreposições de taco ou bola, esse é o comportamento esperado. A configuração Modo de Detecção não é exibida nas Configurações para atividades que não sejam de golfe.
Baixa precisão de detecção ou sobreposições instáveis
- Certifique-se de que o taco e a bola estejam bem iluminados e não fiquem obscurecidos durante uma parte significativa do swing.
- Tente reduzir a taxa de quadros da câmera para diminuir a carga do sistema (veja Configurações de Captura de Movimento ).
- Aumente o limiar de confiança de detecção em Configurações → Vídeo e Captura → Configurações Avançadas se estiver notando detecções falsas de objetos no fundo.
- Para detecção consistentemente ruim, tente alternar o Execution Provider para DirectML, pois ele tem a maior compatibilidade de hardware.
Arquivos de modelo ausentes após uma atualização
Se uma atualização do aplicativo alterar as versões necessárias dos modelos, o banner de notificação reaparecerá nas configurações. Siga o Guia de Instalação de Componentes para reinstalar os componentes.
Veja também: Guia de Captura de Movimento · Configurações de Captura de Movimento · Requisitos do Sistema