Communitygithub.com

heygen-com/hyperframes

玻璃碎片從霧中飛入,拼貼成標題文字。HyperFrames 區塊,1920×1080,12.16 秒,19 個變數。

hyperframes 是什麼?

Glass Shard Title 是一個 HyperFrames 區塊,能在 12.16 秒內產生令人驚豔的玻璃碎片飛入動畫:碎片從深處旋轉飛入,拼貼成標題文字的輪廓,再飛出攝影機。每個碎片都是透過 Sutherland–Hodgman 演算法,將抖動的形狀裁剪至其 Voronoi 細胞而產生,因此碎片總能完美覆蓋文字。支援 three.js 與 GSAP 執行,提供 19 個可調整變數(如標題文字、碎片數量、飛行時間、旋轉角度、霧效距離等),並可透過指令列進行渲染與自訂。區塊設計確保每個影格狀態皆為時間的封閉函數,支援精確的 seek 操作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/main/registry/blocks/glass-shard-title

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

玻璃碎片標題

Voronoi 切割的玻璃碎片從深處飛入、旋轉,落地後拼貼成標題文字的輪廓,再飛出攝影機。每個碎片都是透過 Sutherland–Hodgman 演算法,將抖動的形狀裁剪至其 Voronoi 細胞而產生,因此碎片總能完全覆蓋文字。玻璃與 matcap 表面材質均帶有逐片霧效;Z 軸飛行與緩動曲線解耦,讓碎片能清晰穿越空間。設定 tileCount 為 1 時,則顯示單一完整玻璃板。

合成 ID:glass-shard-title。時長 12.16 秒,30 fps,解析度 1920×1080。

檔案

  • glass-shard-title.html(16 KB)
  • assets/ferndale_studio_01_1k.hdr(1.6 MB)
  • assets/fonts/Geist-Bold.ttf(65 KB)
  • assets/fonts/Geist-Regular.ttf(65 KB)
  • assets/fonts/Geist-SemiBold.ttf(65 KB)
  • assets/fonts/Geist-OFL.txt(4 KB)
  • assets/fonts/cormorant-garamond.woff2(37 KB)
  • assets/fonts/CormorantGaramond-OFL.txt(4 KB)
  • assets/glass-main.js(549 KB)
  • assets/Three-LICENSE.txt(1 KB)
  • assets/matcap-1.png(安裝時從 CDN 擷取)

安裝

執行 npx hyperframes add glass-shard-title;預設情況下,上述檔案會放置於 compositions/glass-shard-title/ 目錄下。接著在主機 index.html 中掛載該區塊:

<div
  data-composition-id="glass-shard-title"
  data-composition-src="compositions/glass-shard-title/glass-shard-title.html"
  data-start="0"
  data-duration="12.16"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

若要使用自訂數值進行渲染,可直接指定合成檔案:

npx --yes [email protected] render 'compositions/glass-shard-title/glass-shard-title.html' --variables '{"headline":"Designed in glass","tileCount":8}'

變數

執行時期透過 window.__hyperframes.getVariables() 讀取;在合成根元素上以 data-composition-variables 屬性宣告(使用單引號屬性值,內含一般 JSON)。

id類型預設值標籤 / 範圍
headlinestring"Designed in glass"標題文字,最多 40 字元
tileCountnumber8碎片數量 1–400,間隔 1
roundnessnumber0.4圓角程度 (0-1) 0–1,間隔 0.01
bevelnumber0.35倒角 (0-1) 0–1,間隔 0.01
meshSmoothnumber0.6表面平滑度 (0-1) 0–1,間隔 0.01
flyInTimenumber2.3飛入時間(秒)0.2–6,間隔 0.05
flyOutTimenumber2.4飛出時間(秒)0.2–6,間隔 0.05
staggernumber0.27交錯延遲 (0-1) 0–1,間隔 0.01
flyInRotationnumber5飛入旋轉角度 (0-60) 0–60,間隔 0.1
flyOutRotationnumber6飛出旋轉角度 (0-6) 0–6,間隔 0.1
chaosnumber0.25外框混亂程度 (0-1) 0–1,間隔 0.01
paddingnumber1邊緣留白 (0-1) 0–1,間隔 0.01
sizeVariancenumber0.35尺寸變異 (0-1) 0–1,間隔 0.01
gapnumber0.03碎片間隙 0–0.3,間隔 0.002
easePownumber10飛入位置緩動指數 (1-10) 1–10,間隔 0.1
sideDistnumber3側向飛行距離 0–60,間隔 0.5
zDistnumber-42Z 軸飛入起點(負值)-400–0,間隔 2
zOutnumber14Z 軸飛出終點(+ 表示通過攝影機)-400–60,間隔 2
fognumber36霧效距離(0 = 關閉)0–400,間隔 2

執行時期合約

  • 一個暫停狀態的 GSAP 時間軸,註冊為 window.__timelines["glass-shard-title"]。
  • 透過 hf-seek CustomEvent 重新同步;每個影格均為時間的封閉形式函數(僅使用種子化 PRNG,無 rAF 迴圈,無 Date.now)。
  • 渲染器:three.js 0.181.2(打包)、GSAP 3.14.2、Canvas 2D、GLSL 著色器、HDR 環境、Matcap、種子化 PRNG、d3-delaunay、陰影貼圖。每個實例約需 350 MB 記憶體;建議一次只執行一個。
  • 外部執行時期相依套件:https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js、https://cdn.jsdelivr.net/npm/[email protected]/dist/d3-delaunay.min.js。
  • 本機字型:assets/fonts/Geist-Regular.ttf、assets/fonts/Geist-SemiBold.ttf、assets/fonts/Geist-Bold.ttf。
  • 打包的程式碼已內聯至合成檔案(assets/glass-main.js);編輯原始 .mjs 原始碼後,使用 esbuild 重建並重新內聯。

編輯規則(來自原始專案)

  1. data-composition-variables 務必使用單引號屬性值,內含一般雙引號 JSON。切勿透過 Studio 的設計面板儲存。
  2. 不要在靜態標記中放置 <canvas>;應在執行時期建立。
  3. 確保每個視覺狀態皆為 t 的函數;seek 安全性是區塊可渲染的關鍵。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

general-video

>

heygen-com/animejs

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

heygen-com/claude-design-hyperframes

Use when running inside Claude Design specifically. Produces a valid, brand-accurate HyperFrames video draft using pre-valid skeletons. For Claude Code / Cursor / Codex, use the `hyperframes` skill instead.

heygen-com/contribute-catalog

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

heygen-com/css-animations

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

heygen-com/gsap

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

heygen-com/hyperframes

Leaves sweep through the frame and part to reveal the headline. HyperFrames block, 1920×1080, 12s, 11 variables.

heygen-com/hyperframes

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

heygen-com/hyperframes

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

heygen-com/hyperframes

A single feature card orbits a dot sphere on approved Blender camera motion. HyperFrames block, 1920×1080, 10s, 4 variables.

heygen-com/hyperframes

A wireframe portal bursts open, the title comes through, then its letters swap into a second phrase. HyperFrames block, 1920×1080, 8s, 9 variables.

heygen-com/hyperframes

An orbiting camera follows an ice logo as it breaks apart, reforms into two text moments, and fades. HyperFrames block, 1920×1080, 22.5s, 216 variables.

heygen-com/hyperframes

House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.

heygen-com/hyperframes

A chain of bevelled cuboids rides a travelling wave as a content carousel. HyperFrames block, 1920×1080, 6.666666666666667s, 40 variables.

heygen-com/hyperframes

name: embedded-captions

heygen-com/hyperframes

A tiled headline surface flips cell by cell under a sweeping depth field to reveal the rear headline. HyperFrames block, 1920×1080, 8s, 18 variables.

heygen-com/hyperframes

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

heygen-com/hyperframes

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

heygen-com/hyperframes

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

heygen-com/hyperframes

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

相關技能