스프링 (코스 스텝 08)
고정 곡선 위에서 A에서 B로 가는 저렴한 모션 이징. 질량을 가진 모션은 가속되고, 약간 오버슈트한 후 안정됩니다.
lib/motion.js의 스프링은 폐쇄형(closed-form) 스텝 응답이므로 순수한 시간 함수로 유지됩니다. 즉, 812번 프레임을 렌더링할 때 0번부터 811번 프레임을 시뮬레이션할 필요가 없으며, seek(t)는 결정론적입니다.
영화 프로젝트의 lib/motion.js에서 가져옵니다 (파일 기준 상대 경로: film/film.js에서는 ../lib/motion.js, film/scenes/*.js에서는 ../../lib/motion.js). 전체 프리셋 번호는 ${CLAUDE_SKILL_DIR}/references/presets.md에 있습니다 (references/presets.md).
1. API
| 함수 | 반환값 | 설명 |
|---|---|---|
sp(t, preset = 'default') | 0 ~ 1 | 일상적인 호출; t는 릴리스 이후 시간(lt - 0.2), 릴리스 전에는 0 |
spring(t, k, d, m = 1) / springVel(...) / springPV(...) | x / v / [x, v] | 원시 k/d 형태; 부족 감쇠, 임계 감쇠, 과감쇠 정확히 처리 |
SPRINGS | { snappy, default, heavy, playful } | {k, d} 쌍, 아래 표 참조 |
resolveSpring(p) | {k, d} | 프리셋 이름, {k, d} 또는 {duration, bounce}를 받아 스프링이 필요한 모든 곳에서 사용 |
springFromFeel({ duration, bounce }) / feelFromSpring({k, d}) | {k, d} / {duration, bounce} | 디자이너 친화적인 매개변수 (Apple 규칙) |
track(t, keys, spring = 'default') / trackVel(...) | 값 / 속도 | keys = [[time, value], ...] 정렬됨; 변경당 하나의 스프링, 합산됨; 세 번째 요소로 해당 변경의 스프링을 재정의 가능 ([2.4, 420, 'heavy']) |
loopTrack(t, keys, dur, spring = 'default', cycles = null) | 값 | 매끄러운 루프. 키 시간은 한 주기 0..dur 내에 있으며 감싸지지 않음 (범위 밖은 오류 발생). 마지막 값은 첫 번째 값과 같아야 함. 정확히 dur에 있는 키는 이음매 변경 지점 |
indicator(t, stops, { width = 120, lead = 'snappy', trail = {k: 140, d: 22} }) | { left, right } | 늘어나는 탭 표시기: 가장자리가 다른 스프링 위에 있음 |
swapAlpha(t, tIn, tOut, { inDelay = 0.08, inDur = 0.12, outLead = 0.1, outDur = 0.1 }) | 0 ~ 1 | 모핑 박스 내부의 텍스트: 형태 변화가 시작된 후에 나타나고, 다음 형태 변화 전에 사라짐 |
stagger(i, step = 0.03) | 초 | 항목 i의 지연 시간 |
stepTime(t, rate = 12) | 계단식 t | "2프레임 단위" 애니메이션용, 카메라나 전체 페이드에는 사용하지 않음. c.frameLt (또는 c.frameT) 전달, 출력 프레임 시간, 스텝 사이의 하드 컷용; c.t / lt는 서브프레임 시간이며 스텝이 변경되는 프레임에서 두 스텝을 혼합 |
loopT(t, dur) | t가 [0, dur)로 감싸짐 | 시간 감싸기; 스프링에 단독으로는 충분하지 않음 (loopTrack 사용) |
settleTime(spring, eps = 0.01) / overshoot(spring) | 초 / 비율 | 홀드 및 컷 포인트 계획 |
easeOutCubic, easeInOutCubic | 0 ~ 1 | 비물리적 페이드(불투명도)에만 사용; 움직이는 요소에는 절대 사용하지 않음 |
2. 프리셋
| 프리셋 | k / d | 감쇠비 | 오버슈트 | 안정화 시간 (1%) | 용도 |
|---|---|---|---|---|---|
snappy | 320 / 30 | 0.839 | 0.79% | 0.24 초 | 버튼, 토글, 선행 가장자리, 커서 |
default | 170 / 26 | 0.997 | 0 | 0.51 초 | 카드, 컨테이너, 카메라 |
heavy | 90 / 20 | 1.054 | 0 | 0.78 초 | 큰 글자, 3D 객체, 로고 락업 |
playful | 220 / 14 | 0.472 | 18.6% | 0.59 초 | 마스코트, 스티커 |
하우스 룰: UI에는 약간의 오버슈트 (snappy), 텍스트에는 오버슈트 없음 (default 또는 heavy를 히어로 텍스트의 크기와 위치에 사용), playful은 오버슈트 자체가 개그인 경우에만 사용. 전체 숫자, 느낌 변환 및 공식: references/presets.md.
3. 레시피
씬 draw(g, lt, c) 내부: lt는 씬이 시작된 이후 시간, c.t는 필름 시간, c.L은 레이아웃, c.brand는 브랜드 토큰, c.grid는 비트 그리드, c.film.dur은 필름 길이 (c.dur는 씬 길이). 모션 블러가 켜져 있으면 c.t와 lt는 칠해지는 서브프레임 시간 (모션 블러 자체); c.frameT / c.frameLt는 출력 프레임의 시간이고 c.frame은 그 인덱스이며, 모든 서브프레임에 대해 동일합니다. 스니펫은 const { t, L } = c;와 lib/motion.js, lib/draw.js 및 lib/rng.js의 임포트를 가정합니다.
원샷 진입 (씬 시작 후 0.15초에 릴리스):
const s = sp(lt - 0.15, 'snappy');
withTransform(g, { x: L.cx, y: lerp(L.cy + 80 * L.u, L.cy, s), s: lerp(0.92, 1, s) }, () => { /* 그리기 */ });
이 코드는 처음부터 보입니다: 스프링이 0인 동안 위치와 크기가 시작 값에 있으므로 프레임 0이 비어 있지 않습니다. 만약 s가 불투명도나 클립을 통해 화면의 유일한 것을 구동한다면 비어 있을 것입니다. 프레임 0에서 화면에 표시되는 씬(후크)의 경우, 씬 이전에 스프링을 릴리스하여 중간 동작부터 시작합니다: sp(lt + 0.3, 'snappy'), 또는 kinetic(g, '움직여라.', x, y, lt + 0.3, { ... }), 또는 kinetic(..., { delay: -0.3 }). lt = 0에서 텍스트는 그려지지 않는 대신 상승 시작 후 0.3초 지점에 있습니다 (kinetic은 스프링이 여전히 0인 모든 글리프를 건너skip). 크리틱은 빈 프레임 0을 P0으로 플래그합니다 (frame 0 is nearly empty).
여러 대상을 가진 값 (스프링을 다시 시작하지 마세요; 변경당 하나씩 추가):
// 논리적 px 단위의 커서 x: 200에서 정지, 1.0초와 2.4초에 이동, 3.6초에 복귀
const cx = track(t, [[0, 200 * L.u], [1.0, 640 * L.u], [2.4, 420 * L.u], [3.6, 200 * L.u]], 'snappy');
첫 번째 키의 시간은 무시됩니다: 해당 값은 시작부터의 정지 값입니다. 그 이후의 모든 변경은 자체 시간에 자체 스프링을 시작하며, 마지막 스프링이 안정되기 전에 새 대상이 도착하더라도 합계는 위치와 속도에서 연속성을 유지합니다.
원샷 형태 변화 (컨테이너는 절대 끊기지 않음; 모든 속성은 동일한 키 시간의 트랙):
const K = [0, 1, 2, 3].map((n) => c.grid.bar(n)); // 그리드에서 다운비트의 상태 변경
const w = track(t, [[K[0], 320], [K[1], 120], [K[2], 760], [K[3], 320]].map(([k, v]) => [k, v * L.u]));
const h = track(t, [[K[0], 96], [K[1], 120], [K[2], 480], [K[3], 96]].map(([k, v]) => [k, v * L.u]));
const r = track(t, [[K[0], 48], [K[1], 60], [K[2], 32], [K[3], 48]].map(([k, v]) => [k, v * L.u]));
fillRoundRect(g, L.cx - w / 2, L.cy - h / 2, w, h, Math.max(0, r), c.brand.colors.fg);
withAlpha(g, swapAlpha(t, K[1], K[2]), () => ring(g, L.cx, L.cy, 36 * L.u, sp(t - K[1] - 0.1), { color: c.brand.colors.accent }));
색상: 0-to-1 진행률을 스프링하고 lib/draw.js의 mixColor(a, b, p)와 혼합 (p를 클램프함). 또는 여러 대상을 가진 색상의 경우 각 채널을 트랙하고 0~255로 클램프합니다. 0 미만으로 오버슈트할 수 있는 반경 및 크기는 Math.max(0, ...)가 필요합니다.
스탑 사이를 늘어나는 탭 표시기:
const { left, right } = indicator(t, [[0, x0], [1.5, x1], [3.0, x2]], { width: 140 * L.u });
fillRoundRect(g, left, y, right - left, 6 * L.u, 3 * L.u, c.brand.colors.accent);
매끄러운 루프 (값과 속도가 이음매에서 일치):
// 6초 루프: a에서 정지, 1.5초에 b, 3초에 c2, 4.5초에 a로 복귀
const x = loopTrack(t, [[0, a], [1.5, b], [3, c2], [4.5, a]], c.film.dur, 'default');
// 복귀를 이음매 변경으로 하는 동일한 루프: 마지막 키가 정확히 dur에 위치
const y = loopTrack(t, [[0, a], [1.5, b], [3, c2], [c.film.dur, a]], c.film.dur, 'default');
loopTrack 규칙 (lib/motion.js에 대해 확인됨):
| 규칙 | 세부사항 |
|---|---|
키 시간은 0..dur 내에 유지 | 주기 상대적이며 절대 감싸지지 않음; 범위 밖의 시간은 loopTrack: key <i> time <t> is outside 0..<dur> 오류 발생 (그리드 산술에서 dur을 약간 초과하는 것은 허용됨) |
| 첫 번째 키는 정지 값 | 해당 시간은 무시됨 (여전히 0..dur 내에 있어야 함); 값은 첫 번째 변경이 시작되는 값 |
| 마지막 값은 첫 번째 값과 같음 | 그렇지 않으면 the last value (...) must equal the first (...) 오류 발생 |
dur에 있는 키는 이음매 변경 | 스프링은 다음 주기의 t = 0에서 시작: 프레임 0 (= 프레임 dur)은 이음매 이전 값을 표시하고 첫 번째 값으로 이징됩니다. [[0, pre], [0, post], ...]를 작성하는 것과 같음. 이음매 변경을 0 또는 dur에 한 번만 작성 |
dur 직전의 변경은 프레임 0에서 여전히 움직일 수 있음 | 합계는 정확히 주기적이므로 타이밍에 관계없이 위치와 속도가 이음매에서 일치합니다. 정지 프레임에서 열려면 마지막 변경을 dur보다 최소 settleTime(preset) 이전에 유지 (기본값의 경우 0.51초) |
| 주기(cycles) | 합산된 이전 주기의 수는 안정화 시간과 최신 키를 따르므로 늦은 키도 안전함; cycles는 이를 재정의 |
일반 loopT와 track은 끝 근처에서 해제된 스프링이 t = 0에서 여전히 움직이기 때문에 이음매에서 점프합니다. loopTrack은 또한 이전 주기의 스프링을 합산하며 (안정화에 충분한 양) 키가 [[0, 0], [2, 100], [4, 40], [6, 0]]이고 dur이 6인 경우 t = 1 / 3 / 5에서 값 0.001 / 99.997 / 40.002를 제공합니다. npm run critique 후 out/review/<fmt>/loop.png에서 이음매를 확인하세요: |last - first|는 일반적인 한 단계처럼 보여야 하고 |end - first| (감싸지지 않은 최종 상태)는 검은색이어야 합니다.
지연 팝 (요소별 시드, 절대 공유 스트림 없음):
for (let i = 0; i < n; i++) {
const r = rngFor('tile', i);
const s = sp(lt - stagger(i, 0.035) - range(r, 0, 0.06), 'playful');
// 타일 i를 s로 스케일링하여 그리기
}
키네틱 타입: kinetic(g, str, x, y, lt, { size, family, weight, color, spring: 'snappy', stagger: 0.035, rise: 0.6, by: 'char' | 'word', mask, delay, alpha, align, baseline, style, tracking }). family는 기본적으로 brand.fonts.display로 설정되고 weight는 패밀리가 등록한 가장 가까운 weight로 설정되므로, 디자인에 다른 얼굴이 필요하지 않으면 둘 다 생략하세요. mask: true는 실행을 라인 상자로 클리핑하여 글리프가 페이드 대신 가장자리 뒤에서 떠오르도록 합니다; delay는 전체 실행을 이동시킵니다 (음수는 중간 동작에서 시작). 히어로 타입의 경우, 상승이 0.8% 오버슈트를 볼 수 있을 만큼 클 때는 spring: 'default' 또는 'heavy'를 전달하세요. 여러 줄 복사: wrapText(g, text, maxW, font(size, family))는 줄을 반환합니다 (한글 음절 내부에서 절단하지 않음); y + i * 1.2 * size 이상으로 그리고 각 줄에 자체 delay를 부여하여 그립니다.
2프레임 단위 드로잉 (손으로 그린 느낌): const td = stepTime(c.frameLt, 12) (출력 프레임 시간, 모션 블러가 켜져 있어도 각 단계가 하드 컷); 카메라 이동, 페이드 및 UI는 연속적인 lt로 유지하거나, 팬은 초당 12번 스텝하여 지연으로 읽힙니다.
4. 전체 영화 리팩터링
프로젝트의 프롬프트 템플릿을 사용하세요: prompts/refactor-springs.txt를 읽고 따르세요 (또는 작업으로 붙여넣으세요). 이 템플릿은 무언가를 움직이는 모든 선형 보간 및 기본 이징을 프리셋, track(), loopTrack(), indicator() 및 swapAlpha()로 대체하고, 타이밍을 유지하며 각 변경 사항을 보고합니다. 그런 다음:
npm run lint(오류 없어야 함).npm run stills및node tools/critique.mjs --strip-at <t>를 가장 바쁜 순간에 실행:strip.png는 12개의 연속 프레임을 보여주며, 콘택트 시트가 숨기는 팝, 재시작 및 슬라이드를 노출합니다.- 다음 크리틱 라운드 (
/motion-studio:critique-loop)에서 변경 사항을 기록합니다.
5. 잡아야 할 실수
| 실수 | 어떻게 보이는가 | 수정 방법 |
|---|---|---|
각 대상에서 스프링 다시 시작 (sp(t - tNew)를 이전 값에서 사용) | 속도가 0으로 스냅, 눈에 띄는 꺾임 | track()에 모든 대상 포함 |
| 자체 시작 값을 가진 스프링을 수동으로 합산 | 두 변경이 겹칠 때 점프 | 값당 하나의 track(); 변경별 프리셋은 키의 세 번째 요소에 입력 |
스프링 값에 loopT 단독 사용 | 이음매에서 점프 | 키가 0..dur 내에 있고 마지막 값 == 첫 번째 값인 loopTrack() 사용 |
| 텍스트에 오버슈트 | 텍스트 흔들림, 저렴해 보임 | 텍스트에는 default / heavy 사용 |
UI 크롬에 playful 사용 | 장난감 같은 인터페이스 | UI에는 snappy 사용 |
| 위치는 선형인데 불투명도에만 스프링 적용 | 페이드는 좋지만 슬라이드는 저렴해 보임 | 위치를 스프링; 불투명도는 easeOutCubic을 따를 수 있음 |
| 모든 것이 동일한 프리셋과 지연 시간 사용 | 기계적, 계층 구조 없음 | snappy로 선도하고, default로 후행하며, 나머지는 stagger() 처리 |
다음: /motion-studio:sound-design으로 모션을 비트에 고정, 그런 다음 /motion-studio:critique-loop.