Detekcja obiektów — śledzenie kija golfowego i piłki

Czym jest detekcja obiektów?

Gdy detekcja obiektów jest włączona, Swing Catalyst wykrywa kij golfowy i piłkę w każdej klatce wideo i rysuje nakładki 3D na wizualizacji szkieletu. Widoczne są:

• Nakładka kija — pięć punktów charakterystycznych wzdłuż trzonka (górna część główki, dolna część główki, dół trzonka, środek i koniec uchwytu) połączonych liniami w kolorach kodujących położenie. Kolory przechodzą od żółtego przy główce kija do turkusowego przy uchwycie, dzięki czemu orientacja kija jest od razu widoczna.
• Nakładka piłki — pojedyncza biała kula w wykrytej pozycji piłki.

Nakładki pojawiają się zarówno podczas podglądu na żywo z kamery, jak i podczas odtwarzania nagranych ujęć. Ujęcia nagrane bez detekcji obiektów są odtwarzane normalnie, z wizualizacją samego ciała.

Dlaczego detekcja obiektów dotyczy tylko golfa

Detekcja obiektów obsługuje obecnie wyłącznie golf. Modele leżące u podstaw tej funkcji (RTMDet-M do detekcji obiektów i RTMPose-M do estymacji pozy kija) są trenowane specjalnie pod kątem sprzętu golfowego. Rozszerzenie na inne dyscypliny (baseball, tenis) wymaga dodatkowych wytrenowanych modeli, które nie są jeszcze dostępne. Architektura została zaprojektowana z myślą o obsłudze kolejnych dyscyplin w przyszłości — po udostępnieniu nowych modeli nie będą potrzebne żadne zmiany w kodzie samego potoku przetwarzania.

Jak włączyć lub wyłączyć detekcję obiektów

Tryb detekcji (ustawienie globalne)

1. Otwórz Ustawienia → Wideo i przechwytywanie.
2. Przewiń do sekcji Ustawienia zaawansowane.
3. Znajdź listę rozwijaną Tryb detekcji.
   • MultiClass — uruchamia jednocześnie detekcję osób i detekcję obiektów. To ustawienie domyślne.
   • HumanOnly — uruchamia wyłącznie detekcję osób. Wybierz tę opcję, jeśli śledzenie kija i piłki nie jest potrzebne lub gdy występują problemy z wydajnością.
4. Zmiana trybu automatycznie restartuje usługi detekcji. Ponowne uruchomienie aplikacji nie jest wymagane.

Przełącznik Włącz detekcję obiektów (dla bieżącej sesji)

Gdy Tryb detekcji jest ustawiony na MultiClass, dostępny jest osobny przełącznik Włącz detekcję obiektów. Wyłącz go, aby tymczasowo pominąć detekcję obiektów w bieżącej sesji bez zmiany globalnego Trybu detekcji. Ten przełącznik jest wyszarzony, gdy Tryb detekcji jest ustawiony na HumanOnly.

Pokazywanie / ukrywanie nakładek w oknie podglądu

Użyj paska narzędzi nad oknem podglądu, aby niezależnie pokazywać lub ukrywać nakładki kija i piłki:

• Show Club — przełącza nakładkę punktów charakterystycznych i kości kija.
• Show Ball — przełącza nakładkę kuli reprezentującej piłkę.

Te przełączniki działają natychmiast, bez ponownego uruchamiania detekcji, i zachowują ustawienie między sesjami.

Wymagania sprzętowe

Detekcja obiektów wymaga więcej pamięci GPU niż przechwytywanie ruchu ograniczone do samego ciała.

Pełne informacje oraz pełną listę zgodnych kart graficznych znajdziesz w Zalecane specyfikacje komputera .

W systemach z mniej niż 8 GB VRAM aplikacja może automatycznie przełączyć się na detekcję ograniczoną do osób. Jeśli tak się stanie, w Ustawienia → Wideo i przechwytywanie pojawi się baner z powiadomieniem.

Zintegrowane karty graficzne Intela (UHD 620/770): Detekcja obiektów jest automatycznie wyłączana w konfiguracjach z układem iGPU Intela, ponieważ budżet VRAM przydzielany przez system operacyjny (zwykle 400–800 MB) jest niewystarczający. Przechwytywanie ruchu ograniczone do osób nadal działa normalnie.

Co widać podczas odtwarzania

Po otwarciu ujęcia nagranego z włączoną detekcją obiektów:

• Nakładki kija i piłki pojawiają się na osi czasu razem ze szkieletem ciała.
• Nakładki pozostają zsynchronizowane z klatką wideo podczas przewijania osi czasu.
• Detekcje o niskiej pewności stopniowo zanikają, zamiast przeskakiwać do nieprawidłowych pozycji.
• Widoczność kija i piłki można przełączać niezależnie za pomocą opisanych wyżej elementów paska narzędzi.

Ujęcia nagrane przed udostępnieniem detekcji obiektów lub z Trybem detekcji ustawionym na HumanOnly pokazują wyłącznie szkielet ciała. Ich obejrzenie nie wymaga ponownego przetwarzania — otwierają się normalnie.

Aby dodać dane detekcji obiektów do istniejącego ujęcia, otwórz nagranie w trybie analizy, kliknij przycisk Przechwytywanie ruchu na pasku narzędzi i wybierz Reprocess MoCap. Spowoduje to ponowne uruchomienie zarówno detekcji ciała, jak i detekcji obiektów na nagranych klatkach.

Rozwiązywanie problemów

Nakładki kija i piłki się nie pojawiają

1. Sprawdź, czy Ustawienia → Wideo i przechwytywanie → Tryb detekcji jest ustawiony na MultiClass.
2. Sprawdź, czy przełącznik Włącz detekcję obiektów jest włączony.
3. Sprawdź, czy w ustawieniach wyświetla się baner z powiadomieniem „Club and ball tracking models are not yet available”. Jeśli tak, w katalogu komponentów brakuje wymaganych plików modeli. Zainstaluj ponownie komponenty przechwytywania ruchu zgodnie z Component Installation Guide .

Ostrzeżenie o VRAM / automatyczne przełączenie na detekcję osób

Aplikacja zapisuje ostrzeżenie w dzienniku zdarzeń i przełącza się na detekcję ograniczoną do osób, gdy:

• DirectML zgłasza mniej niż 600 MB wolnej pamięci VRAM przy uruchamianiu usługi, lub
• system korzysta ze zintegrowanej karty graficznej Intela.

Aby rozwiązać ten problem: upewnij się, że nie działają inne aplikacje intensywnie korzystające z GPU, i sprawdź, czy karta graficzna spełnia zalecane specyfikacje dla detekcji w trybie MultiClass (minimum 8 GB VRAM).

Nakładki pojawiają się dla niewłaściwej aktywności

Detekcja obiektów jest aktywna wyłącznie dla aktywności golfowych. Jeśli nagrywasz dyscyplinę inną niż golf i nie widzisz nakładek kija ani piłki, jest to zachowanie zamierzone. Ustawienie Trybu detekcji nie jest wyświetlane w Ustawieniach dla aktywności innych niż golf.

Niska dokładność detekcji lub migoczące nakładki

• Upewnij się, że kij i piłka są dobrze oświetlone i nie są zasłonięte przez znaczną część swingu.
• Spróbuj obniżyć liczbę klatek na sekundę kamery, aby zmniejszyć obciążenie systemu (zobacz Motion Capture Settings ).
• Jeśli pojawiają się fałszywe detekcje obiektów z tła, zwiększ próg pewności detekcji w Ustawienia → Wideo i przechwytywanie → Ustawienia zaawansowane.
• Jeśli detekcja jest stale słabej jakości, spróbuj przełączyć Execution Provider na DirectML, ponieważ ma on najszerszą kompatybilność sprzętową.

Brakujące pliki modeli po aktualizacji

Jeśli aktualizacja aplikacji zmienia wymagane wersje modeli, w ustawieniach ponownie pojawi się baner z powiadomieniem. Postępuj zgodnie z Component Installation Guide , aby ponownie zainstalować komponenty.

Zobacz też: Motion Capture Guide · Motion Capture Settings · System Requirements