Communitygithub.com

szeproka/hyperframes-registry

Des feuilles balayent l'écran et s'écartent pour révéler le titre. Bloc HyperFrames, 1920×1080, 12s, 11 variables.

Qu'est-ce que hyperframes-registry ?

Cette compétence fournit un bloc d'animation HyperFrames appelé « Canopy Part Title » (Titre sous la canopée), conçu pour les environnements de montage vidéo et de rendu basés sur le Web. Le bloc crée une animation visuelle immersive où un feuillage texturé balaie l'écran avec une faible profondeur de champ, puis s'écarte pour révéler un premier titre, suivi d'un second titre porté par un deuxième groupe de feuilles. Utilisant Three.js et GSAP, le bloc garantit une animation déterministe et synchronisable : chaque image est une fonction fermée du temps, ce qui permet une recherche temporelle précise et une lecture cohérente. Il prend en charge 11 variables personnalisables, notamment les textes des titres, la police, la taille, l'espacement des lettres, le nombre de feuilles et la vitesse de balayage. L'installation s'effectue via `npx hyperframes add canopy-part-title`, et le rendu peut être effectué avec des valeurs personnalisées en ligne de commande. La compétence est idéale pour les créateurs de contenu vidéo et les développeurs Web qui ont besoin de compositions visuelles dynamiques et reproductibles pour des titres ou des transitions.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Titre sous la canopée

Un dense feuillage texturé balaie l'écran avec une faible profondeur de champ, puis s'écarte pour révéler le premier titre ; un deuxième lot de feuilles, avec une profondeur augmentée, transporte le second titre devant la caméra. Quelques feuilles restent sur le texte et entretiennent une légère brise. La police, le poids, la taille, l'espacement des lettres, le nombre de feuilles, la vitesse de balayage et la brise retenue sont des variables.

Identifiant de composition : canopy-part-title. Durée 12 s à 30 ips, 1920×1080.

Fichiers

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

Installation

Installez avec npx hyperframes add canopy-part-title ; par défaut, les fichiers ci-dessus atterrissent sous compositions/canopy-part-title/. Montez ensuite le bloc à partir du index.html hôte :

<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>

Rendez avec des valeurs personnalisées en ciblant directement le fichier de composition :

npx --yes [email protected] render 'compositions/canopy-part-title/canopy-part-title.html' --variables '{"headline1":"Sous-bois","headline2":"Avancez lentement"}'

Variables

Lues à l'exécution via window.__hyperframes.getVariables() ; déclarées sur la racine de la composition comme data-composition-variables (attribut entre guillemets simples, JSON simple).

idtypedéfautlibellé / plage
headline1string"Sous-bois"Titre 1
headline2string"Avancez lentement"Titre 2
fontstring"Helvetica"Police des titres
fontWeightnumber900Poids de police 100–900 par pas de 100
fontSizenumber1Taille de police (1 = ajustement automatique) 0.3–2 par pas de 0.01
letterSpacingnumber0.01Espacement des lettres (em) -0.2–1 par pas de 0.01
backgroundcolor"#020805"Arrière-plan
leafCountnumber170Feuilles par balayage 40–320 par pas de 1
stayCountnumber5Feuilles laissées derrière 0–20 par pas de 1
sweepSpeednumber1Vitesse de balayage 0.3–3 par pas de 0.05
retainedBreezenumber1Brise des feuilles retenues 0–2 par pas de 0.05

Contrat d'exécution

  • Une timeline GSAP en pause enregistrée sous window.__timelines["canopy-part-title"].
  • Se resynchronise sur l'événement personnalisé hf-seek ; chaque image est une fonction fermée du temps (PRNG ensemencé uniquement, pas de boucles rAF, pas de Date.now).
  • Moteur de rendu : three.js 0.170.0, GSAP 3.14.2, Canvas 2D, post-traitement, PRNG ensemencé, cartes d'ombre. Budget environ 350 Mo par instance active ; exécutez une à la fois.
  • Dépendances d'exécution externes : 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.
  • Polices Web de Google Fonts : Gelasio.

Règles d'édition (du projet source)

  1. Conservez data-composition-variables comme un attribut entre guillemets simples avec du JSON " simple. Ne l'enregistrez jamais via le panneau de conception de Studio.
  2. Ne mettez pas <canvas> dans le balisage statique ; créez-le à l'exécution.
  3. Faites en sorte que chaque état visuel soit une fonction de t ; la sécurité de recherche temporelle est ce qui rend le bloc rendable.

Individual skills in this repo

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

Skills associés