Fspy

이미지 기반 카메라 매칭

입력 이미지에서 사용자가 정의한 4개의 모서리 점을 통해 두 개의 수직 vanishing point를 추정하고, 이를 바탕으로 카메라의 위치, 회전, 초점 거리, principal point 등을 계산합니다.

Blender 직접 연동 지원

공식 fSpy Blender 임포터 애드온을 사용하면 .fspy 파일을 바로 가져와 Blender 카메라에 파라미터를 적용하고, 선택적으로 배경 이미지도 설정할 수 있습니다.

범용 카메라 파라미터 내보내기

계산된 카메라 파라미터는 수동으로 복사하여 다른 3D 애플리케이션에 적용할 수 있으며, 뷰포트 크기, 이미지 배경, FOV, 위치, 회전, principal point 순으로 설정하는 과정을 따릅니다.

다운로드·설치 방법

공식 웹사이트(fspy.io)에서 Windows용 ZIP 파일을 다운로드받아 압축을 해제한 후, fSpy.exe 파일을 더블클릭하여 실행합니다. 별도의 설치 과정 없이 바로 사용할 수 있는 포터블 형태입니다.

기본 사용법/명령어

1. fSpy를 실행하고 ‘Open Image’ 버튼으로 분석할 이미지를 불러옵니다.
2. 이미지 상에서 직사각형 또는 사각형 구조물의 네 모서리를 순서대로 클릭하여 컨트롤 포인트를 배치합니다.
3. 왼쪽 패널의 ‘Vanishing point axes’ 설정에서 각 vanishing point에 X, Y, Z 축을 적절히 할당합니다 (예: 빨간 선은 X축, 초록선은 Y축, 파란선은 Z축).
4. 메인 화면에서 실시간으로 추정된 카메라 파라미터를 확인하고, ‘Export’ 버튼으로 .fspy 파일을 저장하거나, Blender 임포터를 통해 바로 적용합니다.
5. Blender에서 공식 임포터를 설치한 후, ‘Import > fSpy’ 메뉴를 통해 프로젝트 파일을 불러오면 카메라가 자동 생성됩니다.

이런 경우에 유용합니다

실내 건축 사진이나 거리 풍경 사진에서 실제 카메라 위치를 재현하여 3D 모델링 작업의 기반으로 사용하고자 하는 건축 시각화 아티스트, Blender 사용자, VFX 프리비주얼라이제이션 작업자에게 유용합니다. 이미지 속 건물의 벽이나 바닥 모서리를 기준으로 카메라 매칭을 수행함으로써, 복잡한 카메라 트래킹 없이도 정확한 원근법을 재현할 수 있습니다.

지원 환경·시스템 요구사항

Windows 10 이상 64비트 시스템에서 실행 가능하며, Electron 기반 애플리케이션으로서 별도의 런타임 설치 없이 제공되는 실행 파일을 사용합니다.

최신 버전·업데이트

현재 버전은 1.0.3이며, 공식 GitHub 저장소의 develop 브랜치에서 최신 소스 코드를 확인할 수 있습니다. 업데이트 정보는 GitHub 릴리스 페이지 또는 공식 웹사이트에서 제공됩니다.

제한 사항·확인 사항

카메라 매칭의 정확도는 입력 이미지에서 명확한 직사각형 또는 사각형 구조물의 모서리를 식별할 수 있는지에 달려 있습니다. 흐릿한 이미지, 왜곡이 강한 렌즈로 촬영된 사진, 또는 기준이 되는 직각 구조물이 없는 장면에서는 신뢰도가 낮아질 수 있습니다. 또한, principal point가 이미지 중앙과 일치하는 경우 별도로 설정할 필요가 없으며, 이는 자동으로 처리됩니다.