플러그인 설치: 설정 또는 freshness 명령 전에, 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 실행 규칙을 따르세요. 독립 실행형 설치는 아래 업데이트 지침을 유지합니다.
HyperFrames Keyframes
키프레임은 포즈 계약입니다: 보이는 상태, 연속적인 주체 정체성, 시크-세이프 런타임, 검증된 픽셀.
광범위한 장면 레시피는 hyperframes-animation을 사용하세요. 전체 명령 문서는 hyperframes-cli를 사용하세요. references/keyframe-patterns.md는 시각적 스타일이 아닌 구현 메커니즘을 선택할 때만 참조하세요.
크리에이터 편집 경계
키프레임은 클립 조립이 아닌 시각적 모션을 담당합니다. 소스 범위 하드 컷, 트림, 스플라이스, 재정렬은 /hyperframes-core에 속합니다: 유지된 범위당 하나의 미디어 요소를 작성하고, data-start와 data-duration으로 배치하며, data-media-start로 소스 오프셋을 선택합니다. 인접한 범위는 하드 컷을 만듭니다. 크로스페이드는 다른 트랙에서 겹치는 클립과 시각적 불투명도 키프레임을 사용합니다; 사운드 페이드는 /hyperframes-audio를 사용합니다.
| 크리에이터 요청 | 진실된 메커니즘 |
|---|---|
| 펀치 인 / 펀치 아웃 | 클립 내부의 비시간 기반 시각적/크롭 래퍼에 scale과 x/y 또는 백분율 변환을 키프레임으로 적용합니다. 하드 펀치는 설정/짧은 트윈을, 부드러운 이동은 트윈을 사용합니다. |
| 부드러운 다중 상태 줌 또는 리프레임 | 하나의 주체 래퍼를 유지하고 여러 줌/리프레임 상태를 세그먼트별 이징이 있는 포즈 사다리로 작성합니다. |
| 팬, 리프레임 또는 켄 번스 카메라 움직임 | 래퍼 변환과 스케일을 애니메이션합니다. 지오메트리가 작성됩니다; 이것은 얼굴 추적이나 자동 의미론적 리프레이밍이 아닙니다. |
| 연쇄 카메라 움직임 | 하나의 등록된 시크-세이프 타임라인에 레이블이 지정된 변환 비트를 연결합니다. |
| 매치 컷 또는 휩 팬 | /hyperframes-animation이 시각적 핸드오프를 담당합니다; /hyperframes-registry가 프리미티브를 제공합니다; 키프레임은 작성된 지오메트리, 방향, 속도를 유지합니다. 자동 매칭 프레임 발견은 없습니다. |
| 크롭 및 마스크 리프레임 | 내부 시각적 래퍼에 clip-path 또는 마스크를 보간하여 소스 시간 변경 없이 크롭/리프레임합니다. 폴리곤 키프레임은 폴리곤/마스크 전환을 형성할 수 있습니다. |
| 방향성 와이프 컷 또는 아이리스/리빌 컷 | 겹치는 시각적 클립에 걸쳐 마스크/클립 경계를 애니메이션합니다; /hyperframes-animation이 핸드오프 choreography를 담당합니다. |
| 분할 화면 핸드오프 | 코어에 의해 배치된 두 시각적 클립을 유지한 다음, 내부 크롭/마스크 래퍼와 디바이더 지오메트리를 키프레임합니다. |
| 일정한 소스 리타임 | /hyperframes-core는 렌더-세이프 픽처와 피치 보존 사운드를 위해 정규화된 data-playback-rate (0.1..10)을 담당합니다. 전체 미디어 요소에 대해 일정합니다. |
| 소스 속도 램프 | <video>/<audio>의 data-automation에 rate 레인(클립 초 단위 t, 0.1..10 범위 v, 로그 보간); 일정한 속도보다 우선합니다. |
| 프리즈 / 홀드 | 시각적 포즈, 최종 소스 프레임 또는 완료된 하위 컴포지션을 유지할 수 있습니다. 임의의 중간 소스 프리즈는 지원되지 않습니다; 정지/파생된 세그먼트를 전처리하여 자체 클립으로 배치한 다음 다른 소스 범위로 재개합니다. |
픽처와 사운드를 함께 편집할 때는 /hyperframes-core, 시각적 모션을 위한 이 스킬, 배치된 트랙의 페이드, 크로스페이드, 볼륨 오토메이션, 덕킹/카브, 또는 효과를 위한 /hyperframes-audio를 로드하세요.
시각적 전환 또는 크롭 처리는 시간적 소스 트림 또는 스플라이스가 아닙니다. /hyperframes-core는 타임라인, 클립 타이밍, 소스 범위를 담당합니다; 키프레임은 해당 클립 내부의 래퍼에서 보이는 핸드오프 또는 크롭만 애니메이션합니다. 복사 가능한 결합 픽처/사운드 레시피는 /hyperframes-core → references/creator-editing-recipes.md를 사용하세요.
절차
- 애니메이션 대상, 보이는 상태, 최종 상태, 런타임을 식별합니다.
- 프롬프트를 증명하는 가장 작은 메커니즘을 선택합니다. 메커니즘이 명확하지 않은 경우에만
references/keyframe-patterns.md를 읽습니다. - 선언된 런타임에서 시크-세이프 키프레임을 작성합니다. 빌드가 완료된 후에만 런타임 인스턴스를 등록합니다;
document.fonts.ready내부에서 빌드하는 것은 괜찮습니다. hyperframes check(린트 실행),hyperframes keyframes, 하나의 집중된--shot, 증명 시점의 스냅샷으로 확인합니다.- 증명이 실패하면 소스 키프레임을 수정하고 렌더링 전에 가장 작은 실패 진단을 다시 실행합니다.
계약
- 움직이는 대상을 명명합니다.
- 최종 상태를 포함하여 의도된 모션을 증명하는 데 필요한 포즈를 명명합니다.
- 보이는 채널을 키프레임합니다. 숨겨진 헬퍼 상태는 키프레임하지 않습니다.
- 연속성이 중요할 때 객체 정체성을 유지합니다.
- 의도된 모션이 대체 또는 용해일 때만 크로스페이드합니다.
- 읽을 수 있거나 의미론적인 상태를 볼 수 있을 만큼 충분히 오래 유지합니다.
- 최종 프레임은 애니메이션의 일부입니다. 정리가 아닙니다.
- 요청되지 않은 한 휴식 상태로 재설정하지 마십시오.
- 요청되지 않은 한 검은색으로 끝나지 마십시오.
- 스타터 장면을 편집하는 경우, 재설계를 요청하지 않는 한 레이아웃, 사본, 에셋, 색상, 최종 상태를 유지합니다.
런타임 규칙
GSAP:
- 페이지 로드 시 또는
document.fonts.ready내부에서 빌드하고, 빌드가 완료된 후에만 등록합니다. gsap.timeline({ paused: true })를 사용합니다.window.__timelines[compositionId]로 등록합니다.- 레지스트리 키는
data-composition-id와 일치해야 합니다. - 렌더 크리티컬 모션을 위해
tl.play()를 호출하지 마십시오. - 반복을 유한하게 유지합니다.
CSS 키프레임:
- 유한한 지속 시간과 반복 횟수.
- 결정론적 지연.
animation-fill-mode: both- 타이밍이 클립에 속할 때
data-start를 사용합니다.
Anime.js:
- 동기적으로 생성합니다.
autoplay: false- 유한한 지속 시간과 루프.
- 모든 인스턴스를
window.__hfAnime에 푸시합니다.
WAAPI:
- 유한한
duration fill: "both"- 결정론적 구성.
- 텍스트 표면에는 WAAPI가 나열되지 않습니다;
--shot(WAAPI를 탐색) 및 스냅샷으로 확인합니다.
렌더 크리티컬 모션에 절대 사용하지 마십시오:
Date.now()performance.now()- 시드되지 않은
Math.random() - 호버/스크롤 트리거
- 타이머
- 비동기 빌드가 완료되기 전에 등록된 타임라인
- 등록되지 않은
requestAnimationFrame - 무한 루프
GSAP 스켈레톤
const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });
tl.addLabel("state-a", 0);
tl.to(".subject", {
keyframes: [
{ x: 0, opacity: 1, duration: 0.2 },
{ x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
{ x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
],
ease: "none",
});
window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;
의미론적 상태에는 레이블을 사용하세요. 연결된 지연 대신 위치 매개변수를 사용하세요. 동일한 속성을 건드리는 나중의 from()/fromTo() 트윈에는 immediateRender: false를 사용하세요.
키프레임 형식
- 배열 키프레임: 단계별 지속 시간/이징이 있는 포즈 사다리.
- 백분율 키프레임: 하나의 트윈 내 정확한 타이밍.
- 속성 배열: 간결한 다중 중지 변경.
- 각 중지가 자체 이징을 가질 때 부모에
ease: "none". - 모든 세그먼트가 동일한 느낌을 공유해야 할 때
easeEach.
예제에서 숫자 거리나 타이밍을 복사하지 마십시오. 실제 컴포지션 지오메트리와 지속 시간에서 파생하십시오.
두 상자 사이를 이동하는 하나의 주체의 경우, 하나의 연속적인 변환 트윈 또는 FLIP을 선호합니다. 뷰어가 별개의 비트를 느껴야 할 때만 x/y/scale을 여러 개의 이징된 키프레임으로 분할하십시오; 모든 세그먼트는 속도를 변경하며 걸림으로 읽힐 수 있습니다.
채널
컴포지터/시각적 채널을 선호합니다: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, 마스크, CSS 변수, SVG 경로/대시 값, 카메라 변환, 셰이더 유니폼.
레이아웃/라이프사이클 채널을 피하십시오: top/left/right/bottom, width/height, margin/padding, display, visibility, 늦은 DOM 생성, 주체 모션을 수행하는 헬퍼 오버레이.
가시성 변경에는 등록된 탐색 가능 GSAP 타임라인의 autoAlpha 또는 명시적 경계에서의 지속 시간이 0인 tl.set()을 사용하십시오. 클립이 아닌 요소 또는 클립 내부의 래퍼만 대상으로 지정하십시오; 절대 .clip 자체를 대상으로 지정하지 마십시오. 절대 원시 visibility를 지속 시간 트윈하지 말고 display를 트윈하지 마십시오.
메커니즘 선택
프롬프트를 증명하는 가장 작은 메커니즘을 선택하십시오:
| 필요 | 메커니즘 |
|---|---|
| 동일한 주체가 상자 또는 계층 구조를 변경 | 공유 요소 / FLIP |
| 주체가 보이는 경로를 따라 이동 | 경로 트래블 |
| 획이 성장하거나 추적 | 획 드로우 |
| 한 모양이 다른 모양이 됨 | 모양 보간 |
| 리빌 경계가 보임 | 클립, 마스크 또는 셰이더 유니폼 |
| 여러 항목이 순서대로 이동 | 스태거 / 인덱스 지연 |
| 텍스트 자체가 이동 | 라인, 단어, 문자 또는 밴드 세분화 |
| 표면이 구부러지거나, 늘어나거나, 크롭 | 부모/자식 카운터 변환 |
| UI에 상태가 있음 | 명시적 상태 머신 |
| 장면에 깊이가 있음 | DOM 3D, Three.js 또는 WebGL 카메라/객체 키프레임 |
메커니즘은 결합될 수 있지만, 각각은 아이디어를 명확히 해야 합니다. 장식은 증명이 아닙니다.
타이밍
- 원인이나 방향을 명확히 할 때만 예측.
- 가속은 휴식 상태에서 출발.
- 피크 증명은 메커니즘을 틀림없이 보여줌.
- 후속 동작은 에너지와 방향을 전달.
- 주체가 탄력적이거나 촉각적이어야 할 때만 오버슈트.
- 일정한 속도의 경로 트래블은 일반적으로
ease: "none"이 필요. - 이산적인 UI 상태는 일반적으로 날카로운 ease-out이 필요.
- 반복되는 요소는 동일한 타이밍이 아닌 정렬된 오프셋이 필요.
- 최종 잠금은 전환 포즈보다 더 긴 홀드가 필요.
- 부드러움은 동일한 주체에서 연속적인 속도를 의미.
- 동일한 변환 속성을 쓰는 트윈을 겹치지 마십시오. 의도적이고 검증된 경우는 제외.
- 주요 영웅 표면이 동시에 스케일링되거나 이동하는 동안 큰
clip-path/마스크 변경을 애니메이션하지 마십시오; 주요 이동이 안정된 후에 중첩된 리빌을 사용하십시오.
텍스트
라인 상자, 단어 간격, 가독성, 최종 맞춤을 유지하십시오. 텍스트가 내부적으로 이동하면 텍스트 주변의 장식뿐만 아니라 글리프 또는 마스킹된 밴드를 이동하십시오. 읽을 수 있는 프레임을 스냅샷하십시오.
SVG
획 성장에는 DrawSVGPlugin을 선호하고, 그 다음 stroke-dasharray/stroke-dashoffset을 선호합니다. 모양 보간에는 MorphSVGPlugin을 선호하고; 필요할 때 프리미티브를 경로로 변환하고 복잡한 실루엣을 더 간단한 부분으로 분할하십시오.
3D
스케일만으로는 가짜 깊이입니다. 안정적인 부모에 원근, transform-style: preserve-3d, z 이동, 회전, 카메라/월드 모션, 폐색, 객체가 교차할 때 레이어 순서를 사용하십시오.
깊이 관계를 드러내는 하나 또는 두 개의 진단 각도를 사용하십시오. 각도 증명이 깊이 교차를 보여주지 않으면 z/카메라/폐색을 개선하십시오.
캔버스 / WebGL
카메라 위치, 카메라 대상, 객체 변환, 재질 불투명도, 셰이더 유니폼, 후처리 강도를 결정론적 상태를 통해 키프레임합니다. HyperFrames 시간에서 렌더링합니다. 마커 상자는 내부 캔버스 모션을 볼 수 없으므로 --ghost를 사용하십시오.
CLI 증명
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>
실제 애니메이션 대상에 대해 <selector>를 선택하십시오. 첫 번째 프레임, 증명 포즈, 최종-마이너스-홀드, 정확한 최종에 대해 <times>를 선택하십시오. 깊이를 증명해야 할 때만 <angle>을 선택하십시오.
| 도구 | 증명 |
|---|---|
keyframes | 대상, 명시적 중지, 경로, 트레이스, 구성된 부모/자식 모션, CSS 중지, Anime 등록 |
--shot | 고스트, 경로 모양, 시간 간격, DOM 3D 프로젝션, 집중 선택자 증명 |
--layout strip | 제자리 모션, 겹침, 접촉, 미묘한 스케일/불투명도, 텍스트 웨이브 |
--ghost | 캔버스, WebGL, 셰이더 모션, 렌더링된 3D |
snapshot --at | 마스크 |
...
[번역을 위해 잘림]