Stickman Video Master Skill — 대본에서 최종 릴까지
완전하고 검증된 파이프라인: 인도 호러/미스터리 힌디어 쇼츠(1080×1920, 30fps)를
코드로 제작합니다 — 리서치, 대본, 캐릭터 디자인, 장면 구성, 음성 더빙, 믹싱, 품질 검수.
참고 제작물: Bhangarh 릴 (데모 영상은 demo/demo_10s.mp4 파일이며,
동일 스타일의 모든 코드는 code/ 및 vo/ 폴더에 있습니다).
STEP 0 — 리서치 (대본 작성 전)
- 실제 장소/이야기에 대한 심층 리서치: Wikipedia + 공식 출처 (ASI 게시판과 같은 1차 증거).
- 모든 주장에 태그를 붙이세요: [DOCUMENTED] (증거 있음) · [LEGEND] (민담) · [NAHI MILA] (대본에 넣지 마세요).
- 확인되지 않은 바이럴 주장은 절대 넣지 마세요 — 먼저 확인하세요. (Bhangarh 교훈: "유일하게 밤에 출입이 금지된 요새"는 잘못된 정보로 판명되어, 대본에서 제거했습니다.)
- 수요 확인: 같은 주제의 가장 큰 YouTube 동영상을 확인하세요 — 어떤 각도가 성공했는지 (야간 방문, 게시판 클로즈업, 순수 이야기).
STEP 1 — 대본 작성
- 첫 문장 = 전체 사건 (훅). 첫 줄/프레임에 답의 단서를 숨기세요.
- 각 문장 6–12 단어; 총 ~150 단어 ≈ 49초 @ ~190 wpm.
- 캐릭터의 이름을 정하세요. 먼저 밝히고, "왜냐하면"은 나중에.
- 중간에 "당신"에게 도전을 제시하고, 마지막에 한 단어 댓글 미끼를 넣으세요 (네 또는 아니요?).
- 자주 쓰는 표현: "실제로는 / 즉 / 자세히 보세요 / 잠시 생각해보세요". 금지: AI 단어 (수수께끼, 사실, 스릴, 센세이션).
- 캐릭터 대사 규칙: 선택된 2–4개의 대사만 캐릭터 자신의 목소리로; 나머지는 모두 내레이션. 지어낸 대사는 금지.
- 페이싱 검증: 음성 더빙 2.3–2.7 단어/초 · 데드 에어 >12% = 삭제 · 제목이 답을 스포일러하지 않아야 함.
STEP 2 — 스토리보드 + 기하학 고정
- 대사 → 장면 테이블 (각 대사의 t0–t1을 미리 정함). 그런 다음 ASCII 좌표 고정: 각 세트의 바닥(FLOOR), 캐릭터 위치, 각 비트의 카메라.
- 먼저 스케치, 그 다음 외관 — 스케치 없이 바로 최종 코드로 가지 마세요.
STEP 3 — 캐릭터 디자인 (코드 code/my_builder.js)
- 캐릭터 = 엔지니어링된 SVG 액터 (~640 유닛): 2-세그먼트 FK 관절 (엉덩이→무릎, 어깨→팔꿈치), 둥근 관절, 역할별 턱 모양 얼굴 경로.
- 각 역할의 DNA 팔레트: 피부, 홍채, 의상, 특별 표식 (망티카, 틸락, 파그디).
- 이마 디테일 (틸락)은 머리카락 레이어 다음에 만드세요 — 그렇지 않으면 머리카락 아래에 숨겨집니다.
- 연기 API:
setFaceMood·lookEyes·poseArms·speakHuman(입 모양) ·walkHuman(실제 걷기 주기 — 슬라이드 = 심각한 실패). - 손: 손바닥 + 엄지 + 손가락 선. 모든 액터에 깜빡임 루프 + 호흡.
- 품질 기준: 캐릭터를 기본 도형 (원형 머리, 원통형 몸통)으로 만들지 마세요 — 조각된 경로만 사용합니다.
STEP 4 — 세트 디자인 (코드 code/my_head.js, my_scenes_a/b.js)
- 재질 먼저: 모든 표면은 다중 중지 그래디언트 (iGrad) + 실제 그림자; 단색 = 실패.
- 방 = 3D 쉘: 뒷벽 + 원근감 있는 측벽 + 바닥 다각형 + 베이스보드.
- 돌담: 각 돌은 다른 색조 + 하이라이트 선 + 날씨 자국 (절차적 돌 텍스처) — 욕실 타일 반복 = 실패.
- 바위/암석: 불규칙한 12점 다각형 + 3면 음영 + 균열 + 모래 자국 + 접촉 그림자. 팔각형/슬래브 = 심각한 실패.
- 살아있는 소품: 흔들리는 램프, 하반의 불꽃 + 연기, 까마귀, 안개 (약하게!) — 하지만 FX 효과를 켜둔 상태로 두지 마세요, 각 FX의 OFF 비트가 필수입니다.
- 카메라 법칙: 각
camTo전에 뷰 하단 계산 —cy + 960/s ≤ 1920, 그렇지 않으면 프레임 아래에 하늘/검은 여백이 보입니다. - 하늘 사각형은 항상 전체 높이.
STEP 5 — 조립 + 렌더링
- 엔진 코어 = 조립된 html의 접두사 (쉘 svg#stage + defs + rig + 도우미 E/iGrad/makeCam/seekWrap) + 장면 파일 + 닫는 태그.
gsap.min.js를 함께 두세요 — 파일 복사를&&체인에 넣지 마세요 (하나 실패하면 나머지 모두 중단됨). - 타임라인은 GSAP 기반; 렌더링은 결정적 seek 방식: Playwright 1080×1920 →
window.seekToTime(t)각 프레임 → JPEG q88 → ffmpeg libx264 crf18. ~20초 청크로 렌더링 (VM 재시작 방지), 재개 가능 패턴 (프레임 >10KB이면 건너뛰기). - GSAP 교훈: 이미 변환(translate+scale)이 적용된 그룹에는 x/y 트윈을 사용하지 마세요 — attr transform 절대 트윈을 사용하세요.
- 긴 자막 줄: 렌더 스크립트에서
getComputedTextLength() > 1030일 때textLength=1030수정자 실행. - poseArms 부호: armR을 프레임 기준 왼쪽으로 회전 = 양수 회전. 쓰러진 캐릭터: wrap −84°에서 머리가 약 530 유닛 왼쪽으로 이동 — 머리의 최종 위치를 미리 계산하여 wrap 설정.
STEP 6 — 자체 감사 루프 (각 장면)
- 테스트 스틸 이미지 추출 (각 장면 중간 + 문제 프레임) → 직접 확인 (확대 크롭도) → 수정 → 다시 스틸.
- 3가지 감사: 예술적 (구도, 색상) · 물리적 (해부학, 그림자, 바닥 연결) · 스토리 (내레이션 일치, 표정 반전 여부).
- 점수 /100; 95+만 최종 합격. 심각한 실패 (부러진 팔, 떠 있는 물체, 반전된 그림자, 잘못된 소품)는 점수를 무시합니다.
- 배너/자막은 화면 공간에 배치: 머리 화면-y = (wy − cy)·s + 960; 배너 118–222, 자막 1652+ 바깥.
STEP 7 — 음성 더빙 (코드 vo/fit_lines.py)
- 모델 gemini-3.8-flash-tts (기본) / gemini-3.1-flash-tts-preview (429 오류 시에만 폴백). 2.5 TTS 금지. 모델당 할당량 10회/일 — 예산을 미리 계산하세요.
- 내레이션 = 단일 호출, 전체 대본을 한 번에. 텍스트를 RAW로 보내세요 — 긴 스타일 지시는 속도를 2.5배 느리게 하고 때로는 방향 자체를 말하기도 합니다.
- 목소리: 내레이션 Puck (Raj 선호, @i.raj1801 릴의 기본값) · 악당/다른 목소리 Algenib.
- TTS WAV = 48000 Hz로 제공됨 — 실제 속도로 피치 계산: pitch ×1.12 = asetrate 53760 (rubberband 절대 사용 금지 — 에코 발생). 악당을 무겁게 만들려면 ×0.96.
- 대사 맞춤: Whisper (small, 언어
hi)로 테이크의 세그먼트 추출 → 각 대사 자르기 → 일시 정지 압축 (silenceremove) → 피치 → 줄별 atempo로 자막 창에 정확히 맞춤. - Whisper에 WAV를 stdlib wave+numpy로 디코딩하여 제공 (PyAV
metadata_errorsTypeError 발생).
STEP 8 — 믹싱 (코드 vo/mix.py)
- BGM은 각 릴마다 새로 — 절대 재사용 금지; 라이센스 안전 (Kevin MacLeod 라이브러리). 볼륨 ~0.10, 음성 더빙 아래.
- SFX 비트맵: whoosh (던지기), impact (충돌/낙하), thunder (번개/저주), riser (저주 전).
- Loudnorm 2-pass (측정 → 선형 적용) = −14.0 LUFS, TP ≤ −1.5. 단일 패스는 종종 −15.8에서 멈춤.
- 먹싱: 비디오 스트림 복사 + AAC 192k.
STEP 9 — 최종 QC + 전달
- 전달 파일을 Whisper로 듣기 — 모든 대본 줄이 올바른 순서/시간에 있는가? 소스 테이크 검증만으로는 충분하지 않습니다.
- 길이, 크기, LUFS 세 가지를 모두 확인하여 보고.
- 전달 교훈: 비디오 파일 이름을 재사용하지 마세요 — 앱이 이전 복사본을 캐싱하여 표시합니다. 각 새 전달 = 새 이름 (v2, _Final, 날짜).
- 완벽한 (Raj 승인) 비디오는
Perfect_Videos/<date>/폴더에 저장됩니다 — 완벽한 것만.
파일 가이드
script/Script_v1.md— Bhangarh 대본 + 진실/이야기 태그 + 페이싱 확인 (템플릿으로 사용)code/my_head.js— 셰이더, HUD, drawStoneWall / drawRealBoulder / drawPerfumeBottle / drawAsiBoard / drawHangingLampcode/my_builder.js— buildBhangarhActor (5 역할, 전체 리그)code/my_scenes_a.js/my_scenes_b.js— 8세트 + 타임라인 + 자막code/props_snippet.js/api_snippet.js— 나무/잔디 + 연기 APIcode/render_test.py/render_full.py— 스틸 + 전체 렌더 (재개 가능)vo/fit_lines.py/vo/mix.py— 음성 더빙 맞춤 + 최종 믹스docs/— 시각 시스템 개요 + 교훈demo/demo_10s.mp4— 이 파이프라인의 10초 샘플 장면 (실제 릴은 여기에 공개되지 않음)