Film build
시작하기
sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<film> # 비어 있지 않은 폴더는 거부합니다
cd marketing/videos/<film> && npm i && npx playwright install chromium # NEXT 메시지가 뜨면 실행
키트가 제공하는 파일:
| 파일 | 설명 |
|---|---|
film/core.js | 엔진: scene({name, from, to, build, run, after}) (시간 단위: 비트 = 초 × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start() |
film/film.js | 아래 모든 헬퍼와 4개의 예제 샷(라인, 프롬프트, 분할, 페르소나 카드)이 포함된 스타터. 각 헬퍼의 주석에는 어떤 리젝션에서 비롯되었는지 표시됩니다. 샷은 교체하고 헬퍼는 유지하세요. |
film/mock.js | window.MOCK: 실제 UI 조각(대시보드, 창, 전화기 화면)의 HTML, 화면 px 단위 |
film/index.html | assets/fonts/{display,ui}.woff2에서 글꼴 로드(로컬 산세리프 대체 포함) |
scripts/render.mjs | --sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all |
scripts/sync.mjs | timeline.json을 페이지로 복사 |
scripts/review.py | 렌더링된 MP4에서 비평 키트 생성: 접촉 시트, 가장 빠른 동작 스트립, 전화기 보기, 9:16 안전 영역, 메트릭 |
tools/probe.mjs | cuts (모든 컷과 각 샷의 중간점, 비디오 초 단위) 또는 임의 표현식 (예: "window.UNWARP(12.4)") |
tools/sheet.py | 스틸 이미지를 하나의 레이블이 있는 시트로 타일링 |
tools/pack_grid.py | 4×3 캐릭터 시트(투명 또는 흰색 배경)를 sprite()용 12셀 스트립으로 자름; 셀 크기 출력 |
tools/cut_cast.py | 한 줄로 정렬된 캐릭터들을 개별 스틸 이미지로 자름 |
assets/characters/ | 4개의 예제 캐릭터(창업자, 개발자, 판매자, 학생), 360px 셀 기준 12프레임 스트립 |
tools/same.sh | 변경 전/후 스틸 간 PSNR 회귀 저장/확인 |
스타터의 헬퍼 (재발명하지 말고 사용하세요)
io(5차 in-out) — 카메라 움직임과 모프용;oq(5차 out) — 등장용;back— 약간의 오버슈트용.cam(e, s, fx, fy)— 1920×1080 평면의 초점 (fx, fy)를 스케일 s로 프레임 중앙에 배치합니다.camD는 평면 가장자리를 넘지 않는 동일한 기능(커버 스케일, 9:16에서 필수).posIn(e, root)— 움직이는 평면 내 요소의 위치를 읽습니다(커서 대상, 캐럿 팔로우용).typed()— 단어가 한 줄에 문자 하나씩 나타나는 효과;keyed()— 실제 키보드 효과: 문자별 불규칙한 타이밍, 공백에서 더 긴 일시정지, 깜빡이는 캐럿.wordsHTML()— 모든 단어를 첫 프레임부터 최종 너비로 배치하고, 해당 시간까지 투명하게 유지하여 줄이 다시 흐르지 않도록 합니다("텍스트 전환이 전혀 부드럽지 않음" 문제 해결).cursor()/putCursor()/bump()— 미끄러지듯 움직이고, 일찍 도착하며, 클릭 시 15% 내려가는 실제 화살표 커서.pop()— 작은 아이템이 착지하는 효과.sprite(parent, src, cellW, cellH, h)/putSprite(e, t, a, z, loops)— 그려진 캐릭터: a에서 z까지 12프레임을 단계별로 진행하며, 약간의 호흡 효과로 절대 멈추지 않게 합니다.<img>이므로 엔진이 로드를 기다립니다.shot(name, t0, t1, build, run)—scene을 초 단위로 래핑합니다.- 하단의 페이싱 워프:
SLOW(전체 스트레치),EV홀드 (읽기를 위해 순간 정지) 및 삽입;window.CUTS와window.UNWARP는 사운드 및 보이스 배치를 위한 비디오 시간을 제공합니다. PT/pk(a16, a9)— 하나의 파일에서 포맷별 값을 선택합니다.
엔진 규칙 (결정론)
영화는 t의 순수 함수입니다. 어떤 프레임이든 첫 번째로 렌더링되든 다른 프레임 후에 렌더링되든 동일하게 그려져야 합니다.
- 2D 변환만 사용:
translate3d금지,will-change금지, CSS 전환 금지,Math.random금지 (인덱스의 해시 사용). - 시작 시 숨겨진 요소:
reg(el, {o: 0})사용, 절대 인라인opacity:0사용 금지. - 레이아웃 측정은
after()또는build에서 한 번만,run내부에서는 절대 금지 (이전 프레임을 읽음). - 3D 뷰: 매 프레임
insertBefore(v, firstChild)로 다시 삽입하여 캐시된 래스터가 남지 않도록 함. - 포함된 CSS 애니메이션 (예: 제품 위젯 자체): 일시정지하고
animation-delay: calc(-1s * var(--t))설정. - 이미지와 글꼴 로드 (
decode(),document.fonts.ready)를 첫 프레임 전에 대기. - 제품 CSS는 고유한 루트 클래스 아래로 범위 지정; 영화 내에서 고유한 클래스명 사용 (
.w가 한 번 누출됨). classList.add사용,className =사용 금지.node scripts/render.mjs --verify는 렌더링을 보내기 전에 12/12를 출력해야 합니다.
사실주의: 화면을 만들기 전에 references/realism.md를 읽으세요
간략 버전: 실제 앱을 실제 밀도로, 실제 브랜드 웹사이트의 실제 로고, 해당 OS에 존재하는 앱이 있는 OS 크롬, 실제 배경화면, 실제 런처 그리드의 실제 dp 크기의 전화기(제품 자체 렌더러로 그림), 생각보다 풍부해야 하는 제품 UI, 브랜드 마크 표시 시마다 귀속 사용 문구.
빌드 루프 (리뷰 주도)
- 승인된 스토리보드의 샷 목록을
film.js에 작성, 각각shot()사용, 핸드오프를 위해 오버랩. - 먼저 스틸.
node tools/probe.mjs cuts→ 모든 샷 중간점과 모든 핸드오프에서 스틸 렌더링:node scripts/render.mjs --at …후python3 tools/sheet.py review/stills/16x9 review/sheet.jpg <times>. 직접 시트를 읽으세요. 수정. 반복. (전체 렌더링 25분+ 대비 약 1-2분 소요.) - 보내기 전 QA: ≤ 1.5초 간격 및 모든 핸드오프에서 영화를 단계별로 확인 (각 전환에 대해 10-15fps 접촉 시트).
references/qa.md를 항목별로 확인: 오버랩, 클리핑, 빈 프레임, 읽기 시간, 텍스트 부드러움, 타이핑, 로고 표시, OS 사실주의, 전화기 크기. - 스틸 전송 (시트)을 소유자에게 첫 검토용으로 보냅니다. 대기.
- 드래프트:
node scripts/render.mjs --draft(30fps, ~4분),python3 scripts/review.py 1 --draft, 스트립 읽기. 드래프트 MP4 전송. 30fps 드래프트이며 블러가 없어(최종보다 거칠어 보임) 최종과 다르다고 명확히 표시. - "최종 렌더링" 시: 백그라운드에서
node scripts/render.mjs실행 (60fps, 모션 블러 포함; 60초 기준 약 25-35분). 렌더링 중에는film.js를 편집하지 마세요: 계속 작업해야 한다면 먼저 프로젝트를 복사하세요. - 승인된 각 라운드 후 필름 코드와 타임라인을 커밋.
페이싱
첫 컷은 거의 항상 너무 빠릅니다. 화면 텍스트는 단어당 약 0.3초 + 완전 불투명 상태에서 1초(최소 1.5초 미만 금지)가 필요합니다.
모든 샷의 타이밍을 다시 조정하는 대신 워프(SLOW 1.1–1.25, 라인에 EV 홀드)를 선호하세요. 페이스 변경 후에는
사운드와 보이스 위치가 변경되므로 probe.mjs cuts를 다시 실행하세요.
9:16: references/formats.md를 읽으세요
pk()를 사용하여 하나의 파일에서 동일한 영화를 재구성; tools/same.sh로 16:9가 변경되지 않았음을 증명 (모든 스틸 PSNR = inf);
--verify --fmt 9x16; 소유자용 스틸 시트; 그 후 백그라운드에서 --fmt 9x16 최종 렌더링, 이어서 --mux --fmt 9x16.