Files
ShortVideoGenerator/tools/blender/AGENTS.md
T

10 lines
1.5 KiB
Markdown

# Blender 실행기 작업 기준
이 폴더는 기존 Blender·FFmpeg 실행파일로 저장소 안의 원본과 요청을 검사하고 PNG·무음 MP4를 렌더한다. 주제별 모델 생성은 담당 제작물에서 작성한다. `bpy`는 Blender 내부에서만 사용하고 Python·conda·Blender 전역 설정을 변경하지 않는다.
`run.py`는 승인·현재 포인터·선행 버전·시간·실제 파일을 검사한다. `inside.py`는 원본을 실제 열고 Scene·카메라·객체·외부 의존성과 지원 설정을 확인한다. 논리 프레임에 1을 더해 Blender 프레임으로 평가하고 영상 범위는 `[start,end)`다. 다른 Scene의 같은 논리 프레임을 하나의 화면으로 취급하지 않는다.
08 대표 렌더와 승인 후 정식 10–12 렌더를 분리한다. project.json·artifact.json·사용자 승인 기록은 변경하지 않는다. source 검사 결과와 요청된 PNG/MP4의 실제 결과도 분리한다. 기계 검사는 화면 품질·전체 재생·청취를 대체하지 않는다.
결과는 새 시도 폴더에만 쓴다. 캐시를 재사용하거나 실패 파일을 삭제하지 않는다. .blend 해시·프로필·Scene·논리 프레임·실행 스크립트 해시를 시도 식별에 포함한다. 변경 후 `test_runner.py`, `contracts/check.py`와 해당 경로의 실제 `smoke.py`를 실행하고 명령·종료코드·한계를 보고한다. 테스트 결과와 .cache는 소스 커밋에 포함하지 않는다.