객체 탐지 — 골프 클럽 및 공 트래킹

객체 탐지란?

객체 탐지가 활성화되면 Swing Catalyst는 모든 비디오 프레임에서 골프 클럽과 공을 감지하고, 스켈레톤 시각화 위에 3D 오버레이를 표시합니다. 다음과 같은 요소를 확인할 수 있습니다.

• 클럽 오버레이 — 샤프트를 따라 배치된 다섯 개의 키포인트(헤드 상단, 헤드 하단, 샤프트 하단, 중간, 그립 끝)가 색상으로 구분된 선으로 연결됩니다. 클럽 헤드 쪽 노란색에서 그립 쪽 청록색으로 색이 서서히 바뀌기 때문에 방향을 한눈에 파악할 수 있습니다.
• 공 오버레이 — 감지된 공의 위치에 흰색 구체 하나로 표시됩니다.

오버레이는 실시간 카메라 화면과 녹화된 테이크의 재생 화면 모두에 나타납니다. 객체 탐지 없이 녹화된 테이크는 신체 스켈레톤만 표시된 상태로 정상적으로 재생됩니다.

객체 탐지가 골프 전용인 이유

객체 탐지는 현재 골프 종목만 지원합니다. 기반이 되는 모델(객체 탐지용 RTMDet-M, 클럽 자세 추정용 RTMPose-M)이 골프 장비 데이터로 특화 학습되었기 때문입니다. 다른 종목(야구, 테니스)으로 확장하려면 별도로 학습된 모델이 필요한데, 아직 이러한 모델은 준비되어 있지 않습니다. 다만 아키텍처 자체는 향후 다른 종목을 추가로 지원할 수 있도록 설계되어 있어서, 새 모델이 출시되더라도 파이프라인 코드를 변경할 필요는 없습니다.

객체 탐지를 켜고 끄는 방법

탐지 모드(전역 설정)

1. 설정 → 비디오 및 캡처를 엽니다.
2. 고급 설정 섹션까지 스크롤합니다.
3. 탐지 모드 드롭다운을 찾습니다.
   • MultiClass — 인물 감지와 객체 탐지를 함께 실행합니다. 기본값입니다.
   • HumanOnly — 인물 감지만 실행합니다. 클럽과 공 트래킹이 필요하지 않거나 성능 문제가 있을 때 사용하세요.
4. 모드를 변경하면 탐지 서비스가 자동으로 재시작됩니다. 앱을 다시 시작할 필요는 없습니다.

객체 탐지 활성화 토글(세션별)

탐지 모드가 MultiClass로 설정되어 있으면 별도의 객체 탐지 활성화 토글을 사용할 수 있습니다. 전역 탐지 모드를 바꾸지 않고 현재 세션에서만 일시적으로 객체 탐지를 건너뛰려면 이 토글을 끄면 됩니다. 탐지 모드가 HumanOnly일 때는 이 토글이 비활성화(회색)됩니다.

뷰포트에서 오버레이 표시 / 숨기기

뷰포트 위쪽의 툴바를 사용하면 클럽과 공 오버레이를 각각 독립적으로 표시하거나 숨길 수 있습니다.

• Show Club — 클럽 키포인트와 본(bone) 오버레이를 켜고 끕니다.
• Show Ball — 공 구체 오버레이를 켜고 끕니다.

이 토글은 탐지를 재시작하지 않고 즉시 적용되며, 세션 간에도 설정이 유지됩니다.

하드웨어 요구 사항

객체 탐지는 신체만 추적하는 모션 캡처보다 더 많은 GPU 메모리를 필요로 합니다.

전체 내용과 호환 그래픽 카드 전체 목록은 권장 컴퓨터 사양 을 참고하세요.

VRAM이 8GB 미만인 시스템에서는 애플리케이션이 자동으로 인물 전용 감지로 전환될 수 있습니다. 이런 경우 설정 → 비디오 및 캡처에 알림 배너가 표시됩니다.

Intel 내장 그래픽(UHD 620/770): OS가 할당하는 VRAM 용량(일반적으로 400~800MB)이 부족하기 때문에 Intel 내장 GPU 구성에서는 객체 탐지가 자동으로 비활성화됩니다. 인물 전용 모션 캡처는 평소와 같이 계속 작동합니다.

재생 화면에서 보이는 내용

객체 탐지를 활성화한 상태로 녹화된 테이크를 열면 다음과 같이 표시됩니다.

• 타임라인에서 신체 스켈레톤과 함께 클럽 및 공 오버레이가 나타납니다.
• 타임라인을 스크러빙해도 오버레이가 비디오 프레임과 동기화된 상태를 유지합니다.
• 신뢰도가 낮은 감지 결과는 잘못된 위치로 튀는 대신 서서히 사라집니다.
• 위에서 설명한 툴바 컨트롤을 사용해 클럽과 공의 표시 여부를 각각 independent하게 전환할 수 있습니다.

객체 탐지 기능이 도입되기 전에 녹화되었거나 탐지 모드가 HumanOnly로 설정된 상태로 녹화된 테이크는 신체 스켈레톤만 표시됩니다. 이런 테이크를 보기 위해 다시 처리할 필요는 없으며, 정상적으로 열립니다.

기존 테이크에 객체 탐지 데이터를 추가하려면 분석 모드에서 해당 녹화를 열고, 툴바의 모션 캡처 버튼을 클릭한 다음 Reprocess MoCap을 선택하세요. 그러면 녹화된 프레임에 대해 신체 감지와 객체 탐지가 모두 다시 실행됩니다.

문제 해결

클럽과 공 오버레이가 나타나지 않는 경우

1. 설정 → 비디오 및 캡처 → 탐지 모드가 MultiClass로 설정되어 있는지 확인하세요.
2. 객체 탐지 활성화 토글이 켜져 있는지 확인하세요.
3. 설정 화면에 “클럽 및 공 트래킹 모델을 아직 사용할 수 없습니다"라는 알림 배너가 표시되는지 확인하세요. 표시된다면 필요한 모델 파일이 컴포넌트 디렉터리에 없는 것입니다. 컴포넌트 설치 가이드 를 따라 모션 캡처 컴포넌트를 다시 설치하세요.

VRAM 경고 / 인물 전용으로 자동 전환

다음과 같은 경우 애플리케이션은 경고를 기록하고 인물 전용 감지로 자동 전환합니다.

• 서비스 시작 시 DirectML이 보고하는 사용 가능한 VRAM이 600MB 미만인 경우, 또는
• 시스템에 Intel 내장 GPU가 있는 경우.

해결 방법: GPU 자원을 많이 사용하는 다른 애플리케이션이 실행 중이지 않은지 확인하고, 그래픽 카드가 MultiClass 탐지에 필요한 권장 사양 (최소 VRAM 8GB)을 충족하는지 확인하세요.

오버레이가 엉뚱한 활동에 표시되는 경우

객체 탐지는 골프 활동에서만 작동합니다. 골프가 아닌 종목을 녹화 중이고 클럽이나 공 오버레이가 보이지 않는다면 이는 정상적인 동작입니다. 골프가 아닌 활동에서는 설정 화면에 탐지 모드 항목 자체가 표시되지 않습니다.

감지 정확도가 낮거나 오버레이가 깜박이는 경우

• 스윙의 상당 부분에서 클럽과 공이 잘 보이고 가려지지 않도록 조명을 충분히 확보하세요.
• 카메라 프레임 속도를 낮춰 시스템 부하를 줄여 보세요(모션 캡처 설정 참고).
• 배경 물체로 인한 오탐지가 발생한다면 설정 → 비디오 및 캡처 → 고급 설정에서 탐지 신뢰도 임계값을 높이세요.
• 감지 품질이 계속 좋지 않다면 **실행 공급자(Execution Provider)**를 DirectML로 전환해 보세요. 하드웨어 호환성이 가장 넓은 옵션입니다.

업데이트 이후 모델 파일이 누락된 경우

애플리케이션 업데이트로 필요한 모델 버전이 바뀌면 설정 화면에 알림 배너가 다시 나타납니다. 컴포넌트 설치 가이드 를 따라 컴포넌트를 다시 설치하세요.

참고: 모션 캡처 가이드 · 모션 캡처 설정 · 시스템 요구 사항