모션 그래픽
비디오는 모든 픽셀이 시간 t의 순수 함수인 하나의 HTML 페이지이며, 헤드리스 Chromium에서 프레임별로 렌더링되고 ffmpeg으로 인코딩됩니다. 기준은 시니어 모션 디자이너의 쇼릴(showreel)이며, 절대 슬라이드쇼가 아닙니다.
1. 포맷 선택
| 요청 | 읽기 |
|---|---|
| 실제 제품에 대한 론칭, 프로모션, 광고, 기능 릴, 앱 트레일러 | formats/launch-video.md |
| 쇼츠, 릴스, 틱톡, 세로형 설명 영상 또는 스토리 | formats/shorts.md |
포맷 파일을 따라 브리프, 콘텐츠 단계, 비트 구조를 확인하세요. 작성 후에는 다시 이곳으로 돌아와 빌드합니다. 또한 컴포지션을 작성하기 전에 references/pitfalls.md를 읽으세요.
매 실행마다 새로운 콘셉트. 각 비디오는 고유한 아이디어, 스크립트, 디자인을 가집니다. 사용자가 이전 작업을 참고하지 말라고 하면, 이전 비디오와 컴포지션은 워크스페이스에서 열지 않은 상태로 두세요.
2. 작업 폴더
사용자가 원하는 위치에 <slug>-<YYYYMMDD>/ 폴더를 만듭니다 (기본값: 현재 디렉토리):
brief.md 포맷의 브리프 테이블에서 가져온 매개변수
beats.md 비트 시트 (시간, 카피, 에셋, 움직임, 전환, 악센트 히트)
assets/ 캡처, 이미지, 폰트, 오디오
assets/manifest.md 에셋 파일당 한 줄: 출처, 라이선스 또는 "<표면>에서 캡처", 표시 내용
motion.html 컴포지션
motion.json {"size": [W, H], "fps": 60, "duration": 30, "stills": [비트 시간], "captions": []}
engine/ 이 스킬의 engine/ 디렉토리 복사
out/ 스틸, 렌더, 콘택트 시트
폴더당 한 번씩 엔진을 설정합니다:
cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. 컴포즈
motion.html은 engine/runtime.css와 engine/runtime.js를 로드하고, DOM을 구성하며, 장면을 등록한 후 MG.ready()를 호출합니다.
| 헬퍼 | 용도 |
|---|---|
MG.scene(start, end, fn, el) | fn(local, t, dur)는 start <= t < end 동안 실행됨; el은 범위 밖에서 숨겨짐. 모든 애니메이션 속성을 매 호출마다 설정. |
MG.always(fn) | 매 프레임 실행: 배경, 그레인, 진행 바. |
MG.prog(t, a, b, ease) | 이징된 0..1 진행. 이징: MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) 또는 모든 함수. |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | 키프레임; 값은 배열일 수 있음. |
MG.spring(t, {stiffness, damping}) | 오버슈트가 있는 물리적 0 → 1. |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | 요소당 매 프레임 한 번 호출. |
MG.clip(videoEl, start, rate) | 화면 녹화를 start부터 프레임 정확도로 재생. |
MG.rng(seed), MG.noise(x, seed) | 결정론적 난수와 흔들림. |
MG.fmt(n, {decimals}) | 카운터용 로케일 숫자 포맷. |
MG.captions() | motion.json의 캡션을 하단 UI 블록 위에 그림. |
결정론: 렌더 로직에 Date, performance.now(), requestAnimationFrame, 또는 Math.random 없음. CSS @keyframes는 허용됨; 런타임이 t에서 일시 중지하므로 animation-delay로 타이밍을 조정함. 매니페스트에 나열된 폰트와 이미지만 사용.
프레임 미리보기: open "motion.html?w=1920&h=1080&t=3.2&guides=1" (가이드가 안전 영역 표시). 실시간: ?play=1. 캡션은 렌더링에서만 표시됨.
4. 제작 기준
- 프레임 0은 이미 움직이고 있음. 검은 화면에서 페이드 인, 로고 인트로 없음.
- 0.8–2초마다 의미 있는 변화 발생: 레이아웃, 스케일, 색상, 숫자, 또는 카메라.
- 진입은 스프링 또는 ease-out-expo로 약간의 오버슈트와 함께; 30–60 ms 지연; 선형은 티커에만 사용.
- 빠른 움직임 중에만 모션 블러; 정적인 샷에서는 느린 푸시 (스케일 1 → 1.04); 2–3개 깊이 레이어 간 패럴랙스.
- 하나의 배경 패밀리, 하나의 텍스트 색상, 하나의 악센트. 업로드 후 평면 채우기가 밴딩되지 않도록 그레인 또는 그래디언트 노이즈 추가.
- 카피는 화면에 두 번 읽을 수 있을 만큼 오래 표시됨; 주요 텍스트는 안전 영역 내에 유지.
- 비트는 사운드와 일치: 각 변화에서 우슈, 히트, 또는 음악 비트.
5. 렌더
node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4
먼저 스틸 이미지로 레이아웃을 확인: 비트당 하나, 모든 트윈 내부에 하나, 모든 스프링의 오버슈트 피크에 하나. 한 번에 전체 렌더 한 개 실행 (4개 워커로 1080p60에서 25초 기준 약 10분).
6. 오디오
매니페스트에 나열된 라이선스가 허용하는 음악과 SFX만 사용하거나, 사용자가 제공한 파일 사용. 없으면 무음으로 전달하고 그렇게 명시. 큐를 믹스한 후 먹싱:
ffmpeg -i music.wav -i whoosh.wav -filter_complex \
"[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
-af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"
목표 약 −14 LUFS 통합 음량, 최대 진폭 −1 dBFS 이하. SFX는 약 −6 ~ −14 dB, 음악은 −14 ~ −18 dB. 화면 텍스트 아래의 음악은 악기 전용.
7. QA
ffprobe로 지속 시간, 크기, fps가 브리프와 일치하는지 확인.- 콘택트 시트:
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. 각 비트 변화 시점의 전체 크기 프레임도 확인 (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png). - 모든 프레임: 가장자리에서 잘린 부분 없음, 빈 프레임이나 반쯤 페이드된 프레임 없음, 가이드 잔여물 없음, 오타나 플레이스홀더 텍스트 없음, 2초 이상 정적인 부분 없음.
- 포맷 파일 자체의 검사 항목.
모든 검사가 통과할 때까지 수정 및 재렌더링. 새로운 교훈은 스킬의 references/pitfalls.md에 날짜 · 비디오 · 교훈 형식으로 추가.
전달
최종 MP4 경로, 길이, 크기, fps, 표시 내용, 필요한 크레딧을 포함한 오디오 상태, 재렌더 명령어를 보고. 작업 폴더 유지. 사용자가 요청할 때만 업로드 또는 게시.