페인티드 애니메이션
완전히 코드로 짧은 카툰을 만드는 방법으로, JohnHeibel/PDoomVideo (Claude Opus가 그린 156초 뮤직비디오)와 이를 일반화한 키트 ClaudeAnimationBase (MIT)에서 정제되었으며, template/에 번들로 포함되어 있습니다.
작동 방식: 모든 프레임은 시간 t의 순수 함수입니다. studio.html이 p5.js + p5.brush와 여러분의 씬 파일을 로드합니다. 각 샷은 1920×1080 프레임 전체를 수채화 채움과 끓어오르는 잉크 선으로 그립니다. render.mjs는 headless Chrome을 구동하여 리뷰용 콘택트 시트 또는 모든 프레임을 병렬로 렌더링하고, ffmpeg이 MP4(오디오 포함 가능)를 인코딩합니다.
워크플로
0. 스캐폴드
bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir> # --keep-demo를 추가하면 예제 씬을 연결한 상태로 유지
이 명령은 템플릿을 복사하고, 데모 씬을 해제하며, npm install을 실행하고 node / ffmpeg / Chrome을 확인합니다. 그런 다음 <project-dir>/ANIMATION_GUIDE.md를 전체 읽기를 한 후 무엇이든 설계하십시오: 가이드에는 규칙, 애니메이션 원칙 및 완전한 엔진/Clawd API가 담겨 있습니다. Read 도구로 docs/emotions.jpg와 docs/views.jpg(모델 시트)를 살펴보십시오.
뮤직비디오나 20초 이상의 영상이라면 references/music-video.md도 읽으십시오. 가사 비디오의 경우 먼저 노래 파일과 LRC를 요청하고 scripts/beat_grid.py로 템포를 측정하십시오: 라인은 보통 예상보다 빠릅니다.
1. 코드보다 먼저 스토리보드
프로젝트에 STORYBOARD.md를 작성하십시오 (가이드에 있는 형식: 로그라인, 세계 + 팔레트 아크, 모티프, 캐릭터 감정 아크, 그 다음 reads가 포함된 샷들 — 시청자가 이해해야 할 타이밍 목록). 작업 예시: examples/xiaozhen/ (31초 가사 비디오: 스토리보드 및 전체 씬 코드).
사용자가 그냥 진행하라고 하지 않는 이상, 빌드하기 전에 스토리보드를 사용자에게 보여주고 반응을 받으십시오.
2. 샷별로 빌드
src/config.js에서duration,bpm,offset(및audio)을 설정하십시오.src/scenes/에 씬/챕터당 하나의 IIFE로 감싼 파일을 만들고,shots([[t0, fn], ...])로 끝내십시오. 해당<script>를studio.html에 추가하십시오.- 먼저 키 포즈를 블로킹하고, 정지 이미지로 확인한 다음 그 사이의 모션을 추가하십시오.
3. 렌더링하고 살펴보기 — 모든 샷, 여러 번
코드를 읽는 것만으로는 모션을 볼 수 없습니다. 프로젝트 디렉터리에서:
node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg # 키 프레임
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg # 한 순간의 모든 프레임
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg # 풀-해상도 디테일
각 이미지를 Read로 열고 가이드의 리뷰 목록에 따라 실제로 확인하십시오: 이벤트가 명확한가? 캐릭터가 충분히 큰가? first-time 시청자가 이해할 수 있도록 reads의 타이밍이 맞는가? 예비 동작/후속 동작이 있는가, 스냅이 없는가? 발과 잡고 있는 소품이 바닥에 닿는가? 모든 이음새에 트랜지션이 있는가? 텍스트, 3D, 순수 검정/흰색, 뿌연 글로우가 없는가? 수정하고 다시 확인하십시오. 예산: 샷당 최소 1장의 시트, 주요 모션과 트랜지션당 1개의 스트립, 스토리를 전달하는 얼굴당 1개의 크롭.
4. 비디오 렌더링
node render.mjs --clip --out=out/video.mp4 # 짧은 비디오, 워커 1개
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3] # 긴 비디오, 병렬 + 재개 가능
출력 경로, 길이 및 ms/프레임을 보고하십시오. open out/video.mp4를 제공하십시오.
가장 중요한 규칙
다음은 가이드의 규칙을 요약한 것입니다. 가이드가 권위를 가집니다.
- 핸드메이드 매체.
paint()/inkLine()(p5.brush)만 사용 — 절대 일반 p5rect/ellipse/fill을 사용하지 마십시오. 평면 2D만: 회전은 그려진 키 뷰(turn(),spinView())를 통해 이루어지며, 절대 3D 투영을 사용하지 않습니다.glow()(가산 혼합)로 조명 처리 — 안료 혼합은 노란색 위에 파란색이 녹색이 되기 때문입니다. - 텍스트 없음. 자막, 라벨, 표지판, 말풍선 없음; 대신 보여주십시오. 반응은 그려진 이모트(
!, 땀, 하트…)로 표현합니다. 유일한 예외는 가사 비디오의 가라오케와 최대 몇 개의 큰 SFX입니다. - 모든 샷에서 무언가 일어납니다 — 이벤트, 원인 → 반응, 설정된 장치가 결실을 맺습니다.
- 시청자를 위한 시간. 각 샷의 reads를 나열하십시오; 한 번에 하나의 read; 빠른 액션, 유지된 의미; 시선을 유도하십시오; reads가 샷 길이를 결정합니다. 이것이 생성형 애니메이션이 가장 실패하는 지점입니다.
- 살아있음. 아무것도 정지해 있지 않습니다(
feel()의 idle, 떠다니는 카메라, boil); 얼굴은 교체가 아니라emotions()를 통해 변화합니다; 캐릭터는 큽니다(미디엄 샷 u≈20–28, 클로즈업 40–70); 모든 것이 비트를 탑니다. - 모든 이음새에 트랜지션이 있으며, 이야기에 맞게 선택합니다(브러시 와이프, 아이리스 / 모양 아이리스, 채찍 팬, 매치 컷, 액션 컷, 카메라 캐리 스루).
- 하나의 작품. 하나의 세계, 색상 아크, 감정적 실, 연결된 씬, 오프닝과 운율이 맞는 엔딩.
엔진 주의사항
t의 순수 함수. 프레임은 병렬로, 순서 없이 렌더링됩니다: 프레임 간 상태 없음,Math.random()없음, 프레임별 물리 없음. 안정적인 난수는hash(i), boil은jit()을 사용하십시오.- 각각의 배경 요소/소품 앞에 **
boilSeed(key)**를 호출하십시오. 그렇지 않으면 움직이는 요소가 그 뒤에 그려진 모든 것을 매 프레임마다 다시 끓게 만듭니다(지터). - p5의 전역 변수 이름을 사용하지 마십시오. p5는
line,OVERLAY,text,color,scale, …을 전역으로 정의합니다; 최상위function line()은Cannot redefine property오류로 실패하고 페이지가 준비되지 않습니다(렌더러가 타임아웃됨). 헬퍼를 씬 IIFE 내부에 두거나 구별되는 이름을 사용하십시오. - 문, 창문, 화면의 레이어링: 내부에 있는 것을 그린 다음, 주변 벽/프레임을 다시 덧칠하여 개구부보다 넓은 것이 외부로 보이지 않게 하십시오(기차의
inDoor+ 문틀, TV 베젤 조각). - 점 목록의
NaN은Failed to construct 'OffscreenCanvas'오류를 발생시킵니다 — 변형된 지오메트리를 방지하십시오. - 카메라 줌 2배 이상에서 큰 도형은 외곽선이 사라집니다. 외곽선 두께는 줌에 비례하므로 클로즈업에서는
sw를 줄이십시오. - 비용 = 채움(fill)과 선(stroke)의 개수입니다. 약 ≤1.5–2.5 s/프레임을 목표로 하십시오 (로그에 ms/프레임이 출력됩니다). 더 적고 더 큰 도형을 선호하십시오. 실제 GPU가 없는 머신에서는 수채화 채움이 느리므로,
fill도형 수를 줄이거나 최후의 수단으로--soft-gl을 고려하십시오. - macOS: 렌더러는
--use-angle=metal을 사용하고/Applications/Google Chrome.app을 자동으로 찾습니다. 그렇지 않으면--chrome=<path>를 전달하십시오.
적응
- Clawd는 기본 스타이지 필수는 아닙니다. 새 캐릭터, 소품, 감정은 동일한 도구(
paint,ribbon,through,glow)로 그려지며 샷 전체에서 일관성을 유지합니다. 새 감정은src/clawd.js의EMO에 추가됩니다. src/karaoke.js(템플릿)는core.js의window.overlayHook훅을 통해 가사 비디오용 단어별 가라오케를 추가합니다.LOOPS.name = t => {...}; LOOPS.name.len = 4;+node render.mjs --loop=name --png는 GIF용 무한 루프를 만듭니다 (ffmpeg -i out/loop_name/f%04d.png …).- 더 높은 추론 노력은 일반적으로 더 화려하고 상세한 씬을 생성합니다.