스틱맨 애니메이터
당신은 **scenes.js**를 작성합니다 - film.json의 각 클립에 대해 하나의 film.scene(id, sc => { … }), 동일한 id, 동일한 순서로. 모든 것은 전역 SM 엔진을 대상으로 하는 평범한 브라우저 JS입니다. 작성하기 전에 references/api.md(전체 요약본) 및 references/cookbook.md(복사-붙여넣기 레시피)를 읽으십시오.
멘탈 모델
- 로컬 시간. 장면 내에서 모든 시간은 클립 시작부터의 초 단위입니다.
sc.dur= 클립 길이. - 체인 가능. 모든 액션은 종료 시간을 반환합니다:
const t = bob.walkTo(900, 0.2); bob.wave(t); - 음성 동기화.
sc.cue("단어")= 내레이터가 그 단어를 말하는 예상 로컬 시간(sc.cue(["단어", 1])= 두 번째 발생,sc.cue(0.5)= VO의 중간 지점). 시각 요소를 단어 상단 또는 바로 앞에 배치하십시오(sc.cue("아이디어") - 0.15). - 레이어.
world(환경) →back(소품) → 피규어 →front(피규어 위 소품) →ui(화면 공간, 카메라 무시) →top(전환). 소품에{ layer: "front" }/"ui"를 전달하십시오. - 좌표. 캔버스는
sc.W × sc.H(1920×1080, 1080×1920 또는 1080×1080)입니다.sc.groundY는 바닥입니다(가로에서 80% 아래, 세로에서 74% 아래). 피규어는y= 피트 위치에 서 있습니다. - 사물. 소품, 텍스트, 차트, 도형은
Thing입니다:.pop(t) .fadeIn(t) .rise(t) .dropIn(t) .slideIn(t,d,dir) .moveTo(x,y,t,d) .arcTo(x,y,t,d,h) .scaleTo .rotateTo .spin .pulse .shake .wobble .bob(t0,t1) .glow .tint .draw .fadeOut .popOut .hide .show. - 등장 전까지 숨김.
{ hidden: true }로 생성한 후.pop(t); 텍스트는.in(t, fx)까지 숨겨집니다.
장면 스켈레톤
const film = SM.film(); // 테마/포맷은 film.json에서 옴
film.scene("hook", sc => {
sc.enter("fade"); // 선택 사항, 이전 종료와 일치
sc.ground(); // 바닥선 (스타일: "grass" | "none")
const bob = sc.figure({ x: -150, face: "dots" }); // 또는 sc.character("zeke", {...})
const t1 = bob.walkTo(sc.W * 0.35, 0.2);
bob.point(sc.W * 0.7, sc.H * 0.4, sc.cue("this"));
const chart = sc.barChart({ x: sc.W * 0.68, y: sc.H * 0.45, data: [{ label: "2024", value: 4 }, { label: "2025", value: 9 }] });
chart.grow(sc.cue("grew"));
sc.text("Revenue [doubled]", { x: sc.W * 0.68, y: 150, size: 80 }).in(sc.cue("doubled") - 0.1, "words");
sc.camera.focus(sc.W * 0.6, sc.H * 0.5, 1.12, 1.0, 3); // 느린 푸시
sc.exit("wipe-left");
});
인트로 및 아웃트로
film.json에서 "intro" / "outro"를 선언한 클립은 자체적으로 빌드됩니다. 이를 위한 장면을 작성할 필요가 없습니다. 추가 요소(제목 주위에 터지는 소품, CTA에 손을 흔드는 피규어)를 추가하려면 장면을 작성하고 프리셋을 직접 호출하십시오. 그러면 자동 버전은 건너뜁니다:
film.scene("intro", sc => {
const t = sc.intro("countdown", sc.clip.intro); // 제목이 안착된 시간 반환
sc.prop("rocket", { x: 1500, y: 300, size: 120, layer: "ui", hidden: true }).pop(t - 0.8);
sc.exit("wipe-left");
});
film.scene("outro", sc => {
sc.enter("fade", { color: "bg" });
sc.outro("kino", sc.clip.outro);
sc.figure({ x: 1500 }).point(1150, 830, 1.2);
});
연출 규칙 (멋지게 보이게 하는 법)
- 2-3초마다 무언가 변경됩니다. 클립당 3비트(beat)를 계획하십시오; 빈 공간을 카메라 푸시, 깜빡임/고개 끄덕임, 소품 바운스, 하이라이트로 채우십시오.
- 애니메이션 전에 무대를 설정하십시오. 피규어, 주요 소품 및 텍스트가 배치될 위치를 결정하십시오(16:9에서는 3분할, 9:16에서는 쌓기). 텍스트를 피규어의 머리 및 다른 텍스트로부터 멀리 유지하십시오.
- 피규어는 서 있지 않고 행동합니다. 의미 있는 제스처를 사용하십시오: 논의되는 것을
point, 아이디어 전에think, 공개 시surprise, 신화에shrug, 승리에celebrate, 노력에push/climb/runTo. - 한 번에 하나의 초점이 되는 등장; 여러 개가 나타날 때 0.1-0.2초 간격을 두십시오.
- 클립 간 종료와 시작을 일치시키거나(동일한 전환 유형) 매치 컷(동일한 포즈/객체 위치)을 사용하십시오.
- 색상은 의미를 전달합니다:
"a1"문제,"a2"해결책,"a3"보상. 색상 이름을 전달하십시오:"a1" | "a2" | "a3" | "ink" | "muted" | "soft" | "paper"또는 16진수. - 기준 진실: 피규어는
sc.groundY(또는 계산한 표면) 위에 서 있습니다; 바닥에 놓이는 소품은y = sc.groundY - size*0.4를 사용합니다. - 세로: 피규어
size: 420-460, 소품 200-300, 텍스트 70-120, 중간 영역을 바쁘게 유지하고 캡션은 낮게 배치하십시오.
검증 (필수 루프)
stickman check <dir>→ 반드시 Check passed를 출력해야 합니다.page_error= JS에서 오류 발생; 수정하십시오.stickman snapshot <dir>(또는--at시간으로 주요 비트 지정) →snapshots/contact-sheet*.jpg및 PNG 파일을 열고 확인하십시오. 수정: 클리핑, 겹침, 공중에 뜬 피규어, 빈 시간, 읽을 수 없는 텍스트, 팔이 머리를 통과하는 경우(포즈 오버라이드 조정), 잘못된 악센트 색상.- 깔끔해질 때까지 다시 실행한 후 렌더링하십시오.
주의사항
- 각 피규어를 시간순으로 스케줄하십시오.
celebrate()는 +1.0초 후stand로 돌아오도록 스케줄합니다; 곧 다시 포즈를 취할 경우{ hold: true }를 전달하십시오. bob.hold(prop)는 오른손에 부착되고 똑바로 유지됩니다; 사용 전에 생성하고.pop(t)하십시오.- 텍스트 마크업:
"[강조된 단어]"는accent옵션(기본값a2)으로 구문에 색상을 입힙니다. - 차트는 이산 단계로 숫자를 셉니다; 차트 옵션에서
prefix/suffix/decimals를 제공하십시오. Math.random/Date/setTimeout을 사용하지 마십시오.SM.rng(seed)를 사용하십시오.- 원시 GSAP가 허용됩니다:
sc.tl.to(el, vars, sc.T(localTime))- 시간의 순수 함수로 유지하십시오.