toy-loops은(는) 무엇을 하나요?
작은 종이 공예 세계(섬, 캠프장, 영화 세트), 배우로서의 클로드, 부드럽고 따뜻한 빛과 미니어처처럼 얕은 심도. 모든 오브젝트는 코드로 만들어지고 모든 프레임은 프레임 번호로 계산되므로 루프가 정확히 닫힙니다. 이 룩은 anymation/3d_ref/style2에 있는 핌보의 레퍼런스와 reference-video-analysis 스킬(1차 패스: 3d_ref/style2/analysis/FIRST_PASS.md)을 통해 연구되었습니다. 해당 레퍼런스는 개인 학습 자료입니다. 공예는 복사하되, 장면은 절대 복사하지 마세요.
상태: v1, 2026-11-18. 이 스킬로 제작되어 승인된 작품:
claude_isla: 핌보 승인 완료("esta épica").claude_fogata: 두 번째 루프.director_hero: 두 가지 색상으로 제작된 2400x1200 웹 히어로 이미지.claude_pose: 실시간 웹 눈이 있는 컷아웃.claude.glb: 3D 모델.
모든 파일의 위치
코드는 핌보 PC의 폴더 C:\Users\Pimbo\work\anymation\toy3d\skill에 있습니다. 아래 모든 경로는 별도 명시가 없으면 kit/ 폴더를 기준으로 합니다.
| 경로 | 설명 |
|---|---|
lib/toy.py | 룩: 흰색 베벨 모서리가 있는 종이 재질, 도형, 조명, 카메라, 렌더 설정 |
lib/anim.py | 애니메이터 도구: 이징, Track(포즈 간 전환), 스프링, squash, arc, looped |
lib/chars.py | Claude: 리그와 여섯 가지 눈 세트; 프레임당 .pose(...) 한 번 호출 |
lib/runner.py | 장면을 프레임별로 렌더링; 모든 장면은 runner.run(...)으로 끝남 |
loops/<name>/scene.py | 하나의 루핑 애니메이션 |
stills/<name>/scene.py | 하나의 이미지 (T = 1) |
tools/make_loop.py | 렌더링, GIF 1080/720 및 MP4 x1/x3 인코딩, QA, 연락처 시트를 한 번에 처리 |
tools/qa_loop.py | 루프 이음새, 프레임 수, 데드 홀드, 레퍼런스 대비 움직임 검사 |
tools/duotone.py | 이미지의 파란색 단색 버전 (웹 히어로 스타일) |
tools/web_eyes.py | 눈 없는 렌더에서 클로드의 눈이 커서를 따라가는 웹 페이지 |
tools/claude_glb.py | 클로드 모델을 .glb로 내보내기(단색, 흰색 모서리 유지), 블렌더 내에서 실행 |
out/<name>/ | 출력: frames/, 파일들, sheet.jpg, qa.json |
완성된 작품은 anymation/toy3d/videos/<name>/로 복사됩니다. 웹 작품은 anymation/toy3d/web/에 위치합니다.
필요 사항:
- 블렌더 5.2: 핌보의 포터블 복사본은
anymation/tools/blender에 있습니다. 다른 곳에서는$BLENDER를 설정하거나blender를 PATH에 추가하세요. - ffmpeg (PATH에 있어야 함).
- Python (numpy 및 Pillow, 도구용).
핌보는 스크립트를 직접 실행하지 않습니다. 여러분이 실행하고 결과물을 보여줘야 합니다.
절대 바뀌지 않는 규칙
- 만들기 전에 먼저 보여줘라. 새로운 세계나 캐릭터를 만들기 전에 2-3개의 스틸을 렌더링(
--frames ... --scale 0.5)하고 핌보가 선택하게 하세요. 보여주기 전에 직접 모든 이미지를 확인하세요. pose(f)는 프레임에 대한 순수 함수다. 프레임 간 상태를 유지하지 말고, 고정 시드 없는 난수 사용 금지, 모든 주기적 움직임은 루프당 정수 사이클이어야 합니다. 루프 끝을 넘는 효과는looped()를 사용하세요.- 애니메이터처럼 애니메이션하라(
references/ANIMATION.md). 먼저 도프 시트를 작성한 다음 이징이 적용된 키 포즈를 사용하세요. 모든 동작 전에는 예비 동작(anticipation)을, 충격 시에는 스쿼시(squash), 속도감에서는 스트레치(stretch)를, 팔에는 오버랩(overlap)을, 눈 깜빡임은 한 프레임 단위로 교체하세요. 선형적으로 몸을 움직이지 마세요. - QA를 통과해야만 루프가 완료된 것이다(
make_loop.py에서 PASS/FAIL 출력). 그리고 모든 동작을 프레임별 스트립으로 확인해야 한다("스트립" 참조). - 측정된 것[M], 본 것[V], 가정한 것[S]을 명시하라.
파이프라인
| 단계 | 내용 | 명령어 (kit/에서 실행) |
|---|---|---|
| 1 | 아이디어: 장소, 시작과 끝이 있는 작은 이야기 (6-9초) | 핌보와 상의 |
| 2 | 가장 유사한 장면 복사: loops/claude_isla (낮, 실외) 또는 loops/claude_fogata (밤, 소품, 효과) | |
| 3 | 세트 제작, 클로드 배치, 조명 및 카메라 설정; 스틸 확인 | python tools/make_loop.py <name> --frames 0 --scale 0.5 |
| 4 | 도프 시트 주석 작성 후 Track; 키 포즈 렌더링 | python tools/make_loop.py <name> --frames 44,62,66,71,77,81 |
| 5 | 전체 루프 빠르게 확인 | python tools/make_loop.py <name> --preview (8프레임마다) |
| 6 | 전체 렌더 + GIF + MP4 + QA | python tools/make_loop.py <name> |
| 7 | 각 동작별 스트립 확인, 수정, 재렌더링 | 아래 "스트립" 참조 |
| 8 | 완성 파일을 anymation/toy3d/videos/<name>/로 복사하고 핌보에게 전송 |
핌보 PC (RX 6800 XT) 기준 시간 [M]:
- EEVEE: 1080x1080 프레임당 약 0.7초, 따라서 200프레임 루프는 약 2.5분 소요.
- Cycles: 프레임당 약 10초, 결과는 거의 동일합니다. 스틸에만 사용하세요:
--engine cycles --samples 256은 2400x1200에서 약 20초 소요.
스트립. 동작을 프레임별로 확인하려면:
ffmpeg -framerate 25 -start_number 56 -i out/<n>/frames/%04d.png -frames:v 30 -vf "crop=...,scale=260:-1,tile=6x5" -frames:v 1 strip.jpg
룩 요약 (세부사항 및 수치: references/LOOK.md)
- 장난감 스케일. 1 유닛 = 1m, 클로드는 약 9cm 너비. 실제 카메라 심도(70mm, f/4.5-7)가 자체적으로 미니어처 블러를 만듭니다.
- 종이. 모든 솔리드는
paper(...)를 적용받습니다: 무광 색상, 섬유 범프, 부드러운 얼룩. 베벨 모서리는 자동으로 흰색 모서리 재질이 적용됩니다(box,prism,disc). - 색상. 뷰 변환: AgX (Punchy 룩). 노출: 낮은 -1, 밤은 약 -0.35.
- 밝은 면: 클로드의 밝은 면은 레퍼런스에 가깝게 측정됩니다(우리 #DA8D6C, 레퍼런스 #EC815B).
- 밝기: 낮 프레임의 평균 밝기는 120-140 (레퍼런스 91-181).
- 조명. 따뜻한 키 라이트, 높고 전면에 위치하여 윗면이 앞면보다 밝습니다. 약한 차가운 필 라이트와 따뜻한 림 라이트를 추가합니다. 빛나는 물체(불꽃, 별, 연기)는
flame_mat와no_shadow를 사용합니다. - 카메라. 루프 내에서는 고정 (레퍼런스는 컷이나 푸시인 시에만 카메라를 움직입니다).
- GIF는 정사각형 1080.
- 히어로 이미지는 와이드,
shift_x로 피사체를 1/3 지점으로 밀어냅니다.
클로드 요약 (references/CHARACTERS.md)
claude = Claude('claude', loc), 이후 프레임당:
claude.pose(s, hop, pitch, roll, yaw, arm_l, arm_r, eyes, eye_big, eye_look, loc)
- 눈:
sq,happy(^ ^),line(- -),squeeze(> <),dot(. .),sad. - 소품: 잡고 있는 소품은
claude.hand(side)에 부모 설정. - 손 흔들기: 흔드는 팔은 카메라를 향한 쪽이어야 합니다.
웹 작품: 실시간 눈과 3D 모델
- 실시간 눈.
--eyes-off(컷아웃용--transparent) 옵션으로 렌더링:python tools/make_loop.py claude_pose --transparent --eyes-off --tag _noeyes. 러너가 눈을 숨기고eyes.json을 작성합니다: 각 눈의 픽셀 중심, 얼굴 축 (픽셀/mm).python tools/web_eyes.py <noeyes.png> <eyes.json> <out_dir> --ink-from <render with eyes>실행.index.html과 단일 파일<dir>_un_archivo.html을 생성합니다.- 페이지 동작:
- 눈은 얼굴 평면에 그려진 SVG 도형이므로 기울어진 얼굴에서도 원근이 정확합니다.
- 감쇠 스프링으로 포인터를 따라가며 2.5~5.5초마다 깜빡입니다.
- 포인터가 가까우면
^ ^, 누르는 동안은> <. - 클릭 시 스쿼시-스트레치 바운스 (
--hero옵션 없을 때, 옵션 있으면 전체 이미지 고정).
- Chrome(playwright 사용)으로 테스트 완료 (포인터 왼쪽, 오른쪽, 위, 아래, 가까이, 누름, 뗌): 콘솔 오류 없음.
- 3D 모델.
blender -b --factory-startup --python tools/claude_glb.py -- <out.glb> [--eyes sq]실행. 약 9cm 너비의 27KB GLB 파일을 생성하며, 재가져오기 및 확인 완료. - 장면과
--eyes-off. 빌드 시 클로드에 포즈를 취하는 장면은pose(f)내부에서 다시 포즈를 취해야 합니다.--eyes-off는 거기서만 적용됩니다 (stills/director_hero참조).
품질 게이트 (tools/qa_loop.py)
FAIL:
- 잘못된 프레임 수.
- 이음새: 마지막 프레임에서 첫 프레임으로의 변화가 정상 변화의 90번째 백분위수보다 큼.
WARN:
- 동일한 연속 프레임 (데드 홀드).
- 움직임이 평균 밝기의 0.8% 미만. 측정값 [M]: 레퍼런스 r2/r3/r4 1.65/1.97/1.07%,
claude_isla0.89%,claude_fogata1.66%.
QA는 취향, 연기, 구도를 판단할 수 없습니다. 이는 스틸과 스트립을 눈으로 확인합니다.
알려진 오류 (references/KNOWN_ERRORS.md)
재렌더링이 필요한 오류:
- 팔을 약 70° 이상 올리면 몸 옆으로 숨겨집니다.
- 밝은 발광체는 AgX 아래에서 흰색으로 날아갑니다:
flame_mat를 사용하세요. - 측면 키 라이트는 앞면을 어둡게 만듭니다.
- 절대 회색 레벨로 측정된 밤 장면은 "너무 조용해" 보입니다.
- 너무 좁은 곡선 배경 아크는 가장자리가 드러납니다.