Communitygithub.com

szeproka/hyperframes-registry

Las hojas barren el fotograma y se apartan para revelar el titular. Bloque HyperFrames, 1920×1080, 12 s, 11 variables.

¿Qué es hyperframes-registry?

Esta habilidad define un bloque animado de HyperFrames (`canopy-part-title`) que muestra un efecto visual de dos titulares: una densa capa de hojas texturizadas barre el fotograma con poca profundidad de campo, luego se aparta para revelar el primer titular; un segundo lote de hojas, desplazadas en profundidad, lleva el segundo titular más allá de la cámara. Algunas hojas permanecen sobre el texto con una brisa ligera. El bloque dura 12 segundos a 30 fps (1920×1080) y expone 11 variables editables: contenido de los titulares, fuente, peso, tamaño, espaciado, color de fondo, cantidad de hojas, velocidad de barrido y brisa retenida. Se instala mediante `npx hyperframes add canopy-part-title` y se monta con un elemento `div` que referencia `data-composition-id`. Su tiempo de ejecución usa GSAP y three.js, con un timeline pausado y una sincronización segura basada en eventos `hf-seek`, lo que garantiza que cada fotograma sea una función determinista del tiempo, apto para la reproducción cuadro a cuadro sin bucles ni `Date.now`. Está pensado para integración en proyectos HyperFrames, especialmente en entornos de edición de video o animación procedural.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/szeproka/hyperframes-registry/tree/HEAD/registry/blocks/canopy-part-title

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Título de Dos Capas de Hojas

Una densa capa de hojas texturizadas barre el fotograma con poca profundidad de campo, luego se aparta para descubrir el primer titular; un segundo lote de hojas, desplazadas en profundidad, lleva el segundo titular más allá de la cámara. Un puñado de hojas se queda sobre el tipo y mantiene una brisa ligera. La fuente, el peso, el tamaño, el espaciado entre letras, la cantidad de hojas, la velocidad de barrido y la brisa retenida son variables.

Id de composición: canopy-part-title. Duración 12 s a 30 fps, 1920×1080.

Archivos

  • canopy-part-title.html (57 KB)
  • assets/leaf-surface-color.webp (64 KB)
  • assets/leaf-surface-normal.webp (136 KB)

Instalación

Instala con npx hyperframes add canopy-part-title; por defecto los archivos anteriores se colocan bajo compositions/canopy-part-title/. Luego monta el bloque desde el index.html anfitrión:

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

Renderiza con valores personalizados apuntando directamente al archivo de composición:

npx --yes [email protected] render 'compositions/canopy-part-title/canopy-part-title.html' --variables '{"headline1":"Sotobosque","headline2":"Muévete lentamente"}'

Variables

Se leen en tiempo de ejecución mediante window.__hyperframes.getVariables(); se declaran en la raíz de la composición como data-composition-variables (atributo con comillas simples, JSON simple).

idtipodefectoetiqueta / rango
headline1string"Sotobosque"Titular 1
headline2string"Muévete lentamente"Titular 2
fontstring"Helvetica"Fuente del titular
fontWeightnúmero900Peso de fuente 100–900 paso 100
fontSizenúmero1Tamaño de fuente (1 = ajuste automático) 0.3–2 paso 0.01
letterSpacingnúmero0.01Espaciado entre letras (em) -0.2–1 paso 0.01
backgroundcolor"#020805"Fondo
leafCountnúmero170Hojas por barrido 40–320 paso 1
stayCountnúmero5Hojas que se quedan 0–20 paso 1
sweepSpeednúmero1Velocidad de barrido 0.3–3 paso 0.05
retainedBreezenúmero1Brisa de hojas retenidas 0–2 paso 0.05

Contrato de tiempo de ejecución

  • Una línea de tiempo de GSAP pausada registrada como window.__timelines["canopy-part-title"].
  • Se resincroniza con el evento personalizado hf-seek; cada fotograma es una función de forma cerrada del tiempo (solo PRNG con semilla, sin bucles rAF, sin Date.now).
  • Renderizador: three.js 0.170.0, GSAP 3.14.2, Canvas 2D, posprocesamiento, PRNG con semilla, mapas de sombra. Presupuesto aproximado de 350 MB por instancia activa; ejecutar una a la vez.
  • Dependencias externas de tiempo de ejecución: https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js, https://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js, https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/EffectComposer.js, https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/RenderPass.js, https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/postprocessing/BokehPass.js.
  • Fuentes web de Google Fonts: Gelasio.

Reglas de edición (del proyecto fuente)

  1. Mantener data-composition-variables como un atributo con comillas simples con JSON plano entre comillas ". Nunca guardarlo a través del panel de Diseño de Studio.
  2. No poner <canvas> en el marcado estático; crearlo en tiempo de ejecución.
  3. Mantener cada estado visual como una función de t; la seguridad de búsqueda es lo que hace que el bloque se pueda renderizar.

Individual skills in this repo

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

Skills relacionados