Detección de Objetos — Seguimiento de Palo de Golf y Bola

¿Qué es la Detección de Objetos?

Cuando la Detección de Objetos está habilitada, Swing Catalyst detecta el palo de golf y la bola en cada fotograma de video y dibuja superposiciones 3D sobre la visualización del esqueleto. Verás lo siguiente:

• Superposición del palo — cinco puntos clave a lo largo de la varilla (parte superior de la cabeza, parte inferior de la cabeza, parte inferior de la varilla, punto medio y extremo del grip) conectados por líneas codificadas por color. Los colores se desvanecen de amarillo en la cabeza del palo a cian en el grip, de modo que la orientación queda clara de inmediato.
• Superposición de la bola — una única esfera blanca en la posición detectada de la bola.

Las superposiciones aparecen tanto en la vista de cámara en vivo como durante la Reproducción de tomas grabadas. Las tomas grabadas sin Detección de Objetos se reproducen con normalidad, mostrando solo la visualización del esqueleto corporal.

Por qué la Detección de Objetos es exclusiva de golf

Actualmente, la Detección de Objetos solo es compatible con golf. Los modelos subyacentes (RTMDet-M para la detección de objetos y RTMPose-M para la estimación de la pose del palo) están entrenados específicamente con equipamiento de golf. Ampliar la función a otros deportes (béisbol, tenis) requiere modelos entrenados adicionales, que todavía no están disponibles. La arquitectura está diseñada para admitir deportes adicionales en el futuro; no será necesario modificar el código del pipeline cuando se publiquen nuevos modelos.

Cómo habilitar o deshabilitar la Detección de Objetos

Modo de Detección (configuración global)

1. Abre Configuración → Video y Capturar.
2. Desplázate hasta la sección Configuración Avanzada.
3. Busca el menú desplegable Modo de Detección.
   • MultiClass — ejecuta la detección de personas Y la Detección de Objetos. Esta es la opción predeterminada.
   • HumanOnly — ejecuta únicamente la detección de personas. Usa esta opción si no necesitas el seguimiento del palo y la bola, o si tienes problemas de rendimiento.
4. Cambiar el modo reinicia automáticamente los servicios de detección. No es necesario reiniciar la aplicación.

Interruptor Habilitar Detección de Objetos (por sesión)

Cuando el Modo de Detección está configurado en MultiClass, hay disponible un interruptor independiente llamado Habilitar Detección de Objetos. Desactívalo para omitir temporalmente la Detección de Objetos en la sesión actual sin cambiar el Modo de Detección global. Este interruptor aparece atenuado cuando el Modo de Detección es HumanOnly.

Mostrar u ocultar superposiciones en el visor

Usa la barra de herramientas situada encima del visor para mostrar u ocultar de forma independiente las superposiciones del palo y de la bola:

• Mostrar Palo — activa o desactiva la superposición de puntos clave y huesos del palo.
• Mostrar Bola — activa o desactiva la superposición de la esfera de la bola.

Estos interruptores surten efecto de inmediato sin reiniciar la detección y se conservan entre sesiones.

Requisitos de Hardware

La Detección de Objetos requiere más memoria de GPU que la Captura de Movimiento solo del cuerpo.

Para más detalles y la lista completa de tarjetas gráficas compatibles, consulta Especificaciones de computadora recomendadas .

En sistemas con menos de 8 GB de VRAM, la aplicación puede recurrir automáticamente a la detección solo de personas. Si esto ocurre, aparecerá un banner de notificación en Configuración → Video y Capturar.

Gráficos integrados Intel (UHD 620/770): la Detección de Objetos se deshabilita automáticamente en configuraciones con iGPU Intel porque el presupuesto de VRAM asignado por el sistema operativo (normalmente entre 400 y 800 MB) es insuficiente. La Captura de Movimiento solo de personas sigue funcionando con normalidad.

Qué se ve en la Reproducción

Cuando abres una toma que fue grabada con la Detección de Objetos habilitada:

• Las superposiciones del palo y de la bola aparecen en la línea de tiempo junto con el esqueleto corporal.
• Las superposiciones permanecen sincronizadas con el fotograma de video al desplazarte por la línea de tiempo.
• Las detecciones de baja confianza se desvanecen en lugar de saltar a posiciones incorrectas.
• Puedes activar o desactivar de forma independiente la visibilidad del palo y de la bola con los controles de la barra de herramientas descritos anteriormente.

Las tomas grabadas antes de que la Detección de Objetos estuviera disponible, o con el Modo de Detección configurado en HumanOnly, muestran solo el esqueleto corporal. No es necesario reprocesarlas para verlas: se abren con normalidad.

Para agregar datos de Detección de Objetos a una toma existente, abre la grabación en modo de análisis, haz clic en el botón Captura de Movimiento de la barra de herramientas y elige Reprocesar MoCap. Esto vuelve a ejecutar tanto la detección corporal como la Detección de Objetos sobre los fotogramas grabados.

Solución de problemas

Las superposiciones del palo y de la bola no aparecen

1. Comprueba que Configuración → Video y Capturar → Modo de Detección esté configurado en MultiClass.
2. Comprueba que el interruptor Habilitar Detección de Objetos esté activado.
3. Comprueba si en la configuración se muestra el banner de notificación “Los modelos de seguimiento del palo y la bola aún no están disponibles”. Si es así, faltan los archivos de modelo necesarios en el directorio de componentes. Reinstala los componentes de Captura de Movimiento siguiendo la Guía de instalación de componentes .

Advertencia de VRAM / recurso automático a solo personas

La aplicación registra una advertencia y recurre a la detección solo de personas cuando:

• DirectML informa menos de 600 MB de VRAM libre al iniciar el servicio, o
• el sistema tiene una GPU integrada Intel.

Para solucionarlo: asegúrate de que no haya otras aplicaciones que exijan mucho de la GPU en ejecución y comprueba que tu tarjeta gráfica cumpla las especificaciones recomendadas para la detección MultiClass (mínimo 8 GB de VRAM).

Las superposiciones aparecen para la actividad incorrecta

La Detección de Objetos solo está activa para actividades de golf. Si estás grabando un deporte que no es golf y no ves superposiciones del palo o de la bola, este es el comportamiento esperado. La configuración del Modo de Detección no se muestra en Configuración para actividades que no son de golf.

Baja precisión de detección o superposiciones parpadeantes

• Asegúrate de que el palo y la bola estén bien iluminados y no queden ocultos durante una parte significativa del swing.
• Prueba a reducir la velocidad de fotogramas de la cámara para disminuir la carga del sistema (consulta Configuración de Captura de Movimiento ).
• Aumenta el umbral de confianza de detección en Configuración → Video y Capturar → Configuración Avanzada si observas detecciones falsas de objetos del fondo.
• Si la detección es constantemente deficiente, prueba a cambiar el Execution Provider a DirectML, ya que ofrece la compatibilidad de hardware más amplia.

Faltan archivos de modelo tras una actualización

Si una actualización de la aplicación cambia las versiones de modelo necesarias, el banner de notificación volverá a aparecer en la configuración. Sigue la Guía de instalación de componentes para reinstalar los componentes.

Consulta también: Guía de Captura de Movimiento · Configuración de Captura de Movimiento · Requisitos del sistema