stage3d 쇼츠 (stage3d shorts)
거울 바닥이 있는 어두운 무대. 흰색 평면 알약 형태의 인물, 네온 선으로 그려진 소품, 인물을 비추는 극장 스포트라이트, 실제 3D로 움직이는 카메라, 한 번에 한 단어씩 표시되는 캡션. 이 룩은 참조 영상(비공개 학습 자료: 해당 콘텐츠, 이름 또는 대본을 절대 복제하지 마십시오)을 측정하여 역설계한 후 개선되었습니다.
상태: v0.1. 두 개의 스테이션(pricetag_demo)이 있는 9.7초 클립 하나와 5초 테스트(test5)로 검증되었습니다. 아직 전체 길이의 영상에서는 검증되지 않았습니다. 장면을 약속하기 전에 "키트에 아직 없는 기능"을 읽어보십시오.
아이디어
- 키트가 룩입니다.
kit/src/에는 색상, 글로우, 렌즈, 바닥, 조명, 카메라 곡선, 캡션이 포함됩니다. 비디오는 이를 절대 편집하지 않습니다. - 비디오는 계획(plan)입니다.
kit/plans/<name>/plan.js는 무대 위에 무엇이 있는지, 각 요소가 언제 발생하는지, 카메라가 어떻게 움직이는지를 명시합니다. 오직kit/src/api.js만 임포트합니다. 빌드는 룩에 직접 접근하는 플랜을 거부합니다. - 숫자가 결정하고, 의견은 결정하지 않습니다. 모든 렌더링은
scripts/qa.py로 측정됩니다. 실패한 비디오는 납품되지 않습니다.
키트의 위치
이 스킬은 단순한 지침일 뿐입니다. 비디오를 그리는 코드와 참조 파일은 Pimbo의 PC 폴더에 있습니다: C:\Users\Pimbo\work\anymation\stage3d\skill (kit/, references/ 및 이 파일의 사본 포함). 이 스킬의 모든 경로는 해당 폴더를 기준으로 합니다.
anymation폴더가 대화에 연결되어 있어야 합니다. 연결되지 않은 경우 Pimbo에게 연결을 요청하십시오. 키트 없이는 어떤 비디오도 만들 수 없으며, 여기 있는 어떤 것도 기억에서 재구성되어서는 안 됩니다.- Pimbo는 스크립트를 직접 실행하지 않습니다. 당신이 실행합니다. 그는 주제나 비디오 폴더를 제공하고, 스틸을 살펴보고 승인합니다.
- 비디오의 입력은 그의 자체 파이프라인에서 제공됩니다:
anymation/v2/v8/<video>/(script.json, 단어 타이밍을 위한asr_<lang>.json, 음성 및 음악을 위한premix_<lang>.wav,events_<lang>.json). - 그의 PC에서 명령을 실행할 수 있다면, 해당 폴더 내에서 작업하십시오. 클라우드 워크스페이스만 있다면:
stage3d/skill을 복사하고(node_modules,out및dist는 제외),kit/내에서npm install을 실행하고, 플랜을 작성하고 거기서 스틸을 렌더링한 후(그래픽 카드 없이 약 2초 소요), 그에게 스틸을 보여준 다음, 완성된kit/plans/<name>/을 그의 폴더에 다시 기록하십시오. - 최종 렌더링은 그의 PC에서 수행되어야 합니다. 그의 그래픽 카드는 클라우드 머신보다 약 20배 빠릅니다. 거기서 명령을 실행할 수 없다면,
stage3d/skill에node scripts\make_video.cjs <name> --gpu --workers=4를 실행하는.cmd파일을kit에서 생성하고, 그에게 더블클릭하여 출력 내용을 붙여넣도록 요청하십시오. 비디오 완료를 선언하기 전에 QA 라인을 읽으십시오.
변경 불가능한 규칙
- 하나의 비디오를 위해
kit/src/를 절대 편집하지 마십시오. 누락된 소품이나 샷 유형이 있으면 재사용 가능한 부품으로 키트에 추가하고(references/PLAN_GUIDE.md, "소품 추가" 참조), 이후pricetag_demo를 다시 확인하십시오. - 플랜의 모든 프레임 번호는 실제 오디오(단어 타이밍)에서 비롯되며, 추정해서는 안 됩니다.
- 모든 카메라 움직임에는 한 문장으로 말할 수 있는 이유가 있어야 합니다. 그 문장을 움직임 위에 주석으로 작성하십시오.
- 클립을 렌더링하기 전에 스틸을 확인하십시오. 종료 코드가 아닌 그림을 보십시오.
- 측정한 것과 가정한 것을 명시하십시오. 확인하지 않은 것이 있으면 그렇게 말하십시오.
- 비디오가 나가기 전에 사람이 오디오를 청취합니다. 이 스크립트는 숫자로 레벨을 설정합니다.
파이프라인
kit/ 내에서 작업하십시오. 특정 머신에서 처음 사용하는 경우: npm install (three, esbuild, playwright-core; 설치된 Chrome 또는 Edge를 사용하며, 다른 것은 다운로드되지 않습니다). 렌더링에는 PATH에 ffmpeg가 필요합니다. QA에는 numpy와 opencv가 설치된 Python이 필요합니다(pip install numpy opencv-python). 오디오 스크립트에는 scipy가 필요합니다.
| 단계 | 작업 | 명령어 또는 파일 |
|---|---|---|
| 1 | 스크립트 및 음성, 모든 단어에 대한 타이밍 | 이 스킬 외부; 결과: words.json = [{ w, t0, t1, line }], 초 단위 |
| 1b | 음성 녹음 전, 당일 스크립트의 모든 사실 확인 | 웹 검색; 플랜 옆에 SOURCES.md 작성 (예: plans/no_trick/SOURCES.md) |
| 2 | 스크립트를 스테이션(문장 또는 아이디어 하나당 하나)으로 분할 | plan.js 상단의 메모 |
| 3 | 플랜 작성: 빌드, 애니메이션, 카메라 | kit/plans/<name>/plan.js; pricetag_demo에서 시작 |
| 4 | 오디오: 기본 믹스 및 이벤트 효과 | kit/plans/<name>/make_audio.py → audio.wav |
| 5 | 확인 및 빌드 | node scripts/build.cjs <name> |
| 6 | 주요 프레임에서 스틸 렌더링; 프레임 조정; 반복 | node scripts/render.cjs <name> stills 0,17,62,88 |
| 7 | 소리와 함께 움직임 확인 | 브라우저에서 kit/dist/<name>/preview.html 열기 |
| 8 | 렌더링, 인코딩, QA를 한 번에 | node scripts/make_video.cjs <name> --gpu --workers=4 |
| 9 | QA 라인 읽기; FAIL은 수정 후 반복 | kit/out/<name>/logs/qa.log, qa.json |
8단계는 단계별로 한 줄씩 출력합니다. 그래픽 카드가 있는 PC에서 5초 비디오는 약 10초가 걸립니다. 그래픽 카드가 없으면(--gpu 생략) 각 프레임에 약 2초가 걸리므로, 꼭 필요한 경우에만 렌더링하십시오.
플랜 작성 요약
전체 가이드 및 부품 목록: references/PLAN_GUIDE.md. 작업 예제는 kit/plans/pricetag_demo/plan.js입니다.
- 무대는 14m 간격으로 배치된 스테이션의 행입니다. 스테이션당 하나의 문장 또는 아이디어. 카메라는 한 샷 동안 스테이션에 고정되고, 문장 사이에 휩팬(whip-pan) 으로 다음 스테이션으로 이동합니다.
build(stage)는 사물을 생성하고 배치합니다:stage.station(i).add(thing). 피규어에는 스포트라이트가 적용됩니다:stage.station(i).spotlight(figure).animate(f, o)는 프레임f에서 모든 것의 위치를 설정합니다.f에 대한 순수 함수여야 합니다. 프레임은 순서에 관계없이 병렬로 렌더링됩니다. 한 프레임에서 다음 프레임으로 상태가 유지되지 않으며,Math.random이나 시계가 없습니다.- 사물은 해당 단어가 나올 때 나타납니다:
pop(thing, f, wordFrame). 중요한 숫자는 그것이 언급되는 동안 실행됩니다. 착륙하는 사물은 바닥 링(pulse), 짧은flare및 소리를 얻습니다. - 색상은 이름으로만 지정합니다. 금색 = 가치 있는 것. 빨간색 = 가격, 비용, 위험. 흰색 = 사람 및 중립 레이블.
- 변경되는 텍스트(카운터)는 박스 크기가 재조정되지 않도록
maxChars가 필요합니다.
카메라 요약
측정값이 포함된 전체 규칙: references/CAMERA_RULES.md.
- 한 샷에는 하나의 움직임이 있으며, 때로는 두세 개입니다. 움직임 사이에서 카메라는 고정됩니다(키트가 느린 크리프를 추가합니다).
- 세 가지 움직임 종류만 있습니다:
hook(오프닝 푸시인, 프레임 0부터),reframe(20-28 프레임, 두 문장 사이, 새로운 사물이 나타나기 몇 프레임 전에 도착),slow(한 샷 전체에 걸친 푸시 또는 궤도). - 그래픽이 애니메이션되는 동안 카메라는 고정됩니다. 목록은 트래블을 얻고, 더 넓은 주장은 풀백을 얻으며, 긴 라인의 단일 객체는 하나의 느린 궤도를 얻습니다.
- 3/4 뷰(요 약 35-40도)는 깊이감을 보여줍니다. 두 번째 객체에 공간이 필요할 때 사용하십시오.
- 휩팬은 아이디어 사이에서만 발생합니다. 각 휩팬에는 약 3프레임 전에 시작되는 오디오의 우웅 소리가 필요합니다.
품질 게이트
scripts/qa.py는 다음 조건에서 비디오를 실패 처리합니다: 프레임 누락 또는 정지; 배경이 지정된 블랙이 아님; 훅 또는 리프레임이 프론트-로딩되지 않음; 카메라가 움직임 사이에 고정되지 않음; 휩팬이 움직이지 않거나 어두워지지 않음; MP4가 h264 / yuv420p / BT.709가 아니거나, 프레임 수가 잘못되었거나, 오디오가 없거나 길이가 잘못됨.
취향, 프레임 가장자리 크롭, 캡션이 올바른 단어를 표시하는지는 확인하지 않습니다. 이는 렌더링 전에 스틸을 육안으로 확인합니다: 중요한 부분이 프레임 가장자리에 잘리지 않았는지, 캡션 밴드(높이의 75-83%)에 밝은 선이 없는지, 피규어가 높이의 25%에서 85% 사이에 있는지(렌즈는 가장자리 근처를 늘림).
kit/src/를 변경한 후: pricetag_demo를 재빌드하고, 스틸 0,17,88,150,174,236을 렌더링하여 references/frames/와 비교하십시오. 소프트웨어 렌더링에서는 정확히 일치해야 합니다. 그래픽 카드에서는 약 1레벨 이내로 일치해야 합니다.
키트가 제공하는 기능
피규어(헤드셋을 착용한 알약 사람), 레이블 알약, 레이블과 큰 값이 있는 카드, 토큰, 열리는 상자(금색 또는 일반 회색), 바늘이 있는 원형 나침반, 게임 화면의 나침반 스트립, 외곽선 프레임(화면, 썸네일), 주사위, 재생 버튼, 눈금 표시, 점선 가이드, 그림(빛으로 그려진 흑백 SVG 또는 PNG), 바닥 링, 점선 바닥선, 떠다니는 반짝임, 바닥 풀과 그림자가 있는 극장 스포트라이트, 색상 바닥 풀, 후광, 광선, 불꽃, 모션 블러가 있는 휩팬, 캡션, 사운드 라이브러리(우웅, 틱, 딩, 쾅, 덜컹, 반짝임, 쉬익) 및 음성 파일과 음악 파일을 그 아래에 배치하는 믹서.
읽어야 할 두 개의 플랜: pricetag_demo (10초, 두 스테이션, 승인된 룩) 및 no_trick (47초, 다섯 스테이션, 음성, 음악 및 출처가 포함된 전체 쇼츠). starts_clean (62초, 여섯 스테이션)은 Pimbo의 스크립트 규칙에 따라 단일 금색 페이오프까지 흰색입니다. avatar는 비디오가 아닙니다. 프로필 사진용 스틸을 만듭니다.
키트에 아직 없는 기능
- 사물 행을 따른 트래블(목록용), 막대 및 선 차트.
- 한 스테이션에 두 개 이상의 스포트라이트: 시도되지 않음(반짝임은 동시에 최대 두 개의 스포트라이트로 비춰집니다). 한 스테이션에 여러 피규어가 있는 것은 하나의 스포트라이트와 나머지를 어둡게 하여 작동합니다(
no_trick, 스테이션 2). - 페이드 또는 컷: 유일한 전환은 휩팬입니다.
- 클로즈업: 카메라는 피사체 아래의 바닥이 프레임 안에 있어야 하며, 약 2m보다 가까우면 조준을 잃습니다. 더 가까운 그림은 더 넓은 화면에서 잘라냅니다(
plans/avatar). - 세 가지 움직임 종류 이상 및 카메라 롤.
- 음성, 음악 및 단어 타이밍: 외부에서 제공됩니다(Pimbo의
v2/v8파이프라인이 생성).
이러한 각 기능은 키트에 구축되고 실제 비디오에서 테스트된 후에야 플랜에서 사용할 수 있습니다.
파일
| 경로 | 설명 |
|---|---|
kit/src/ | 룩. api.js는 플랜이 임포트하는 유일한 파일입니다 |
kit/plans/<name>/ | 하나의 비디오: plan.js, words.json, make_audio.py, audio.wav |
kit/scripts/ | build.cjs, render.cjs, encode.cjs, make_video.cjs, qa.py |
kit/audio/sfx.py | 음향 효과 및 믹서 |
references/STYLE_BIBLE.md | 룩의 모든 숫자, 측정됨, 우리 것 또는 추정으로 태그됨 |
references/CAMERA_RULES.md | 카메라 편집 방법 및 측정값 |
references/PLAN_GUIDE.md | 플랜 작성 방법; api.js의 모든 함수; 소품 추가 |
references/KNOWN_ERRORS.md | 이미 한 번 발생한 실수와 각각을 방지하는 방법 |
references/frames/ | pricetag_demo의 대상 프레임 |