Saltar para o conteúdo
Suporte Swing Catalyst Suporte Swing Catalyst
Contactar suporte

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)

  1. Abra Configurações → Vídeo e Captura.
  2. Role até a seção Configurações Avançadas.
  3. 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.
  4. 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.

ModoVRAM MínimaVRAM Recomendada
HumanOnly (somente corpo)6 GB8 GB
MultiClass (corpo + equipamento de golfe)8 GB10 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

  1. Verifique se Configurações → Vídeo e Captura → Modo de Detecção está definido como MultiClass.
  2. Verifique se o alternador Ativar Detecção de Objeto está ativado.
  3. 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