Communitygithub.com

craft-2d-animation

2D 애니메이션을 기획, 제작 또는 편집하는 방법을 안내합니다. 구체적인 결과물은 에이전트가 샷별로 방어할 수 있는 움직임이어야 합니다. 이 절차는 EffectCraft와 FilmCraft를 활용한 2D 애니메이션 제작 전반을 다룹니다. 새로운 과제가 이 기술을 요구할 때 사용하세요.

craft-2d-animation란 무엇인가요?

이 스킬은 AI 에이전트가 EffectCraft (2D 애니메이션 도구)와 FilmCraft (편집/내보내기 도구)를 사용하여 인트로, 제품 데모, 짧은 장면 또는 2D 단편 영화를 계획하고, 애니메이션화하고, 조립하기 위한 재사용 가능한 방법론을 제공합니다. 이 스킬의 핵심은 시각적 방향과 읽기 쉬운 장면 구성, 다양한 샷 크기를 사용한 내러티브 전달, 포즈 전환과 무게감, 리듬을 통한 설득력 있는 움직임 구현에 중점을 둡니다. 특히 EffectCraft의 일반적인 함정(예: 잘못된 부모-자식 관계 설정, 레이어 쌓기 순서 오류)을 방지하는 상세한 규칙을 제공하여 안정적인 애니메이션 제작을 보장합니다. 또한 텍스트 가독성, 다이제틱(장면 내) vs 오버레이 텍스트 구분, 제한된 리소스 환경에서의 효율적인 렌더링 및 검증 워크플로우를 다룹니다. 주요 CLI 명령어, 공유 Python 스크립트(ec_runtime.py 등), 배치 렌더링 및 조립 도구를 포함하여 에이전트가 실제 프로덕션 환경에서 이 스킬을 바로 실행할 수 있도록 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NelaBDV/craft-video-kit/tree/HEAD/skills/craft-2d-animation

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

2D 애니메이션 제작 (EffectCraft + FilmCraft)

EffectCraft(및 FilmCraft에서의 편집/내보내기)를 사용하여 인트로, 제품 데모, 짧은 장면 또는 2D 단편 영화를 설계, 애니메이션 및 조립하기 위한 일반적이고 재사용 가능한 방법입니다. 음악 트랙 유무에 관계없이 사용할 수 있습니다.

CLI/MCP 참조 및 공유 Flatpak 권한: ../craft-music-video/references/mcp-and-commands.md.


1. 시각적 방향 및 장면 가독성

  1. 색상으로 식별 가능한 장소: 짧은 장면을 최대 2~3개 장소로 제한하고, 각 장소에는 지배적인 조명과 전용 색상 팔레트를 지정합니다(예: 따뜻한 복도/야간, 화면에 비친 작업 공간, 오류나 경고에만 단일 액센트 색상이 사용되는 밝은 방).
  2. 빈 윤곽선보다는 채워진 실루엣: 캐릭터와 배경을 채워진 기하학적 모양(베지어 곡선 또는 둥근 사각형)으로 구성하고, 미니멀한 얼굴(단순한 눈, 눈썹, 입)과 광원 쪽에 약간의 역광선(림 라이트)을 추가합니다.
  3. 실루엣 대비: 썸네일 단계에서 각 캐릭터를 구분합니다(예: 웅크린 둥근 실루엣 vs 곧은 직사각형 어깨와 날카로운 동작의 실루엣).
  4. 카메라 움직임을 위한 과대 설계된 배경: 1920×1080에서 줌/셰이크를 위해 배경/벽을 프레임보다 더 넓게(2200–2400 px), 파노라마 트래블링을 위해 3600+ px로 그려 프레임 가장자리에 10–20 px의 검은 테두리가 나타나는 것을 방지합니다.

2. 프레이밍 및 시각적 문법

불필요한 텍스트 없이 액션을 전달하기 위해 다양한 샷 크기를 사용합니다:

샷 크기내러티브 역할기술적 모범 사례
풀 샷 (Establishing)장소, 조명 및 요소의 상대적 위치 제시같은 장소로 돌아올 때 고정된 공간 기준점(책상, 화면, 패널, 문) 유지
어깨 너머 샷 (OTS)캐릭터의 목표와 인터페이스/물체에 대한 시점 표시첫 번째 시도와 최종 성공 사이에 정확히 동일한 OTS 프레이밍을 재사용하여 즉각적인 시각적 회상 효과 생성
미디엄 샷 / 프로필자세, 이동 및 장면의 물리적 변화 추적점진적인 웅크림, 의자 뒤로 밀기, 큰 동작을 보여주기에 이상적
클로즈업의도, 인터페이스 세부 사항, 키보드 위의 손, 시선, 또는 개그 분리움직임을 짧고 읽기 쉽게 유지; 클로즈업을 활용하여 깔끔한 네거티브 공간 확보

카메라 프레이밍 계산 (cam_focus)

앵커 널 카메라가 [0, 0]이고, 월드 좌표 (tx, ty)의 한 지점을 W × H 프레임의 중앙에 sc % 배율로 맞추려면 다음 공식을 정확히 따릅니다: pos = [W / 2 - (sc / 100) * tx, H / 2 - (sc / 100) * ty] (ec_runtime.py의 cam_focus(tx, ty, scale_pct, width, height) 함수로 바로 사용 가능합니다).


3. 포즈 변경, 무게감 및 시각적 리듬

  1. 예비 동작(Anticipation) → 액션 → 반동 / 유지(Hold) :
    • 포즈 A에서 포즈 B로 선형적으로 절대 전환하지 마십시오.
    • 액션 전에 반대 방향의 작은 예비 동작을 추가합니다(예: 키를 누르기 전에 손가락이 올라갔다 망설임, 문이 닫히기 전에 살짝 열림, 몸이 뒤로 물러나기 전에 지지대를 잡음).
    • 약간의 오버슈트나 읽기 쉬운 멈춤(hold)으로 마무리하여 무게감을 줍니다(예: 캐릭터가 한 걸음 물러서서 자신의 작업을 감상하며 잠시 멈춤).
  2. 점진적인 자세 단계: 대기 중이거나 긴장이 고조될 때, 지속적인 떨림보다는 장면 사이에서 명확한 단계로 자세를 변화시킵니다(상체 기울기, 머리 숙임, 팔 늘어뜨림).
  3. 두 액션 사이의 장면 유지: 모든 레이어를 계속 흔들기보다는 액센트 사이에 구성을 호흡하도록 둡니다(눈 깜빡임, 미세 슬로우 줌, 커서 깜빡임).
  4. 필수 무음 테스트: 모든 액션, 인트로 또는 데모 장면을 소리 없이(또는 3–5개의 키프레임 render-frame 캡처를 통해) 시청합니다. 캐릭터의 목표와 장면 진행 상황이 이미지 만으로 100% 이해 가능해야 합니다.

4. 캐릭터, 카메라 앵커 및 레이어 쌓기 순서 (EffectCraft 함정)

이 규칙들은 EffectCraft(After Effects 호환 동작)에서 오프셋 버그, 분리된 팔다리 또는 숨겨진 요소를 방지합니다:

A. 널 및 카메라

  • comp.layers.addNull()은 기본적으로 앵커를 [50, 50]으로, 위치를 [960, 540]으로 생성합니다. 널을 배치하거나 부모-자식 관계를 설정하기 전에 항상 anchorPoint.setValue([0, 0]) 으로 강제 설정하십시오(ec_runtime.py의 makeCamNull이 수행하는 작업입니다).
  • child.position.setValue(...) 이전에 항상 child.parent = parent를 할당하여 child의 좌표가 부모의 로컬 공간에서 직접 해석되도록 하십시오.

B. 부모-자식 관계 및 변형에 대한 절대 규칙

  • 부모가 중립 포즈(rotation = 0°, scale = [100, 100])인 동안에만 모든 자식을 연결하십시오.
  • 자식 계층 구조 전체가 생성된 후에만 초기 회전, 카메라 줌 또는 부모의 키프레임을 적용하십시오.
  • 이유: child.parent = parent를 할당하기 전에 parent.rotation이나 parent.scale을 수정하면 AE 스타일의 역보상이 트리거되어 머리/팔이 몸체 밖으로 튀어나가거나 전체 배경이 프레임 구석으로 축소됩니다.

C. 관절 2D 캐릭터의 앵커 계층 구조

  • 앉은 캐릭터: Root는 엉덩이(hip_pos)에 위치 → Chair, Legs, TorsoNull (허리 피벗 [0,0]) → BackUpperArm (어깨) → BackForeArm (팔꿈치) → TorsoBody → Head (목 아래) → UpperArm → ForeArm.
  • 선 캐릭터: Root는 발 사이 바닥(foot_pos)에 위치하여 줌이나 뒤로 물러설 때 신발이 바닥에 고정되도록 함 → LegBack / LegFront (엉덩이 피벗) + TorsoPivot (엉덩이 피벗) → Arms, Blazer/Body, Head.
  • 목/칼라 연결: 상체 상단과 머리 하단을 겹치는 칼라/목 채워진 모양을 항상 추가하여 강한 기울임(25°–35°)에서도 턱과 어깨 사이에 틈이 생기지 않도록 합니다.

D. 레이어 쌓기 순서 (Stacking Order)

  • 동일한 셰이프 레이어 내(ADBE Root Vectors Group) : 추가된 첫 번째 그룹이 가장 위에 그려지고, 마지막 그룹이 가장 아래에 그려집니다(앞 → 뒤 순서).
  • 컴포지션의 서로 다른 레이어 간: 새 레이어는 인덱스 1(가장 위)에 삽입됩니다. 레이어를 뒤 → 앞 순서로 구성하십시오(배경 → 광선 → 배경 요소 → 캐릭터 → 전경).

5. 텍스트 가독성 및 다이제틱/오버레이 분리

  1. 영구적인 검은색 띠 금지: 제목, 자막 또는 설명을 각 장면의 남은 네거티브 공간(화면 위, 벽의 어두운 구석, 수평선 아래)에 배치하고, 얼굴, 화면 가장자리 또는 배경 패널과 절대 겹치지 않도록 합니다.
  2. 대비 및 안전 여백:
    • 밝은 배경과 어두운 배경 모두에서 가독성을 보장하기 위해 부드러운 그림자(ADBE Drop Shadow, 불투명도 190–230, 거리 4–6 px, 블러 14–18 px)를 적용합니다.
    • 1920×1080에서 가로 안전 여백(>= 70 px)과 읽기 가능한 유지 시간(액션 또는 마지막 단어 종료 후 >= 0.35초, 장면 전환을 넘어서도 적용)을 준수합니다.
  3. 다이제틱 텍스트(V1) vs 오버레이 텍스트(V2) 엄격 분리:
    • 장면 내 텍스트(V1) : 간판, 화면 인터페이스, 문서, 칠판, 키보드 키. 애니메이션 세계의 일부이며 모든 내보내기에 포함됩니다.
    • 오버레이 텍스트(V2, ProRes 4444 RGBA) : 제목, 자막, 대사 또는 UI 주석. 별도의 투명 컴포지션에 배치하면 한 번의 클릭으로 타이틀 포함 버전과 클린 버전을 엄격하게 동일한 편집으로 내보낼 수 있습니다.

6. 시각적 확인 및 리소스 효율적 렌더링

  1. 비디오 렌더링 전 키프레임 검사: 장면당 1~2개의 키프레임에 대해 effectcraft-cli render-frame --max-side 960을 사용하고(V2 오버레이의 경우 --transparent 추가) 몇 초 만에 프레이밍, 관절 연결 상태 및 텍스트 가독성을 확인합니다.
  2. 안전한 순차 렌더링 (8GB RAM / 낮은 CPU 사양) :
    • 한 번에 1개의 컴포지션만 렌더링합니다(8GB RAM에서는 ProRes 4444 RGBA를 병렬로 렌더링하지 마십시오).
    • 스레드를 제한하고(RAYON_NUM_THREADS=2, OMP_NUM_THREADS=2), 낮은 우선순위로 실행하며(nice -n 15 ionice -c 3), VRAM이 시스템 RAM과 공유되는 경우 --gpu를 피하고, 렌더링 간에 2초 간격을 두어 메모리를 해제합니다.

7. 공유 T3 Code 도구 및 종속성

재사용 가능한 스크립트는 ~/.t3/shared/craft-video/ 에 있습니다:

도구경로2D 애니메이션 용도
Runtime JSX EffectCraft~/.t3/shared/craft-video/ec_runtime.py.ecproj 생성을 위한 JsxBuilder, cam_focus, hex_to_rgba, run_effectcraft_script 임포트 (앵커 [0,0], 베지어, 글로우, 부드러운/유지 키프레임)
배치 순차 렌더링~/.t3/shared/craft-video/render_ec_batch.shV* 장면(ProRes HQ RGB) 및 L*/T* 오버레이(ProRes 4444 RGBA)를 낮은 부하로 렌더링, ffprobe를 통한 자동 재개 지원
FilmCraft 조립 및 내보내기~/.t3/shared/craft-video/assemble_filmcraft.pyV1(+ 선택적 V2 알파 및 A1 오디오)을 Rec.709로 .fcproj에 조립하고 Master + Clean 내보내기

필요 종속성

  • Python 3.9+ (표준 라이브러리만 필요)
  • ffmpeg 및 ffprobe
  • EffectCraft CLI (effectcraft-cli 또는 Flatpak ai.storyteller.effectcraft with --filesystem 접근)
  • FilmCraft CLI (filmcraft-cli 또는 Flatpak ai.storyteller.filmcraft) for multi-track assembly/export
  • 선택적 Linux: nice, ionice, taskset

예제 명령어

# 사용 가능한 종속성 확인 (렌더링 없음)
python3 ~/.t3/shared/craft-video/ec_runtime.py --check-env

# 저부하 순차 렌더링 계획 미리보기 (장면 + 알파 타이틀)
~/.t3/shared/craft-video/render_ec_batch.sh \
  --project ./projects/demo_2d.ecproj \
  --out-dir ./renders_vfx \
  --rgb V01_Intro,V02_Demo \
  --rgba T01_Intro,T02_Demo \
  --threads 2 --cores 0-3 --dry-run

# 음악 없는 FilmCraft 조립 미리보기 (무음 인트로/데모, Master + Clean)
python3 ~/.t3/shared/craft-video/assemble_filmcraft.py \
  --out-fcproj ./projects/demo_2d.fcproj \
  --v1-clips ./renders_vfx/V01_Intro.mov,./renders_vfx/V02_Demo.mov \
  --v2-clips ./renders_vfx/T01_Intro.mov,./renders_vfx/T02_Demo.mov \
  --export-master ./exports/demo_2d_titles.mp4 \
  --export-clean ./exports/demo_2d_clean.mp4 \
  --dry-run

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬