프로젝트 소개

Portrait Image Breakdown은 인물 촬영 현장을 위해 설계된 데스크톱 도구로, 세 가지 실제 문제에 초점을 맞춘다. 사진 속 인물의 2D 포즈, 방향, 프레이밍과 구도를 분석하고, 분석을 짧고 구체적이며 모델에게 바로 말할 수 있는 현장 지시로 전환하며, 참고 이미지와 현재 이미지를 비교해 포즈, 피사체 위치, 구도 측면의 조정 제안을 제공한다. 주 인터페이스는 2D 분석, 현장 지시, 이미지 비교의 세 페이지뿐이며, 워크플로는 촬영 파라미터의 이론적 도출보다 촬영 시점의 즉각적인 판단을 우선한다. 2D 분석 페이지 오른쪽 상단에는 별도로 열리는 3D 재구성 도구가 있어 이미지가 대응할 수 있는 카메라와 장면 가설을 탐색하는 데 사용된다. 이 모듈은 관측값(Observed), 추정값(Estimated), 미지 항목(Unknown)을 명확히 구분하여 단일 이미지의 추론을 정밀 측정으로 간주하지 않도록 한다. 프로젝트는 Python 3.12+를 사용하고 uv로 의존성을 관리하며, .jpg, .jpeg, .png, .bmp, .webp 이미지를 지원하고 2D 페이지에서 캔버스를 클릭하거나 사진을 끌어다 놓을 수 있다. 코드는 core(2D 포즈, 구도와 현장 지시), gui(세 개의 주 페이지와 선택적 3D 창), reverse_engineering(주 흐름과 분리된 선택적 3D 추론 모듈) 등으로 나뉘며, pytest 테스트와 PyInstaller Windows 패키징 설정을 제공한다.