2D 애니메이션 제작 (EffectCraft + FilmCraft)
EffectCraft(및 FilmCraft에서의 편집/내보내기)를 사용하여 인트로, 제품 데모, 짧은 장면 또는 2D 단편 영화를 설계, 애니메이션 및 조립하기 위한 일반적이고 재사용 가능한 방법입니다. 음악 트랙 유무에 관계없이 사용할 수 있습니다.
CLI/MCP 참조 및 공유 Flatpak 권한: ../craft-music-video/references/mcp-and-commands.md.
1. 시각적 방향 및 장면 가독성
- 색상으로 식별 가능한 장소: 짧은 장면을 최대 2~3개 장소로 제한하고, 각 장소에는 지배적인 조명과 전용 색상 팔레트를 지정합니다(예: 따뜻한 복도/야간, 화면에 비친 작업 공간, 오류나 경고에만 단일 액센트 색상이 사용되는 밝은 방).
- 빈 윤곽선보다는 채워진 실루엣: 캐릭터와 배경을 채워진 기하학적 모양(베지어 곡선 또는 둥근 사각형)으로 구성하고, 미니멀한 얼굴(단순한 눈, 눈썹, 입)과 광원 쪽에 약간의 역광선(
림 라이트)을 추가합니다. - 실루엣 대비: 썸네일 단계에서 각 캐릭터를 구분합니다(예: 웅크린 둥근 실루엣 vs 곧은 직사각형 어깨와 날카로운 동작의 실루엣).
- 카메라 움직임을 위한 과대 설계된 배경:
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. 포즈 변경, 무게감 및 시각적 리듬
- 예비 동작(Anticipation) → 액션 → 반동 / 유지(Hold) :
- 포즈 A에서 포즈 B로 선형적으로 절대 전환하지 마십시오.
- 액션 전에 반대 방향의 작은 예비 동작을 추가합니다(예: 키를 누르기 전에 손가락이 올라갔다 망설임, 문이 닫히기 전에 살짝 열림, 몸이 뒤로 물러나기 전에 지지대를 잡음).
- 약간의 오버슈트나 읽기 쉬운 멈춤(hold)으로 마무리하여 무게감을 줍니다(예: 캐릭터가 한 걸음 물러서서 자신의 작업을 감상하며 잠시 멈춤).
- 점진적인 자세 단계: 대기 중이거나 긴장이 고조될 때, 지속적인 떨림보다는 장면 사이에서 명확한 단계로 자세를 변화시킵니다(상체 기울기, 머리 숙임, 팔 늘어뜨림).
- 두 액션 사이의 장면 유지: 모든 레이어를 계속 흔들기보다는 액센트 사이에 구성을 호흡하도록 둡니다(눈 깜빡임, 미세 슬로우 줌, 커서 깜빡임).
- 필수 무음 테스트: 모든 액션, 인트로 또는 데모 장면을 소리 없이(또는 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. 텍스트 가독성 및 다이제틱/오버레이 분리
- 영구적인 검은색 띠 금지: 제목, 자막 또는 설명을 각 장면의 남은 네거티브 공간(화면 위, 벽의 어두운 구석, 수평선 아래)에 배치하고, 얼굴, 화면 가장자리 또는 배경 패널과 절대 겹치지 않도록 합니다.
- 대비 및 안전 여백:
- 밝은 배경과 어두운 배경 모두에서 가독성을 보장하기 위해 부드러운 그림자(
ADBE Drop Shadow, 불투명도190–230, 거리4–6 px, 블러14–18 px)를 적용합니다. 1920×1080에서 가로 안전 여백(>= 70 px)과 읽기 가능한 유지 시간(액션 또는 마지막 단어 종료 후>= 0.35초, 장면 전환을 넘어서도 적용)을 준수합니다.
- 밝은 배경과 어두운 배경 모두에서 가독성을 보장하기 위해 부드러운 그림자(
- 다이제틱 텍스트(
V1) vs 오버레이 텍스트(V2) 엄격 분리:- 장면 내 텍스트(
V1) : 간판, 화면 인터페이스, 문서, 칠판, 키보드 키. 애니메이션 세계의 일부이며 모든 내보내기에 포함됩니다. - 오버레이 텍스트(
V2, ProRes 4444 RGBA) : 제목, 자막, 대사 또는 UI 주석. 별도의 투명 컴포지션에 배치하면 한 번의 클릭으로 타이틀 포함 버전과 클린 버전을 엄격하게 동일한 편집으로 내보낼 수 있습니다.
- 장면 내 텍스트(
6. 시각적 확인 및 리소스 효율적 렌더링
- 비디오 렌더링 전 키프레임 검사: 장면당 1~2개의 키프레임에 대해
effectcraft-cli render-frame --max-side 960을 사용하고(V2오버레이의 경우--transparent추가) 몇 초 만에 프레이밍, 관절 연결 상태 및 텍스트 가독성을 확인합니다. - 안전한 순차 렌더링 (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.sh | V* 장면(ProRes HQ RGB) 및 L*/T* 오버레이(ProRes 4444 RGBA)를 낮은 부하로 렌더링, ffprobe를 통한 자동 재개 지원 |
| FilmCraft 조립 및 내보내기 | ~/.t3/shared/craft-video/assemble_filmcraft.py | V1(+ 선택적 V2 알파 및 A1 오디오)을 Rec.709로 .fcproj에 조립하고 Master + Clean 내보내기 |
필요 종속성
- Python 3.9+ (표준 라이브러리만 필요)
ffmpeg및ffprobe- EffectCraft CLI (
effectcraft-cli또는 Flatpakai.storyteller.effectcraftwith--filesystem접근) - FilmCraft CLI (
filmcraft-cli또는 Flatpakai.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