Révélation de logo liquide
Une bille de verre WebGL (Three.js) avec transmission physique, surface déplacée par du bruit et dispersion se tient devant le logo. Le logo est réfracté si fortement qu'il est illisible. La pression monte, tout se fige un instant, la bille éclate, 15 gouttelettes s'envolent, le symbole glisse vers la gauche tandis que le mot-symbole apparaît derrière lui. Les images sont des fonctions pures du temps de recherche, donc les rendus sont déterministes.
Entrées
| Entrée | Remarques |
|---|---|
| Symbole du logo | SVG ou PNG. Symbole uniquement (pas le mot-symbole), de forme carrée, fond transparent. |
| Mot-symbole | Une chaîne de texte typographiée en Inter par défaut. Si la marque a un vrai mot-symbole graphique, voir « Mot-symbole comme œuvre d'art ». |
| Palette | Trois couleurs : un accent fort, une teinte douce, un neutre atténué. Elles deviennent des champs de couleur floutés derrière la bille ; la bille est incolore et ne montre que ce qui se trouve derrière elle. Couleur d'encre pour le mot-symbole. |
| Durée | 7 s par défaut. La seule partie que vous devriez étendre est le temps d'arrêt après que le logo complet s'est posé. |
Utilisez uniquement les actifs fournis par l'utilisateur ou présents dans le kit de marque. Ne récupérez jamais de logos sur le Web.
Logos uniquement matriciels
- Le modèle attend un PNG avec alpha. Si le logo a un fond opaque (JPG, boîte blanche), supprimez-le d'abord (
npx hyperframes remove-background, ou demandez à l'utilisateur un fichier transparent). Ne livrez pas un carré blanc réfracté à l'intérieur de la bille. - Un petit PNG (moins de ~600 px) convient car le symbole est affiché à environ 250 px au repos, mais il est agrandi à environ 360 px à l'intérieur de la bille. Gardez la source d'au moins 512 px sur le côté le plus long.
- Rognez les bords transparents pour que le symbole visible remplisse l'image ; le code dimensionne la boîte de l'image, pas l'encre.
- SVG : convertissez en PNG d'environ 1720 px sur le côté le plus long (capture d'écran Chrome headless, ou
rsvg-convert -w 1720), conservez l'alpha, et pointezdata-logo-srcvers celui-ci. Ne redessinez pas et ne recolorez pas le logo. - Si le logo de la marque est une image combinée (symbole et texte fusionnés), vous ne pouvez pas le séparer proprement. Utilisez l'image complète comme symbole, définissez
data-wordmark=""et sautez l'apparition du mot-symbole (définissez le clip du mot-symbole pour qu'il soit toujours masqué). Le symbole se positionne alors au centre, pas à gauche.
Workflow de construction
- Échafaudage :
npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, puis remplacez sonindex.htmlpar letemplate/index.htmlde cette compétence et copieztemplate/js/,template/assets/logo.png(remplacez par le symbole de la marque). - Intégrez le runtime pour que le rendu ne touche jamais le réseau. Dans un répertoire temporaire (PAS à l'intérieur d'un autre projet,
npm iremonte jusqu'au package.json le plus proche), exécuteznpm i [email protected] [email protected] @fontsource-variable/inter, puis copiez dans le projet :gsap/dist/gsap.min.jsversvendor/gsap.min.jsthree/build/three.module.jsetthree/build/three.core.jsversvendor/three/build/three/examples/jsm/environments/RoomEnvironment.jsversvendor/three/examples/jsm/environments/@fontsource-variable/inter/files/inter-latin-wght-normal.woff2versassets/fonts/
- Marquez-le avec les attributs de données sur
#rootdansindex.html:data-logo-src,data-wordmark,data-ink,data-fields(trois couleurs hexadécimales). Gardez les champs saturés pour l'accent et doux ailleurs ; ne faites jamais en sorte que le champ derrière le centre de la bille soit sombre et plat. - Lint et vérification :
npx --yes hyperframes lintpuisnpx --yes hyperframes check. Les deux doivent être propres. - Révision des images (ci-dessous). Ajustez. Répétez.
- Rendu :
npx --yes hyperframes render --workers 2 --output final.mp4. Sondez-le :ffprobedoit indiquer h264, 1920×1080, 30 ips, la durée attendue.
Règles de mouvement (ce qui fait fonctionner le format)
- Illisible, pas invisible. Avant l'éclatement, le spectateur doit voir de la couleur et des formes déformées du symbole, jamais le lire. Si une image montre le logo de manière reconnaissable, augmentez
thickness/ l'amplitude de déplacement / la rotation ; si la bille est une goutte plate sans aucun indice du symbole, diminuez-les. - Le symbole se trouve derrière le verre, dans le passage opaque. Le plan avant l'éclatement utilise
alphaTest(file d'attente opaque) pour que le passage de transmission de Three.js puisse le réfracter. Un simple plantransparent: truene serait pas réfracté. La copie « révélée » est transparente et n'est échangée qu'après l'effondrement de l'enveloppe. - Phases, dans l'ordre (toutes les constantes dans
Ten haut dejs/liquid-reveal.js) : établissement (cadrage serré à bille pleine, 0,7 s) puis performance liquide, montée en pression (la bille s'aplatit et s'élargit, le symbole gonfle de 1,00 à 1,06), virgule (0,4 s d'immobilité totale : caméra, symbole, bille et horloge du shader gelés), rupture (l'enveloppe s'effondre en 0,2 s avec une atténuation puissance 4, les gouttelettes partent radialement), positionnement (le symbole recule puis glisse vers son emplacement définitif tandis que le mot-symbole apparaît derrière lui), maintien. - L'immobilité est le point clé. La pause de 0,4 s avant l'éclatement est ce qui vend la rupture. Pas de respiration, de flottement ou de lueur en boucle.
- L'horloge du shader est verrouillée. Le temps de bruit n'avance que dans les fenêtres définies et se fige lors de la virgule et après le positionnement.
- Le mot-symbole émerge du symbole, jamais il n'apparaît brusquement. Le bord gauche de son clip suit le bord droit du symbole, de sorte que le texte n'est jamais recouvert par le symbole pendant le positionnement.
- Gouttelettes : disposition fixe à angle d'or (pas de
Math.random), lancement radial, un terme de gravité, puis rétrécissement jusqu'à disparaître pour que l'image finale soit propre. - Terminer sur un logo immobile. Symbole et mot-symbole droits, centrés en paire, sans fondu. Si la pièce est une intro qui sera montée dans une vidéo plus longue, raccourcissez le maintien au lieu d'ajouter un fondu.
- Déterminisme : tout est calculé à partir du temps
hf-seek. Pas derequestAnimationFrame,Date.now,Math.random. La seule mesure DOM est la largeur du mot-symbole, prise une fois au chargement (canvasmeasureTextavec la police livrée).
Boutons de réglage
| Résultat souhaité | Modification |
|---|---|
| Plus long ou plus court | Constantes T et data-duration sur #root et sur les deux éléments .clip (maintenez-les égaux) |
| Bille plus abstraite | Augmentez thickness (3,2) ou l'amplitude de déplacement (0,15) ; diminuez pour la lisibilité |
| Aspect gélatineux vs. gouttelettes | dispersion, attenuationColor dans liquidMaterial() |
| Logo plus grand ou plus petit | L.markPx, L.fontPx, L.gap |
| Fond plus calme | Diminuez les trois pondérations de champ * 0.50 / 0.80 / 0.35 dans le shader d'arrière-plan |
Mot-symbole comme œuvre d'art
Si la marque fournit un SVG/PNG de mot-symbole, remplacez le texte #wordmark par une <img> avec la même logique de position et de largeur : mesurez son rapport d'aspect, définissez sa hauteur sur L.fontPx * 0.8, et conservez la même logique clip-path. Ne retapez jamais un mot-symbole stylisé dans une police de substitution.
Validation
lintetcheckpropres (une erreur de lint désactive silencieusement les audits de mise en page).- Extrayez des images et regardez-les :
npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5et ouvrezsnapshots/contact-sheet.jpg, ouffmpeg -ss <t> -i final.mp4 -frames:v 1 f.pngsur le rendu. Vérifiez : (1) les images précoces montrent une bille où le symbole est illisible, (2) l'image juste après l'éclatement n'a pas de texte de mot-symbole chevauchant le symbole, (3) le texte en cours de positionnement est rogné par le bord du symbole, (4) l'image finale a un symbole et un mot-symbole nets, centrés, sans gouttelettes, sans glyphes rognés. - Échecs courants : toile blanche (chemin d'importmap incorrect, ou
three.core.jsWebGL non copié), mot-symbole décentré (police non chargée avant la mesure), logo avec une boîte blanche (PNG opaque).
Livraison
Remettez final.mp4 et le dossier du projet (index.html, js/, assets/, vendor/) afin qu'il puisse être re-marqué en modifiant les attributs data-*. L'audio est optionnel ; un court effet sonore de pop au moment de la rupture T.pop est le seul son dont la pièce a besoin. Obtenez tout son via la compétence media-use avec un résultat sous licence commerciale, sinon livrez-le sans son.