⚠ 合约状态:工艺当前,代码已过时
此堆栈的输出框架是 Remotion + React(
/hyperframes-core)。 此处的动效工艺仍然适用:定时、缓动选择、动作形状、命名规则和蓝图。 代码则不适用:示例和适配器是针对已退役的 HTML + 暂停 GSAP 时间线运行时编写的。阅读时请进行如下翻译对照:
此处 在 Remotion 中 gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})ease: "back.out(1.7)"spring({frame, fps, config:{damping}}),目视调整暂停时间线 window.__timelines[id]无;每个值都是 useCurrentFrame()的函数片段上的 data-start/data-duration<Sequence from>/durationInFrames,以帧为单位CSS 关键帧或过渡 基于帧的内联 style(CSS 动画不渲染)切勿将本技能中的任何示例未经修改直接粘贴到 Remotion 项目中。
HyperFrames 动画
单个技能包含所有动效知识:规则(原子配方)、蓝图(多阶段场景模板)、过渡(场景间切换)、技巧(更广泛的动效设计模式)和适配器(各运行时 API)。
关于合成合约(数据属性、子合成、确定性),请参阅 hyperframes-core。
默认方式:组合原子规则
从 rules-index.md 中挑选 2-4 条规则,用单个暂停的 GSAP 时间线将它们组合起来即可。这比从蓝图开始更快,且产生更少的代码。
何时加载蓝图
- 当前场景匹配现有的预设计多阶段模板(品牌揭示、社交证明等),并且重用其阶段流水线可以节省实际创作时间
- 你想要一个复杂 4-5 阶段编排的可运行参考代码
蓝图位于 blueprints-index.md。每个条目指向 blueprints/<id>.md(配方)。请勿无目的地阅读;仅当你已确定需要场景级编排时才加载它。
路由
| 目标… | 阅读 |
|---|---|
| 根据触发条件/标签挑选原子运动模式 | rules-index.md |
| 阅读某条规则的完整 HTML / CSS / GSAP 配方 | rules/<name>.md |
| 挑选多阶段场景模板 | blueprints-index.md |
| 阅读某蓝图的完整配方 | blueprints/<id>.md |
| 创作场景过渡(CSS 驱动,在两个片段之间) | transitions/overview.md,transitions/catalog.md |
| 查找更广泛的动效设计技巧 | techniques.md |
| 分析现有合成的动画映射 | scripts/animation-map.mjs |
| GSAP API — 时间线 / 补间 / 位置参数 | adapters/gsap.md |
| GSAP — 直接可用的效果配方 | rules/gsap-effects.md |
| GSAP — 变换 / 性能 | adapters/gsap-transforms-and-perf.md |
| GSAP — 缓动 / 交错 | adapters/gsap-easing-and-stagger.md |
| GSAP — 时间线 / 标签 | adapters/gsap-timeline-and-labels.md |
Lottie / dotLottie(After Effects 导出,window.__hfLottie) | adapters/lottie.md |
Three.js / WebGL(3D 场景,AnimationMixer,hf-seek) | adapters/three.md |
Anime.js(window.__hfAnime) | adapters/animejs.md |
CSS 关键帧(animation-delay / play-state / fill-mode) | adapters/css-animations.md |
Web Animations API(element.animate(),currentTime seek) | adapters/waapi.md |
TypeGPU / WebGPU(navigator.gpu,WGSL,计算管线) | adapters/typegpu.md |
HTML 作为纹理 + WebGL/GLSL 后期特效(通过 drawElementImage 捕获实时 DOM) | adapters/html-in-canvas-patterns.md |
命名文本动画效果(24 个 ID,通过外部 animate-text 技能) | adapters/animate-text.md |
选择运行时
- GSAP 是 95% 动效工作的默认选择——涵盖时间线编排、变换、缓动、交错。本技能中的所有原子规则都基于 GSAP。
- Lottie 用于拥有自己预烘焙时间线的资源(通常是 After Effects 导出)。
- Three.js 用于 3D 场景、摄像机运动、着色器驱动的视觉效果。
- Anime.js 用于轻量级补间(当 GSAP 过于繁重时)。
- CSS 用于简单的重复图案、装饰、闪烁——无需 JavaScript 动画成本。
- WAAPI 用于无需 GSAP 依赖的原生浏览器关键帧。
- TypeGPU / WebGPU 用于 GPU 渲染的画布(粒子、液体玻璃、自定义着色器)。
多个运行时可以在单个合成中共存。每个运行时都会将其实例注册到运行时特定的全局对象上,以便 HyperFrames 能够在一次遍历中 seek 所有实例。
关键约束
先决条件:hyperframes-core → 不可协商的规则(单一暂停时间线,data-duration 控制长度,不能使用 Math.random / Date.now / performance.now,不能使用 repeat: -1,不能在后场景片段上进行页面加载时的 gsap.set,不能使用 display 或原始 visibility 补间,不能在 async / setTimeout / Promise 内部构建时间线)。核心框架允许 GSAP 的 autoAlpha 和在明确的时间线边界上的零持续时间可见性设置。仅对非片段元素或片段内的包装器使用这些例外;框架拥有 .clip 的生命周期。此处不再重复完整合约。
在核心合约基础上增加的动画工艺约束:
- 预计算的布局常量 — 绝不在补间时从
getBoundingClientRect()推导位置。补间时进行 DOM 测量会导致不同步,因为渲染器并行采样;在合成设置时一次性计算坐标并复用。 - 空间运动仅使用 GSAP 变换别名(
x,y,scale,rotation)。核心允许列表也允许对非空间属性补间使用opacity/color/backgroundColor/borderRadius— 但绝不对布局更改使用width/height/top/left。
脚本
node skills/hyperframes-animation/scripts/animation-map.mjs <合成目录> \
--out <合成目录>/.hyperframes/anim-map
读取注册在 window.__timelines 上的每个 GSAP 时间线,枚举所有补间,采样边界框,计算标志,输出 animation-map.json。在创作后使用它来审计动画编排(死区、交错一致性、生命周期警告)。
animation-map.mjs 首先从当前项目解析辅助包,然后可以引导捆绑的 HyperFrames 包版本。仅当在捆绑的 CLI/技能安装之外运行该技能,并且需要显式固定该引导版本时,才设置 HYPERFRAMES_SKILL_PKG_VERSION=<版本>。
参见
hyperframes-core— 合成结构、数据属性、子合成、确定性渲染合约hyperframes-creative— 调色板、排版、叙事、节拍规划(非动画创意指导)hyperframes-cli—npx hyperframes lint / check / snapshot / preview / render