모션-애니메이트
디자인은 프레임이 좋은지 결정합니다. 모션은 그것이 고급스러워 보이는지 결정합니다. 동일한 구도라도 선형 이징과 동시 등장으로 애니메이션하면 생성물처럼 읽히고, 아래 어휘를 사용하여 애니메이션하면 직접 제작한 것처럼 읽힙니다.
엔진 레시피: 부록 A, 부록 B.
네 가지 법칙
- 어떤 것도 선형이 아니다. 모든 속성은 이징(ease)을 따라 움직입니다. 선형 모션은 물리적 세계에 존재하지 않으며, 눈은 이를 즉시 알아차립니다.
- 어떤 것도 동시에 등장하지 않는다. 요소들은 의도적인 순서로 도착하며, 요소 간 간격은 60–120ms입니다. 동시 등장은 가장 큰 모션 오류 신호입니다.
- 카메라는 절대 완전히 정지하지 않는다. 모든 구성 아래에서 느리고 지속적인 푸시 또는 드리프트가 있어야 합니다. 정적 프레임은 슬라이드쇼처럼 읽힙니다.
- 어떤 것도 메트로놈처럼 규칙적이지 않다. 지속 시간과 컷 간격을 다양화하세요. 균일한 1초 비트는 각 비트가 아무리 좋아도 자동화된 느낌을 줍니다.
타이밍 테이블
30fps 기준 값; 60fps에 맞게 스케일 조정. 시간 단위는 ms.
| 요소 | 지속 시간 | 스태거 | 이징 |
|---|---|---|---|
| 텍스트 줄의 단어 | 400–550 | 60–90 | out-expo / power3.out |
| 텍스트 줄 (단위로) | 500–650 | 120–180 | out-cubic / power2.out |
| 아이콘 / 작은 UI 요소 | 350–450 | 80–120 | out-back (오버슈트 ≤1.06) |
| 패널 / 카드 | 550–700 | 140–200 | out-quint / power4.out |
| 히어로 객체 스케일 인 | 700–900 | — | out-expo |
| 히어로 객체 슬라이드 인 | 650–850 | — | out-quint |
| 선 / 스트로크 그리기 | 600–1000 | — | in-out-cubic |
| 카메라 푸시 (씬 당) | 전체 씬 길이 | — | out-sine, 또는 매우 느리면 선형에 가깝게 |
| 종료 (모든 요소) | 250–350 | 40–60 | in-cubic |
종료는 항상 등장보다 빠릅니다, 대략 절반 정도입니다. 대칭적인 아웃 애니메이션은 느리게 느껴집니다.
핵심 동작들
텍스트 — 팝-블러-페이드, 단어별로
핵심 동작입니다. 모든 속성이 단어별로 스태거되어 함께 애니메이션됩니다.
y: +18px → 0
blur: 12px → 0
opacity: 0 → 1
ease: out-expo, duration 480ms, stagger 70ms
선택적으로 scale: 0.96 → 1을 추가하세요. 회전은 추가하지 마세요. 튕기지 마세요.
긴 줄의 경우 문자가 아닌 단어 단위로 스태거하세요 — 문자 스태거는 타자기 효과로 읽히고 너무 오래 걸립니다. 문자 스태거는 짧은 강조 단어 하나에만 사용하세요.
강조 단어
동일한 동작을 수행하지만 이웃보다 120–200ms 지연되고 추가 속성 하나(색상 변화, 1.04로의 스케일 증가, 또는 뒤에서 스쳐 지나가는 하이라이트 바)가 주어집니다. 가장 마지막에 도착하고 다르게 도착해야 합니다.
아이콘 및 UI
팝-페이드: scale 0.7 → 1, opacity 0 → 1, out-back, 오버슈트 1.06으로 제한. 1.1을 넘으면 싸구려 바운스처럼 읽힙니다.
순차 규칙: 앵커 요소가 먼저 등장하고, 그 다음에 종속 요소가 등장합니다. 카드가 등장하고, 그 다음에 그 아이콘이, 그 다음에 그 레이블이 등장합니다. 절대 역순으로 하거나 함께 하지 마십시오.
패널 / 카드 / 글라스
y: +40 → 0, opacity 0 → 1, out-quint, 600ms, 스택 전체에 걸쳐 160ms 스태거. 패널이 착지한 후 150ms 뒤에 패널을 가로지르는 광선 하이라이트를 추가하세요 — 패널이 도착한 다음 빛을 받는 효과입니다.
히어로 객체
두 가지 옵션, 아키타입에 따라 선택:
- 스케일 인:
scale 1.25 → 1.00및rotate 3° → 0°,out-expo, 800ms. 제자리에 안착하는 느낌. - 슬라이드 인: 프레임 밖에서 2° 기울기가 0°로 해소되며,
out-quint, 750ms. 전달되는 느낌.
드롭 섀도우와 클리핑 텍스처는 히어로와 함께 움직이도록 히어로에 부모-자식 관계로 연결되어야 합니다. 부모 관계가 없는 그림자가 독립적으로 미끄러지는 것은 심각한 실패입니다.
스트로크 / 선 그리기
경로 길이 0 → 100% 애니메이션, in-out-cubic, 600–1000ms. 안으로 그리고 밖으로 이징 — 최고 속도로 시작하는 그리기는 기계적으로 보입니다. 레이블을 대상에 연결하거나, 강조 단어에 밑줄을 긋거나, 차트를 따라 그리는 데 사용하십시오.
카메라
모든 구성 아래에서 다음 중 하나:
- 푸시 인: 전체 비트 동안
scale 1.00 → 1.08,out-sine. - 푸시 아웃:
scale 1.12 → 1.00, 시작은 더 빠르고, 안정화됨. - 드리프트: 비트 동안
x또는y2–4% 이동.
떨림 방지 규약:
- 래퍼 요소에 애니메이션을 적용하고, 레이아웃이나 클리핑을 소유한 요소에는 절대 적용하지 마십시오.
transform만 사용하십시오 — 절대top/left/width/height를 사용하지 마십시오.- 가장자리가 드러나지 않도록 움직이는 레이어를 프레임보다 약 6% 더 크게 스케일 업하십시오.
will-change: transform을 설정하고 GPU 컴포지팅을 강제하십시오.- 총 이동 거리를 작게 유지하십시오. 큰 카메라 움직임은 모든 반올림 오류를 증폭시킵니다.
비트 간 전환
- 하드 컷을 SFX 히트로 마스킹 — 기본값. 디자인된 프레임 간의 크로스페이드는 둘 다 흐릿하게 만듭니다.
- 스케일 스루 — 요소가 프레임을 채우도록 확대되고 다음 장면이 그 안에서 드러납니다.
- 모양에 의한 와이프 — 원이나 패널이 프레임 가장자리를 넘어 확장되어 다음 장면을 가져옵니다.
디자인된 두 구성을 크로스페이드하지 마십시오. 기본 전환 프리셋을 사용하지 마십시오.
금지 사항
- 보이는 모든 것에 대한 선형 이징.
- 바운스 오버슈트 >1.1 (예외: 의도적으로 장난기 있는 SaaS/제품 스타일, 그리고 그것이 일관된 경우).
- 모든 요소가 동일한 프레임에 등장하는 것.
- 편집 전반에 걸친 균일한 비트 길이.
repeat: -1또는 무한 루프 — 렌더는 프레임 샘플링되며 결정론적이어야 합니다.- 컴포지션 내부의
Math.random(),Date.now()또는 네트워크 페치. 동일한 입력은 매번 동일한 프레임을 생성해야 합니다. - 프레임워크가 이미 제어하는 래퍼에 적용된 모션 (부록 B §클리핑 규칙 참조).
자가 점검
렌더를 0.25배 속도로 스크러빙하세요. 질문하세요:
- 갑자기 시작하거나 멈추는 것이 있는가? → 이징 누락.
- 모든 것이 동시에 착지하는가? → 스태거 누락.
- 프레임이 완전히 정지해 있는가? → 카메라 누락.
- 연속된 비트가 드럼 비트처럼 느껴지는가? → 지속 시간이 너무 균일함.
- 움직이는 레이어의 가장자리가 드러나는가? → 오버스케일 부족.
부록 A — Remotion 레시피
프레임 기반, 구조적으로 결정론적. 모든 타이밍은 useCurrentFrame()에서 파생됩니다.
도우미: 프레임이 아닌 ms 단위 시간
프레임 단위로 작성하면 fps가 하드코딩됩니다. 변환하세요.
import {useVideoConfig, useCurrentFrame, interpolate, Easing} from 'remotion';
const useMs = () => {
const {fps} = useVideoConfig();
return (ms: number) => (ms / 1000) * fps;
};
이징 매핑
타이밍 테이블의 이름, Remotion 용어로:
Easing.out(Easing.exp) // out-expo
Easing.out(Easing.cubic) // out-cubic
Easing.out(Easing.quad) // out-quad
Easing.out(Easing.poly(4)) // out-quint-ish
Easing.inOut(Easing.cubic) // in-out-cubic
Easing.out(Easing.sin) // out-sine
Easing.in(Easing.cubic) // in-cubic (종료)
Easing.bezier(0.16, 1, 0.3, 1) // 주요 이징 — expo 계열 out
오버슈트의 경우 Easing.back보다 spring을 선호하세요 — 미묘하게 유지하기가 더 쉽습니다.
import {spring} from 'remotion';
const s = spring({frame, fps, config: {damping: 200, stiffness: 120, mass: 0.6}});
// damping 200 = 눈에 띄는 오버슈트 없음. 약간의 안착을 위해 ~14로 낮추세요.
텍스트 — 팝-블러-페이드, 단어별로
const Words: React.FC<{text: string; delay?: number}> = ({text, delay = 0}) => {
const frame = useCurrentFrame();
const ms = useMs();
const STAGGER = ms(70);
const DUR = ms(480);
return (
<span style={{display: 'inline-flex', flexWrap: 'wrap', gap: '0.28em'}}>
{text.split(' ').map((word, i) => {
const local = frame - ms(delay) - i * STAGGER;
const p = interpolate(local, [0, DUR], [0, 1], {
extrapolateLeft: 'clamp',
extrapolateRight: 'clamp',
easing: Easing.bezier(0.16, 1, 0.3, 1),
});
return (
<span
key={i}
style={{
display: 'inline-block',
opacity: p,
filter: `blur(${(1 - p) * 12}px)`,
transform: `translateY(${(1 - p) * 18}px)`,
willChange: 'transform, filter, opacity',
}}
>
{word}
</span>
);
})}
</span>
);
};
강조 단어는 동일한 컴포넌트이지만 delay가 120–200ms 더 늦게 설정되고 고유한 색상과 scale(1.04)이 추가됩니다.
카메라 — 항상 켜져 있는 푸시
전체 씬을 래핑합니다. 가장자리가 드러나지 않도록 오버스케일하세요.
const Camera: React.FC<{children: React.ReactNode; durationInFrames: number}> = ({
children, durationInFrames,
}) => {
const frame = useCurrentFrame();
const scale = interpolate(frame, [0, durationInFrames], [1.0, 1.08], {
extrapolateRight: 'clamp',
easing: Easing.out(Easing.sin),
});
return (
<AbsoluteFill style={{transform: `scale(${scale})`, willChange: 'transform'}}>
{children}
</AbsoluteFill>
);
};
카메라는 바닥 레이어 위에, 그리고 프레임 가장자리에 고정되어야 하는 모든 요소 아래에 배치하세요.
스태거드 카드 스택
const cards = ['One', 'Two', 'Three'];
const ms = useMs();
{cards.map((label, i) => {
const local = frame - i * ms(160);
const p = interpolate(local, [0, ms(600)], [0, 1], {
extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
easing: Easing.out(Easing.poly(4)),
});
return (
<div key={i} style={{
opacity: p,
transform: `translateY(${(1 - p) * 40}px)`,
}}>{label}</div>
);
})}
종료 — 등장 시간의 절반
const exitStart = durationInFrames - ms(300);
const out = interpolate(frame, [exitStart, durationInFrames], [1, 0], {
extrapolateLeft: 'clamp', extrapolateRight: 'clamp',
easing: Easing.in(Easing.cubic),
});
구조
비트당 <Sequence from={...} durationInFrames={...}>를 motion-plan 테이블에서 직접 가져와 사용하세요. 행당 하나의 Sequence입니다. 비트 지속 시간은 계획에서 가져오며, 반올림된 숫자가 아닙니다.
<Series>
<Series.Sequence durationInFrames={ms(5200)}><BeatTwo /></Series.Sequence>
<Series.Sequence durationInFrames={ms(2100)}><BeatThree /></Series.Sequence>
</Series>
결정론
- 절대
Math.random()— 분산이 필요하면 요소 인덱스에서 시드하세요. - 절대
Date.now()또는new Date(). - 컴포넌트 내부에서 절대 fetch하지 마세요.
staticFile()/delayRender()로 미리 로드하세요. <Video>/<Audio>는 렌더 정확성을 위해 가능하면<OffthreadVideo>여야 합니다.
주의 사항
- 많은 요소에 동시에
filter: blur()를 적용하는 것은 비용이 많이 듭니다 — 동시 블러 노드를 제한하거나, 에셋에서 미리 블러를 적용하세요. - 폰트 로딩:
@remotion/google-fonts를 사용하거나, 로컬FontFace.load()주변에delayRender를 사용하세요. 그렇지 않으면 첫 번째 프레임이 폴백 폰트로 렌더링됩니다. - 입력 범위가 단조 증가하지 않으면
interpolate가 오류를 발생시킵니다 — 계산된 범위를 보호하세요. - 값이 범위를 벗어나도록 특별히 의도하지 않는 한 항상
extrapolateLeft/extrapolateRight: 'clamp'를 전달하세요.
부록 B — HyperFrames / GSAP 레시피
HyperFrames는 HTML + GSAP을 구성하고 헤드리스 브라우저의 프레임 샘플링을 통해 렌더링합니다. 결정론은 필수입니다.
npx hyperframes docs를 실행하여 현재 API를 확인하세요. 이 파일은 그 위에 있는 모션 표준입니다 — 파이프라인(init → preview → lint → render)에 대해서는 hyperframes 스킬을 참조하세요.
클리핑 규칙 (위반 시 렌더링 중단)
모든 시간 지정 요소에는 data-start, data-duration, data-track-index 및 class="clip"이 필요합니다. 프레임워크는 .clip에 대한 가시성과 변환을 소유합니다.
절대 .clip 요소 자체를 GSAP으로 애니메이션하지 마십시오. 자식 래퍼를 애니메이션하세요.
<div class="clip" data-start="4.2" data-duration="5.2" data-track-index="2">
<div class="cam"> <!-- 카메라 움직임 -->
<div class="inner"> <!-- 요소 모션 -->
<h1 class="headline">…</h1>
</div>
</div>
</div>
타임라인 등록
const tl = gsap.timeline({paused: true});
window.__timelines['main'] = tl; // id는 data-composition-id와 일치해야 함
항상 일시 중지(paused) 상태입니다. 렌더러가 이를 seek합니다.
이징 매핑
| 테이블 이름 | GSAP |
|---|---|
| out-expo | expo.out |
| out-cubic | power2.out |
| out-quint | power4.out |
| out-back (제한됨) | back.out(1.2) |
| in-out-cubic | power2.inOut |
| out-sine | sine.out |
| in-cubic (종료) | power2.in |
텍스트 — 팝-블러-페이드, 단어별로
작성 시점에 단어 스팬으로 분할하십시오 (런타임 분할기에 의존하지 마십시오 — 첫 번째 샘플링된 프레임과 경쟁할 수 있습니다).
<h1 class="headline">
<span class="w">What</span> <span class="w">looks</span>
<span class="w accent">like</span> <span class="w">discipline</span>
</h1>
tl.from('.headline .w', {
y: 18,
opacity: 0,
filter: 'blur(12px)',
duration: 0.48,
ease: 'expo.out',
stagger: 0.07,
}, 0);
// 강조 단어는 마지막에 도착하고 다르게 도착함
tl.from('.headline .accent', {
scale: 0.96,
color: 'var(--surface)',
duration: 0.5,
ease: 'expo.out',
}, 0.18);
카메라
.cam을 애니메이션하고, 절대 .clip을 애니메이션하지 마십시오.
tl.fromTo('.cam',
{scale: 1.0},
{scale: 1.08, duration: 5.2, ease: 'sine.out', force3D: true},
0);
.cam { will-change: transform; transform: translateZ(0); }
푸시 아웃 또는 드리프트 중에 가장자리가 드러나지 않도록 움직이는 레이어를 프레임보다 약 6% 더 크게 오버스케일하세요.
스태거드 카드 스택
tl.from('.card', {
y: 40, opacity: 0,
duration: 0.6, ease: 'power4.out', stagger: 0.16,
}, 1.2);
// 광선 스위프는 패널이 착지한 후 150ms 뒤에 착지
tl.fromTo('.card .sweep', {xPercent: -140}, {
xPercent: 140, duration: 0.7, ease: 'power2.inOut', stagger: 0.16,
}, 1.35);
스트로크 그리기
tl.fromTo('.connector', {drawSVG: '0%'}, {drawSVG: '100%', duration: 0.8, ease: 'power2.inOut'});
// DrawSVGPlugin이 없으면? stroke-dasharray/offset 사용:
tl.fromTo('.connector', {strokeDashoffset: 1000}, {strokeDashoffset: 0, duration: 0.8, ease: 'power2.inOut'});
엄격한 규칙
- 결정론적 전용 —
Math.random(),Date.now(), fetch,repeat: -1금지. - 9:16 = 1080×1920.
#root { container-type: size; }를 설정하고 모든 것을cqw/cqh(1cqw = 10.8px)로 크기 조정하고, 절대vw/vh를 사용하지 마십시오. - 인접한 동일 트랙 클립은 서로 닿아서는 안 됩니다. 부동 소수점 연산으로 인해
3.2 + 0.35 = 3.5500000000000003이 되어3.55에서 시작하는 클립과 겹쳐overlapping_clips_same_track오류가 발생합니다. 간격을 두거나0.34와 같은 지속 시간을 사용하세요. - 오디오: 비디오는
muted입니다; 하나의 사전 혼합 마스터<audio>트랙(VO + SFX를 ffmpegadelay+amix로 혼합)을 높은 전용data-track-index에 사용하세요. 여러 개의 개별 오디오 트랙을 사용하지 마십시오 — 프레임 정확도가 깨집니다. - 렌더링은 로컬에서 1280×720의 HTTP 서버에서 수행해야 하며
--no-sandbox플래그로 렌더링됩니다. 렌더링 노드는xvfb또는virtual-display가 필요합니다. 클라우드 CI에서는XVFB액션을 사용하세요.
구조 예시
<div class="clip" data-start="0" data-duration="5.2" data-track-index="0">
<div class="cam">
<div class="scene scene-one">
<h1 class="headline">
<span class="w">Where</span> <span class="w">it</span>
<span class="w accent">starts</span>
</h1>
</div>
</div>
</div>
const tl = gsap.timeline({paused: true});
window.__timelines['main'] = tl;
tl.from('.headline .w', {
y: 18, opacity: 0, filter: 'blur(12px)',
duration: 0.48, ease: 'expo.out', stagger: 0.07,
}, 0.3);
tl.fromTo('.cam', {scale: 1.0}, {scale: 1.08, duration: 5.2, ease: 'sine.out', force3D: true}, 0);