필요한 입력: 영화·참고 영상 또는 실제 영상을 얻을 링크, 분석 범위와 관심사(카메라·인물 동선·공간·조명 등). 평면도·현장 자료·확인된 치수도 함께 받는다.
결과물: 인터랙티브 HTML, 같은 데이터의 동기화 분석 영상, 편집 가능 Blender 프로젝트, 구조화 데이터. 원본·현재 샷·동적 현장·샷 목록·대사를 함께 표시하고 대표 시점의 원본/모델 비교를 첨부한다.
완성 화면에서 가능한 촬영법을 설명하는 영화 분석·교육·레퍼런스 연구용이다. 대본·새 스토리보드로 촬영을 설계하는 「Blender 스토리보드 프리비즈」와 연계하되 결과물은 각각 검수한다.
실행 리소스 확보
용도: 샷·현장·시간 데이터를 고정된 인터랙티브 HTML로 만들고 동기화 영상을 내보낸다. 표시 템플릿·데이터 검증·패키징 스크립트이며 원본 분석·Blender 모델링·카메라 보정을 대신하지 않는다. 분석 후 6단계에서 사용하고 7단계에서 실제 페이지·영상 검수에 쓴다.
리소스 패키지 다운로드 · 20261105.1 · 247,835 bytes
SHA-256: 7b23efc304ee4a6c57ef7036486ab1c7e696712657992ed1518a4c6951567144
다운로드 후 크기·SHA-256 검증을 거쳐 현재 프로젝트에 압축을 푼다. 검증값이 같은 동일 버전은 재사용 가능하다. 루트는 3d-film-set-report/이며 이하 assets/·scripts/·영감 디렉터리 자리표시자는 이를 뜻한다. 구조·패키지 스크립트를 유지하고 동명 구버전을 섞지 않는다. 사용자 영상·분석 결과는 없다.
Python 3·FFprobe·esbuild가 필요하다. 패키지 검증 스크립트·페이지 모듈로 필드를 확인하고 build_report.py --help에 따라 분석 JSON·구간 MP4·샷 프레임으로 HTML을 빌드한다. 시스템 폰트를 쓴다. Blender 프로젝트는 없으므로 본문대로 모델링·보정한다.
도구와 역할
- 분석 방법: 자료 확인·전체 감상·샷 분할·핵심 요소·샷 간 관계·편집·소리 분석이 본문에 있다. 다른 분석 영감 조회 없이 직접 실행한다.
- 호스트 Agent: 실제 멀티모달 기능으로 영상·증거를 파악하고 공간·카메라를 추론하며 필요한 스크립트·결과 검사를 수행한다.
- Blender: 공간·간소화 인물·소품·카메라·시야·조명 도식을 만들고 렌더·저장한다. 검증된 CLI/MCP를 재사용한다. GUI 없는 배치는 백그라운드 스크립트, GUI 연속 조정은 커뮤니티 MCP가 가능하다. 둘 다 최소 작업으로 검증하며 데스크톱 제어 실패만으로 사용 불가라 하지 않는다.
- FFmpeg / FFprobe: 호스트 미디어 기능으로 탐색·프레임 추출·렌더 합성·동기화를 검증한다.
- Flova(선택 확장): 새 작품·연습 샷에 분석을 활용할 때 호출한다. 이번 원본 분석·블록아웃 비교는 위 도구로 수행한다.
Blender 실행 방식
CLI 또는 커뮤니티 MCP for Blender를 환경·작업에 맞게 고른다. MCP 전에 CLI 실패를 요구하지 않는다.
- CLI: GUI 없이 Python·배치 렌더를 실행한다. 단계마다 체크포인트를 명시적으로 불러와 수정·저장한다.
- 커뮤니티 MCP: 실행 환경에 Blender를 설치·실행하고 애드온을 켠 뒤 MCP로 연결한다. 보통 사용자 컴퓨터이며 Agent가 연결·프로젝트에 접근해야 한다. MCP 서버 설치만으로 Blender가 갖춰지지 않는다. 현재 애드온은 GUI 이벤트 루프가 필요해
blender -b를 지원하지 않는다. 연결법은 저장소 최신 설명을 확인한다. - 연속 검사: MCP 장면 읽기·Python 실행으로 다각도·와이어프레임·프레임 스트립을 얻어 카메라 후보·가림·인물 위치를 비교한다. 실행 피드백이 공간 증거·카메라 추론을 대신하지 않는다. 수정마다
.blend체크포인트를 저장한다. - 실패 처리:
isError뿐 아니라 응답 본문의 오류·실제 상태를 검사한다. 시간 초과 시 장면·출력 갱신부터 확인해 재시도를 결정한다. 프로세스 종료 시 Blender·저장 프로젝트를 복구 후 재연결한다.
분석 지식
연속 화면·소리의 변화가 관객 주의를 조직하는 방식을 현재 구간의 증거로 판단한다. 아래 개념에 특정 영화의 결론을 미리 대입하지 않는다.
전체 감상·정밀 관찰·증거
지정 범위를 통째로 봐 전개·주요 행동·정보 변화·소리/화면 관계를 파악한 뒤 컷·사건으로 세부를 찾는다. 정지 프레임은 구도용, 움직임·전환·초점·소리는 연속 영상으로 판단한다. 핵심의 시작·끝·멈춤·변화 프레임을 보완하고 속도·불확실성에 맞춰 밀도를 조절한다.
시간별 샷·핵심 요소 목록을 만든다. 인물·장소·소품·고정물 ID를 샷 간 유지하고 변화는 샷·이벤트에 쓴다. 참고 프레임에는 실제 파일·재생 위치를 붙인다. 보임·정체 확인·파일 추출은 다른 상태다. 불명확·미검사 부분의 한계를 명시한다.
카메라 움직임: 누가 움직이는지부터 판단
고정 배경·피사체 크기·가림·원근을 비교해 인물 이동, 카메라 수평/수직 이동·팬·줌·재구도·컷을 구별한다.
- 인물이 움직여도 배경 기준물이 안정적이면 카메라 이동 근거가 아니다.
- 팬은 보는 방향, 이동 촬영은 관찰 위치를 바꾸며 전후경 상대 이동·가림 변화를 동반한다. 짐벌·트랙·핸드헬드 장비 판단은 별도 증거가 필요하다.
- 전진·줌 모두 피사체가 커질 수 있다. 시차·원근·가림을 검사하며 구도가 좁아졌다는 이유만으로 전진이라 하지 않는다. 디지털 크롭도 구도를 바꾼다.
- 시작/끝·시점·추적 대상·멈춤을 기록한다. 고정 샷도 유효하며 운동을 억지로 만들지 않는다.
카메라가 대상을 선행 발견·추적하는가, 인물 퇴장 후 조정하는가? 관객의 정보 획득·상실 시점도 본다.
앵글·샷 크기: 시선 관계
정면·측면·후면과 눈높이 기준 수평·하이·로 앵글을 분리한다. 높은 카메라가 곧 하이 앵글은 아니며 앉은 자세·지형·광축도 고려한다.
샷 크기·인물 위치·시선·전경 가림·화면 밖 공간을 설명한다. 오버숄더·투샷·리액션은 이웃 샷으로 양쪽 위치·축선을 확인한다. “로 앵글=권력”, “클로즈업=긴장”을 공식화하지 않는다. 연기·길이·소리·전후 샷에 따라 기능이 달라진다.
초점거리: 포맷과 촬영 거리
화면 범위는 초점거리·유효 센서·크롭, 인물 크기는 거리에도 좌우된다. 원근은 주로 관찰 위치로 결정되므로 “망원 압축”만으로 설명하지 않는다.
시야·피사체/배경 비율·가림을 보고 후보 초점거리·촬영 거리를 제안한다. 블록아웃 mm는 피팅값이므로 sensorWidth·크롭/포맷 가정을 병기한다. 근거 없으면 후보 범위·시야·미상으로 두고 실제 장비값으로 쓰지 않는다.
심도·조리개·초점: 현상과 원인 구분
선명/흐린 면, 초점 이동 여부·행동/대사와의 시점을 쓴다. 흐림은 모션 블러·가림·후처리일 수도 있어 곧바로 초점 이탈로 단정하지 않는다.
- 심도는 조리개·초점거리·초점 거리·관찰 기준·유효 센서에 좌우된다. 얕은 심도만으로 f 값을 확정하지 않는다.
- 신뢰할 현장 자료·메타데이터가 없으면 조리개는 미상, 시연 f 값은 시연값으로 표시한다.
- 초점 대상 식별이 실제 초점 거리 확인은 아니다. 각각 근거를 기록한다.
- 전경→후경 초점 이동은 주의 순서를 바꾼다. 정지 인물에 초점을 두고 이동 전경이 가릴 수도 있다. 연속 영상이 지지할 때만 랙 포커스로 기록한다.
- “초점 대상” 표시는 원본 심도 재현을 뜻하지 않는다. 심도 시연은 광학값을 별도 설정해 원본과 비교한다.
대사·소리: 화자와 화면 대상
대화·호명·응답·멈춤·컷에 영향을 주는 소리를 시간 구간으로 기록한다. 화자·화면 안/밖·텍스트·언어·식별 근거를 분리한다. 전사·자막과 실제 청취 검증 상태도 구분하며 미검사 소리를 “대사 없음”이라 하지 않는다.
대사가 컷에 선행·연속하는지, 화면이 청자·언급 인물·행동 중 어디에 머무는지 비교한다. 리액션은 이 관계로 해석하고 대사 요약에 그치지 않는다. 화자 미상은 유지하며 편집 위치만으로 정하지 않는다.
공간 연출: 인물·카메라·대상의 변화
고정물로 공유 공간을 세워 인물 위치·방향·시선·경로·거리·가림을 기록한다. 고정 간격 자동 동작 대신 사건별 상태 변화를 쓰고 보이는/화면 밖 추정 경로를 구분한다.
세계 이동과 화면 운동을 구별한다. 화면 오른쪽이 현장의 고정 오른쪽은 아니다. 리버스 샷·팬·선회가 방향을 바꾸므로 공유 좌표를 세운 뒤 3D에 매핑한다.
대사가 가리킴·고개 돌림·접근·퇴장을 유발하고 카메라 앵글/샷 크기가 반응하는지, 초점이 화자·청자·지목 대상 어디에 놓이는지 본다. 3D는 공간 해석 검증용이며 불가시 동선을 발명하지 않는다.
움직임 복원: 전 구간 보정
인물·카메라 운동이 핵심이다. 인물 애니메이션은 공간 동선 설명용으로 이동·멈춤·전환·카메라 관계를 우선한다. 외형·포장 전에 운동부터 보정한다. 시작·끝의 일치는 두 시점만 설명할 뿐 중간의 정확성을 증명하지 않는다.
- 인물/카메라 별도 판단. 고정 배경의 시차·원근·가림으로 카메라를 제약한 뒤 같은 공간의 인물 위치·방향·자세를 확인한다. 팬/틸트는 광축, 이동 촬영은 관찰 위치를 바꾸며 줌·크롭은 별도다. 오차 상쇄용 동시 임의 이동이나 화면 이동만의 세계 경로 피팅은 금지한다. 추적점은 인물·카메라·추적 오류의 투영 단서이며 머리 추적 떨림을 몸통·관절 애니메이션으로 바꾸지 않는다.
- 샷별 초기 상태 확인. 같은 후보 그룹에도 위치·앵글·초점거리·구도 변형이 있다. 대표 자세를 그대로 쓰지 말고 각 샷을 확인해 시작부터의 이탈을 막는다.
- 실제 변화로 노드 구성. 출발·가감속·멈춤·회전·가림·재등장·끝의 구도·인물 상태를 기록한다. 중간 프레임이 등속 직선을 지지할 때만 단일 선형 보간한다. 전환·리듬 변화는 노드·곡선을 추가하고 회전 방향·각도 경계를 확인해 근거 없는 회전·점프를 막는다.
- 인물 상태 분리. 발밑 위치·몸 방향·머리/시선·서기/앉기/숙이기를 나누고 소품 회피·가림 순서·전환 시점을 검사한다. 대역은 통째로 이동해도 되며 보행은 필수가 아니다. 보행 복원 시 발 디딤·미끄러짐을 확인한다. 상태 기록이 각각의 애니메이션을 요구하지 않는다. 키 조절 등 자세 대리는 시연으로 표시하며 동작 복원 완료로 세지 않는다.
- 미상 구간 유지. 화면 밖·가림 경로는 여러 설명이 가능하다. 양 끝만 알면 끝점·후보 연결만 기록하고 보간 중간을 사실로 쓰지 않는다. 카메라 이동·줌·초점 이동을 구별 못하면 후보·근거를 남겨 확인 가능한 변화부터 보정한다. 추적 실패·가림·저텍스처의 데이터 공백을 카메라/인물 정지로 채우지 않는다.
- 현장/설명 시점 분리. 조감 선회·팬·줌은 모델 관찰용이다. 원본 운동은 후보 카메라 데이터로 읽으며 설명 시점 애니메이션이 원본 보정을 대신하지 않는다.
운동 샷은 시작·중간·끝·주요 변화를 원본 동시간의 렌더/재투영으로 검사한다. 배경·인물 화면 위치/크기/방향·가림·출발/멈춤 리듬을 비교하고 동시 이동 시 상대 운동도 본다. 다른 샷·피팅 외 시점으로 재검증한다. 잔차 감소만으로 운동·공간의 독립 검증은 아니다. 중심뿐 아니라 크기·전후 가림, 카메라의 벽/가구 침범, 이동 중 인물 크기·신체 비율 안정성도 확인한다.
다섯 관계를 하나의 판단으로 연결
샷마다 카메라 움직임·앵글·심도/초점·대사·공간 연출을 관찰한 뒤 연결한다. 언제 누구의 소리·행동이 관찰 대상을 바꾸고, 카메라·초점은 어떻게 반응하며, 이웃 샷은 무엇을 보충하는가?
샷 내부·컷 전환 모두 관계를 만든다. 연속 증거가 없으면 가능성·판단 불가로 남기고 의도를 사실로 단정하지 않는다. 전 구간의 반복·변화·예외도 확인한다.
샷 간 관계·편집·전체 판단
인접 샷의 행동 단계·시선·인물 위치·소품 상태·화면 방향·소리를 비교한다. 컷의 주의 대상, 행동 생략·기다림 연장·반응 삽입과 직접 컷·가림·디졸브 등 보이는 전환을 기록한다. 롱테이크 상태 변화는 별도 이벤트다.
반복 피사체·장소·시점·구도의 그룹 근거와 공통점·변형·교대 순서를 쓴다. 외형 유사성은 연관 가설이지 같은 카메라·연속 촬영의 증명이 아니다. 인물·장소·소품 일관성도 매번 확인한다.
전체 결론은 샷 길이·반복·멈춤·전환·소리 관계로 뒷받침한다. 필요한 음악·효과음·색·자막 분석에 측정·관찰 근거를 붙인다. 재사용할 관계와 재설계 조건은 원본 사실과 구분해 제안한다.
데이터의 근거
- 직접 화면 관찰: 시간·키프레임·연속 영상 범위를 첨부한다.
- 청취·전사·자막: 출처와 수동 검증 여부를 적는다.
- 자료로 확인: 추적 가능한 출처와 해당 촬영 버전을 붙인다.
- 추론: 지지 단서와 다른 설명 가능성을 쓴다.
- 모델·시연 매개변수: 피팅 조건과 용도를 설명한다.
- 미상: null 또는 명시적 텍스트를 쓰며 모델 기본값으로 채우지 않는다.
근거는 데이터·상세에 보존하고 주 페이지는 영화 정보를 우선해 장문을 반복하지 않는다.
작업 흐름
0. 실행 환경과 최소 작업 검증
대량 분할·모델링·렌더 전에 실제 Blender 실행 환경을 검증한다. 호스트의 사용자 앱·파일 접근을 가정하지 않는다. 스크립트·명령·버전·종료 코드·로그는 프로젝트에 저장한다.
-
대로 진입점·버전·FFmpeg / FFprobe를 확인한다. CLI는
--version, PATH에 없으면 macOS/Applications/Blender.app/Contents/MacOS/Blender등 일반 경로를 검사한다. MCP는 애드온 연결·GUI·읽을 장면을 확인한다. 로컬 명령이 없어도 검증된 MCP는 유효하다. 도구·진입점 부족은 명시하고 아래 부분 전달 규칙을 따른다. -
별도 최소 테스트 폴더에
scripts/00_preflight.py를 쓴다. 기본 도형·카메라·저해상도 장면으로.blend저장→재읽기→예상 객체 접근→PNG 한 장 렌더를 수행한다. CLI/MCP의 동일 작업을 정식 현장과 분리한다. 아래<BLENDER>는 실제 실행 경로로 바꾼다."<BLENDER>" --background --factory-startup --disable-autoexec --python-exit-code 1 --python scripts/00_preflight.py -
시작·단일 프레임에 유한한 제한 시간(예: 30초·120초, 환경별 조정)을 둔다. CLI 종료 코드·MCP 응답 본문, 스크립트 완료 표시·비어 있지 않은
.blend·디코딩 가능한 렌더를 확인하고 이미지를 연다. 버전 출력·빈 파일·호출 성공만으로는 불충분하다. -
통과 후 정식 실행하고 재현 스크립트를 보존한다. CLI는 이전 프로젝트를 로드하고 MCP는 같은 장면을 연속 조정한다. 객체 이름으로 상태를 찾고 체크포인트 저장·복구한다. 백그라운드는 UI 의존을 피하며 렌더러 오류는 로그로 호환 설정을 골라 한 프레임부터 검증한다.
막힘과 진전 없는 재시도
- 실패마다 단계·명령/인수·종료 코드·시간 초과/오류·생성 파일·다음 수정 이유를 기록한다. 재시도는 명확한 수정·가설을 검증해야 하며 그대로 반복하지 않는다.
- 같은 막힘에서 연속 두 번 새 증거·산출물 진전이 없으면 중단한다. 명령·진입점 변경이나 “계속 처리”는 진전이 아니다. 같은 오류에 의존하지 않는, 적용이 확인된 대안만 최소 검증 후 계속한다.
- 대안이 없으면 샷 목록·카메라 스케치·부분 블록아웃을 저장해 “부분 완료”로 전달하고 원래 오류·시도·복구 조건을 명시한다. 미생성 영상·
.blend는 미완료로 남긴다. 원본·키프레임·도식으로 대체해 완료라 하거나 실행 종료 후 자동 계속을 약속하지 않는다.
1. 자료와 분석 범위 확인
실제 영상을 확보해 지정 구간·초점을 따른다. 원본 파일/링크·버전·확보 시각·분석 구간을 기록한다. 원본은 보존하고 추출·크롭·트랜스코딩은 사본으로 한다. 플랫폼 대상·버전 확인 후 승인된 다운로드·미디어 읽기로 파일을 얻는다. 접근 제한을 알리고 표지·소개로 내용을 대체하지 않는다. 관찰 도구 실패로 기존 파일을 재다운로드하지 않는다.
미디어 도구로 재생·길이·해상도·비율·프레임레이트/타임스탬프·오디오를 확인하고 원본/구간 시간을 매핑한다. 화면·소리·자막별 검사 범위를 기록한다. 저화질·오디오 없음·미검증 세부는 미상이다. 설명 이미지만 있으면 방법·가설만 정리하며 원본 샷별 분석 완료라 하지 않는다.
여러 방향과 반복되는 문·창·고정 소품이 있는 연속 장면을 우선한다. 긴 구간은 상보적 공간 정보가 있는 일부에서 검증 후 요청 전체로 확장한다. 첫 기술 시험은 30–60초·약 5–10샷을 참고하되 작품 제한으로 삼지 않는다.
2. 샷 분할 후 후보 카메라 그룹 구성
지정 범위를 연속 감상해 전개·전환·끝·소리/화면 관계를 파악하고 정밀 관찰한다. 콘택트 시트·추출 프레임은 탐색용, 행동·운동·전환은 실제 영상으로 검증한다. 소리·자막별로 청취 불가·전사만 있는 경우까지 검증 범위를 기록한다. 세부는 을 따른다.
실제 컷으로 샷을 나눠 고정 ID·시작/끝·길이·제목·대표 프레임을 기록한다. 섬광·빠른 움직임·가림의 오분할을 검사한다. 연속 샷의 위치·구도·초점·배치는 이벤트, 여러 샷의 서사 구간은 독립 ID로 구분하며 샷 수는 실제 컷으로 센다.
키프레임은 전체 화면이나 재생 가능한 원본 시간으로 남긴다. 운동의 시작·끝·주요 변화, 행동의 시작·발전·유지·끝을 보며 속도·불확실성별 밀도를 조절한다. 전편 고정 추출 간격을 강제하지 않고 미확보 이미지를 저장·삽입된 증거라 하지 않는다.
샷별 다섯 분석·관계 판단은 위 방법대로 수행한다. 특히 인물/카메라/줌/컷과 화자/청자/화면 밖 소리, 시선·가림·행동 연결을 교차 검사한다. 고정 샷에 운동을 강요하거나 기법·감정을 고정 대응시키지 않는다.
고개 돌림·이동·가리킴·카메라 운동 시작/끝·초점 이동·호명·응답의 실제 변화에 원본 시간 이벤트를 만들고 설명·인물·카메라를 함께 구동한다. 고정 간격으로 행동을 만들지 않는다.
운동 구간은 원본 시간·배경 기준·인물 위치/방향/자세·후보 카메라 위치/광축·시야·근거/미상의 노드를 저장한다. 먼저 관찰 후 위 “움직임 복원”대로 노드·애니메이션을 맞춘다. 한 문장 카메라 운동 설명에서 전체 경로를 생성하지 않는다.
인물·장소·소품·고정물에 재등장해도 같은 ID를 쓰고 샷과 양방향 연결한다. 외형·행동·위치·소품 변화는 시간별로 기록한다. 관련 특징만 남기며 불명확한 정체·브랜드·가려진 구조는 미상이다. 요소 식별과 사용 가능 자료 확보를 구별한다.
샷 S01·후보 그룹 C01처럼 ID를 분리하고 그룹별 근거 프레임·고정물·방향·시야를 기록한다. 쇼트·리버스 쇼트, 샷 크기·반복 구도·교대의 근거·유지·변화를 비교한다. 유사 배경의 가설을 원근·가림·운동으로 검증한다. 설정은 이동·줌 가능하며 그룹 수는 실제 카메라 수가 아니다.
핵심 촬영법·변화를 요약하고 길이·전환 순서·반응·멈춤·소리 연결로 재검사한다. 관련 빛·색·자막·음악·효과음만 확장하며 측정 없는 정밀 BPM·장비·소프트웨어값은 쓰지 않는다. 후속 촬영·각색은 별도 제안이다.
3. 공간·스케일 가설 설정
문·창·벽 모서리·무대·가구로 평면을 그려 인물 구역·핵심 소품을 표시한다. 상대 위치·비율부터 잡고 근거 있는 치수·키로 스케일을 정한다. 추정치는 가정을 밝힌다.
여러 시점으로 카메라 방향·높이·시야를 제약한다. 초점거리는 센서·거리·크롭에 좌우되므로 근거 없으면 시야·후보 범위로 남긴다. 인물 위치·방향·이동은 보이는 부분만, 화면 밖 연결은 추정으로 쓴다.
초점거리·조리개·초점을 분리한다. 초점거리에 유효 포맷·크롭·모델 조건을, 초점에 대상·거리를 기록한다. 심도는 선명한 면·변화부터 설명하며 흐린 배경에서 조리개를, 대상에서 실제 거리를 역산하지 않는다. 미상은 비우고 모델값은 추정, 촬영 자료는 출처를 붙인다.
4. Blender에 공유 현장 구축 및 재투영
기본 도형으로 공유 공간·식별 가능 인물·소품·후보 카메라를 만들고 고정 ID로 샷을 카메라·시간에 매핑한다. 공간·카메라·동선 우선, 외형은 나중이다.
다른 방향의 대표 샷에 후보 카메라로 와이어프레임을 재투영해 문·창 경계·원근·가림·비율을 확인한다. 같은 카메라의 블록아웃과 원본을 병렬 비교한다. 수정 후 다른 시점을 재검사하고 최소 한 차례 문제·수정·결과를 남긴다.
운동 샷은 시작·중간·끝·회전·멈춤·가림을 동시간 비교한다. 카메라 방향·위치·시야·인물 상태를 항목별 수정하며 중간 배경·피사체 크기·가림도 맞춰야 한다. 대표 프레임 하나로 운동 보정 통과는 불가하다.
일치는 화면 설명의 가능성이지 실제 촬영값의 증명이 아니다. 불일치 시 공간·카메라 운동·왜곡·후처리 크롭·세트 변화를 검사한다. 필요하면 복수 가설을 남기며 샷별 양립 불가 공간을 만들지 않는다.
5. 인물 동선과 조명 도식 추가
인물은 크기·신체 비율이 고정된 간소화 대역이다. 시간별 발밑 위치·경로·출발/멈춤·몸 방향을 설정하고 이동 중 형태를 유지한다. 팔 흔들기·끄덕임·몸 흔들림 등 연기나 외모·의상 복제는 기본 요구가 아니다. 서기·앉기·웅크리기·일어서기는 구도·가림·시선 높이에 필요할 때만 소수 프리셋으로 표현한다. 고개 돌림·가리킴·손 뻗기도 시선·가림·구도·카메라 반응에 영향을 줄 때만 연속 영상에 근거해 추가한다. 불가시 행동은 미상·가정이다.
관찰 노드로 동선·회전·자세를 제약해 구간별 경로·속도를 검증한다. 인물·소품·카메라는 좌표·시간을 공유한다. 샷 간 상태를 재검사하되 편집의 시간 생략을 남기고 억지로 연결하지 않는다. 템플릿의 선형 이동·높이 대리 표현이 부족하면 확장하거나 범위를 명시하며 부정확한 운동으로 채우지 않는다.
보이는 광원·그림자·명암·윤곽으로 조명을 추정하고 필요 시 조명·창빛·차광·배경 도식을 넣는다. 실제 보이는 등기구·추정 효과·시연 객체를 구분한다. 모델 조명 수는 현장 대수가 아니며 출력·색온도는 근거 없으면 비운다.
6. 인터랙티브 페이지와 동기화 영상 제작
이 단계에서 를 사용한다. 샷·후보 카메라·인물 위치/운동·대사를 validate_analysis.py 형식 JSON으로 정리한다. 분석 시작이 0초인 MP4·샷별 대표 프레임·선택적 동일 시점 비교 이미지를 준비한다. 템플릿 예시 대신 실제 관찰 데이터를 쓴다.
압축 해제 루트에서 현재 프로젝트 경로로 실행한다. 비교 이미지가 없으면 --models를 생략하고 esbuild가 PATH에 없으면 --esbuild를 전달한다.
python3 scripts/validate_analysis.py <analysis.json>
python3 scripts/build_report.py --data <analysis.json> --video <clip.mp4> --frames <frames-directory> --models <model-images-directory> --output <report.html>
HTML에서 원본·샷 정보·현장·목록·대사를 확인하고 “영상 내보내기”를 실행한다. MP4가 필요하나 WebM만 나오면 FFmpeg로 변환·검증한다. 페이지·버튼만으로 영상 완료가 아니다.
에 따라 같은 데이터·재생 시간으로 5개 영역을 동시에 표시한다.
- 원본: 정확한 화면 비율·오디오, 타임코드·현재 샷·샷 타임라인.
- 현재 샷 정보: 샷 크기·카메라 움직임·앵글·심도·초점거리·조리개·초점 대상·대사·공간 연출과 관계 판단 하나.
- 동적 촬영 현장: 같은 공간의 인물·현재 카메라·시야 프러스텀·경로를 이벤트에 동기화. 조감 3D·평면·카메라 시점 제공.
- 샷 목록: 대표 프레임·ID·시간·카메라. 클릭 탐색·재생 추적.
- 인물 대사: 화자·시간·대사·필요한 원문. 클릭 탐색·재생 추적하며 미확인 내용은 검증 대기.
관람과 무관한 과정 설명은 주 페이지에서 빼고 독립된 “설정 그룹” 주 영역을 만들지 않는다. 증거·전체 분석·모델 조건은 상세·데이터에 둔다. 후보 카메라 그룹은 3D 현장의 보조 색인이며 영화 분석을 대신하지 않는다.
같은 데이터·모델·시간 매핑으로 9:16 영상을 세로 재배치한다. 기본 1080×1920, 선택 720×1280, 원본 소리·검증 자막 보존. 실제 컨테이너·해상도·녹화 제한을 명시하고 영상을 생성·검증한다. 버튼만으로 완료가 아니다.
은 로컬 assets/report·scripts에 대응한다. 자료 계약을 확인하며 기본 데이터·시연 조명을 분석으로 취급하지 않는다. 파일 없이 문서만 있으면 본문 구조·입력 계약·완료 기준으로 구현·검증하고 템플릿 로드를 주장하지 않는다. 수량·매개변수는 현재 자료에서 얻고 사례를 베끼지 않는다.
7. 검사·수정·전달
패키지 생성 HTML·실제 영상을 아래대로 검사한다. 같은 데이터·시간 매핑의 HTML·JSON·영상·프로젝트를 전달하며 템플릿·내보내기 진입점만 전달하지 않는다.
HTML 재생·샷 이동·타임라인·대사 탐색·시점·미상 표시를 확인한다. 실제 영상을 끝까지 봐 컷·카메라 강조/운동·인물·대사·초점 이벤트 동기화와 소리·비율·글자 가독성을 검사한다. FFprobe로 길이·해상도·컨테이너·오디오/비디오 트랙을 확인한다. 페이지·영상은 같은 결론이어야 한다. 같은 공간을 상보적인 최소 세 시점으로 기준물·원근·가림 검사하며 자료 부족 시 검사 범위를 밝힌다.
운동은 원본 시간별 인물 위치·방향·자세·카메라 구도·가림 순서·리듬을 별도 검수하고 시점·수정을 남긴다. 시작/끝만 맞고 중간 이탈·관통·상대 운동 오류가 있으면 미보정으로 표시해 수정하거나 부분 완료로 둔다. 재생·경로 이동만으로 검수 통과가 아니다.
저장 Blender를 다시 열어 객체 편집·의존 파일·대표 샷 재렌더를 확인한다. HTML·실제 영상·구조화 데이터·키프레임·편집 프로젝트·비교 이미지·짧은 설명과 실제 모델링/빌드/합성 스크립트를 전달한다.
설명에 관찰·주요 가정·미상·수정 기록을 넣는다. 영상·도구·공간 증거 부족 시 완료된 목록·스케치·부분 블록아웃과 부족 항목을 명시한다. 3D 도식만으로 동기화 시연 완료라 하지 않는다.
데이터·페이지·내보내기 계약
정보 구조
원본 초 단위로 분석하며 구간은 0부터 시작한다: 源片时间 = source.start + video.currentTime. 컷은 [start,end)·고정 ID, 가변 프레임레이트는 실제 타임스탬프로 찾고 명목값으로 역산하지 않는다. 모델은 독립 set.fps·구간 시작 프레임 0을 쓰며 원본 고정 프레임레이트를 뜻하지 않는다.
샷별 저장 항목:
대사는 화자·시작/끝·원문·번역·화면 안/밖·검증 상태·연결 샷을 별도 저장하고 컷을 넘어갈 수 있다. 화자 미상을 강제 지정하지 않는다. 카메라 그룹은 ID·연결 샷으로 재사용하며 실제 대수가 아니다. 설정 그룹은 내부 데이터로만 두고 주 영역을 만들지 않는다.
출처·실제 버전·확보 시각·읽은 범위를 보존한다. 인물·소품·장소·고정물 목록에 ID·특징·참고 프레임·연결 샷·상태 변화·자료 확보 여부를 둔다. 샷과 양방향 연결한다. 그룹에 근거·유지/변화·등장 순서, 전체 해석에 시간을 붙인다. 데이터·상세로 두고 주 영역은 늘리지 않는다.
초점거리·조리개·초점 거리 미상은 null. 보이는 선명한 대상과 모델 초점 거리를 구분하며 렌더러 기본 조리개·조명·카메라값을 원본 정보로 채우지 않는다.
주 페이지
5개 영역은 병렬, 작은 화면은 순차 배치한다. 주 카드에는 짧은 관찰·관계 판단 하나, 클릭 시 상세를 펼친다. 무근거값은 미상, 필요한 “추정”은 표시하며 과정 설명이 영화 정보를 밀어내지 않게 한다.
원본·타임라인·카드·카메라 강조·인물·이벤트·대사는 같은 시간이다. 샷/대사 클릭 탐색·목록 재생 추적을 지원한다. 3D 전체·평면·카메라는 같은 장면이며 설명 회전은 후보를 바꾸지 않는다. 미모델링 샷은 원본·분석만 두고 카메라를 지어내지 않는다. 비교 이미지 없으면 비교를 비활성화한다.
영상
동일 데이터·모델·시간으로 위 9:16 규격을 출력한다. 세로 재배치하되 원본 비율·오디오·검증 자막을 보존하고 현재 샷·현장·색인을 동기화한다. 긴 샷 목록은 현재 주변만 표시해 썸네일이 캔버스 밖으로 밀리지 않게 한다.
네이티브 녹화는 실시간이므로 페이지를 보이게 유지한다. 코덱에 따라 MP4 우선, 불가 시 WebM을 명시한다. MP4 필요 시 FFmpeg로 변환하며 확장자만 바꾸지 않는다. 장편·백그라운드 배치·정밀 고정 프레임레이트는 프레임별 렌더+FFmpeg 합성 후 별도 검증한다.
완료 기준
- 데이터가 요청 범위를 덮고 컷이 실제 화면과 일치하며 이벤트 시간이 해당 샷 안에 있음.
- 페이지 재생·탐색·시점 전환이 작동하며 미상 매개변수·미모델링 샷을 정확히 표시함.
- 실제 영상을 내보내 끝까지 보고 소리·화면·대사·비율·글자·현장 상태를 확인함.
- 저장 프로젝트를 다시 열어 렌더하며 원본/모델 비교에 대응 카메라·시간을 사용함.
- 움직임은 시작·중간·끝·주요 변화의 동시간 비교를 통과함. 인물·카메라 경로·방향·가림·리듬을 각각 검증하고 미보정 구간을 명시함.
- 완료 항목·미검증 소리·모델 가정·미상 값을 구분함. 데이터 검사 통과는 영화 판단의 정확성을 증명하지 않으며 HTML 생성이 영상·Blender 검수를 대신하지 않음.
페이지·내보내기 템플릿 사용법
5개 영역 구현 리소스이며 방법은 을 따른다. 특정 영화 분석·미디어·Blender 프로젝트는 없다.
파일과 실행
assets/report/workbench.html,.css,.js: 페이지.assets/report/set3d.js,plan2d.js,data-view.js: 공유 현장·데이터 표시.assets/report/video-export.js: 세로 네이티브 녹화.assets/report/vendor: 동봉 Three.js·라이선스. 배포 시 보존하며 시스템 폰트를 사용하고 폰트 파일은 추가하지 않는다.scripts/validate_analysis.py: 시간 범위·ID·매핑·필드·애니메이션 구간 검사. 영화 분석의 정확성을 판단하지 않는다.scripts/build_report.py: 검증·단일 HTML 패키징. Python 3·FFprobe·esbuild가 필요하며 자동 설치하지 않는다. 로컬 검증 버전은 esbuild 0.25.12로 실행 파일을 명시할 수 있다.
분석 JSON·원본 오디오가 있는 구간 MP4·샷별 {id}.jpg를 준비한다. 동일 시점 렌더는 models 폴더에 둔다. MP4 0초는 source.start이며 회전·픽셀 종횡비를 정규화한다. 아래 경로는 작업별로 바꾼다.
python3 scripts/validate_analysis.py /path/to/analysis.json
python3 scripts/build_report.py \
--data /path/to/analysis.json \
--video /path/to/clip.mp4 \
--frames /path/to/frames \
--models /path/to/models \
--esbuild /path/to/esbuild \
--output /path/to/report.html
--models는 생략 가능하다. 빌드는 크기·길이·오디오를 확인해 영상·이미지·스타일·스크립트를 내장하고 시스템 폰트를 쓴다. 파일 크기를 고려해 길이별 미디어 품질을 고른다. 대상 호스트 호환성을 실측한다. 로컬 HTTP는 검증됐으며 파일 직접 열기는 별도 검증한다.
입력 계약
아래 필드는 확장 가능하나 기본 문구로 현재 관찰을 대체하지 않는다.
세계 좌표 Z는 위, yaw=0은 +Y, 양의 회전은 +X 방향, pitch 양수는 위이다. pose의 렌즈값은 모델값이며 화면 촬영 매개변수는 photography에서 별도로 읽는다. 차이는 분석 데이터로 설명해야 한다. basis는 confirmed/model/infer/demo/unknown이며 자료 확인은 출처, 모델·시연값은 조건을 붙인다. 초점 거리는 미터 단위로 모델 스케일과 일치한다.
적용 범위
현재 지원: 단일 장면 블록아웃·인물 선형 이동·카메라 이동/회전/조준점. 기하·랙 포커스·조리개 변화·복잡한 연기·실제 조명을 자동 복원하지 않는다. 이벤트로 기록할 수 있으나 모델 시연은 애니메이션·렌더 확장과 보정이 필요하다. 기본 조명은 공간 가독성용이다.
여러 장면은 보고서를 나누거나 장면별 모델·카메라 로딩을 확장한다. 다른 장면에 같은 공간을 써서 복원 완료라 하지 않는다.
MP4 우선이나 브라우저에 따라 WebM이 된다. 녹화 중 페이지를 보이게 유지하고 완료 알림만 믿지 말고 실제 다운로드·검사한다. 정적 프레임 캐시·썸네일 창은 제한되어도 장편은 메모리·실시간 렌더·소리 동기화를 실측한다.


