🎥 UnityGaussianCapture

UnityGaussianCapture는 Gaussian Splatting 및 4DGS와 같은 신경 렌더링(neural rendering) 파이프라인을 위해 3D 장면을 캡처하고 데이터를 내보내도록 설계된 Unity 에디터 도구입니다. 이 도구는 장면 캡처, 시퀀스 기록, 자동화된 학습에 대한 간소화된 인터페이스를 제공합니다.

Tool Overview

---

✨ 주요 기능 (Features)

• 🖼️ 투명 렌더링 지원 (Transparent rendering support)
• 🎞️ 4DGS용 시퀀스 기록 (Sequence recording for 4DGS)
• 🤖 캡처 후 자동 PostShot 학습 (Automatic PostShot training after capture)
• 🧩 SkinnedMeshRenderers를 위한 MeshCollider 생성 및 새로 고침 (점 구름(point cloud) 생성을 위해)
• 📦 내보내기 형식: .psht, .ply
• 🧪 학습 프로필: Splat3, MCMC, ADC
• 🌀 돔 캡처 (Dome Capture) 및 🧊 볼륨 캡처 (Volume Capture) 모드

---

🧰 UI 개요 (UI Overview)

🎛️ 카메라 설정 (Camera Settings)

• 카메라 (Camera): 캡처에 사용되는 Unity 카메라를 선택합니다.
• 해상도 (Resolution): 가로 및 세로 픽셀 수입니다.
• 점 구름/뷰 (PointCloud/View): 뷰당 점의 개수입니다.

⏱️ 캡처 실행 시간 (Capture Runtime)

• 런타임 캡처 활성화 (Enable Runtime Capture)
• FPS / 지속 시간: 프레임 속도와 캡처 길이를 제어합니다.
• PostShot에서 학습: 캡처 후 자동으로 학습을 시작합니다.
• PostShot CLI 경로: postshot-cli.exe의 경로입니다.
• 학습 단계 (Training Steps): 학습 반복 횟수입니다.

💾 출력 형식 (Output Format)

• .psht와 .ply 중 선택합니다.

🧪 학습 프로필 (Training Profile)

• Splat3, MCMC, 또는 ADC 중에서 선택합니다.

📁 출력 폴더 (Output Folder)

• 내보내기 데이터의 대상 폴더를 선택합니다.

---

🌀 돔 캡처 (Dome Capture)

돔 구성을 사용하여 타겟 주변의 뷰를 캡처합니다:

• 타겟 (Target): 궤도 변환(Transform to orbit)
• 링 개수 (Number of Rings)
• 링당 뷰 수 (Views per Ring)
• 반지름 (Radius)
• 높이 (Height)

---

🧊 볼륨 캡처 (Volume Capture)

3D 볼륨 그리드 내의 뷰를 캡처합니다:

• 볼륨 중심 (Volume Center): X, Y, Z 좌표입니다.
• 볼륨 크기 (Volume Size): X, Y, Z 방향의 치수입니다.
• 세분화 (Subdivisions): 각 축을 따라 그리드 분할 횟수입니다.
• 그리드 표시 (Show Grid): 그리드 시각화를 토글합니다.

📦 설치 (Installation) (Unity Package Manager를 통해)

Unity의 Package Manager를 사용하여 GitHub에서 UnityGaussianCapture를 직접 설치할 수 있습니다.

Unity 프로젝트를 엽니다.
Window → Package Manager로 이동합니다.
좌측 상단의 + 버튼을 클릭하고 → Add package from Git URL...을 선택합니다.
다음 URL을 붙여넣습니다:

Add를 클릭합니다. Unity가 패키지를 가져와 설치할 것입니다.

---

🚀 사용법

1. GameObject에 Camera Dome Gizmo 컴포넌트를 추가합니다.
2. 장면에 있는 오브젝트에 Mesh Collider 컴포넌트를 추가합니다.
3. 카메라, 캡처 모드 및 출력 설정을 구성합니다 (시퀀스를 내보내려면 재생하고 일시 정지해야 합니다).
4. Capture and Export COLMAP을 클릭하여 프로세스를 시작합니다.
5. 활성화된 경우, PostShot 학습이 자동으로 실행됩니다.
6. 학습이 완료되면 터미널 창을 닫을 수 있습니다.
   
   
   How To Use

---

🛠️ 요구 사항

• Unity 6.x
• PostShot (선택 사항, 학습용)
• Editor Coroutines Package (com.unity.editorcoroutines)