Flüssig-Logo-Reveal
Eine WebGL-Glasperle (Three.js) mit physikalischer Transmission, rauschversetzter Oberfläche und Dispersion sitzt vor dem Logo. Das Logo wird so stark gebrochen, dass es nicht lesbar ist. Druck baut sich auf, alles friert für einen Moment ein, die Perle platzt, 15 Tropfen fliegen weg, die Marke gleitet nach links, während die Wortmarke von hinten hervorwischt. Frames sind reine Funktionen der Suchzeit, daher sind Renderings deterministisch.
Eingaben
| Eingabe | Hinweise |
|---|---|
| Logomarke | SVG oder PNG. Nur die Marke (Symbol), annähernd quadratisch, transparenter Hintergrund. |
| Wortmarke | Ein Textstring, standardmäßig in Inter gesetzt. Falls die Marke eine echte Wortmarken-Grafik hat, siehe „Wortmarke als Grafik“. |
| Palette | Drei Farben: ein kräftiger Akzent, ein sanfter Farbton, ein gedämpftes Neutral. Sie werden zu verschwommenen Farbfeldern hinter dem Glas; das Glas ist farblos und zeigt nur, was dahinter ist. Schriftfarbe für die Wortmarke. |
| Dauer | Standard 7s. Der Halt, nachdem das Lockup landet, ist der einzige Teil, den Sie dehnen sollten. |
Verwenden Sie nur Assets, die der Benutzer bereitgestellt hat oder die sich im Marken-Kit befinden. Rufen Sie niemals Logos aus dem Internet ab.
Nur-Raster-Logos
- Die Vorlage erwartet ein PNG mit Alphakanal. Wenn das Logo einen undurchsichtigen Hintergrund hat (JPG, weißer Kasten), entfernen Sie ihn zuerst (
npx hyperframes remove-background, oder fragen Sie den Benutzer nach einer transparenten Datei). Liefern Sie kein weißes Quadrat aus, das in der Perle gebrochen wird. - Ein kleines PNG (unter ~600px) ist in Ordnung, da die Marke im Ruhezustand mit etwa 250px angezeigt wird, aber in der Perle auf ~360px skaliert wird. Halten Sie die Quelle auf der langen Seite mindestens 512px.
- Entfernen Sie transparente Ränder, sodass die sichtbare Marke das Bild ausfüllt; der Code dimensioniert die Bildbox, nicht die Tinte.
- SVG: Rastern Sie es in ein PNG mit etwa 1720px auf der langen Seite (Headless-Chrome-Screenshot oder
rsvg-convert -w 1720), behalten Sie den Alphakanal und setzen Siedata-logo-srcdarauf. Zeichnen Sie das Logo nicht neu und färben Sie es nicht um. - Falls das Markenlogo ein kombiniertes Lockup-Bild ist (Marke und Text verschmolzen), können Sie es nicht sauber trennen. Verwenden Sie das gesamte Lockup als Marke, setzen Sie
data-wordmark=""und überspringen Sie den Wortmarken-Wipe (setzen Sie den Wortmarken-Clip auf immer versteckt). Die Marke dockt dann mittig, nicht links an.
Build-Workflow
- Gerüst erstellen:
npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, dannindex.htmldurch dietemplate/index.htmldieses Skills ersetzen undtemplate/js/sowietemplate/assets/logo.pngkopieren (mit der Bildmarke überschreiben). - Die Laufzeit vendorisieren, sodass das Rendern nie das Netzwerk berührt. Führen Sie in einem Scratch-Verzeichnis (NICHT innerhalb eines anderen Projekts,
npm igeht bis zur nächsten package.json hoch)npm i [email protected] [email protected] @fontsource-variable/interaus, kopieren Sie dann in das Projekt:gsap/dist/gsap.min.jsnachvendor/gsap.min.jsthree/build/three.module.jsundthree/build/three.core.jsnachvendor/three/build/three/examples/jsm/environments/RoomEnvironment.jsnachvendor/three/examples/jsm/environments/@fontsource-variable/inter/files/inter-latin-wght-normal.woff2nachassets/fonts/
- Branding mit den data-Attributen auf
#rootinindex.html:data-logo-src,data-wordmark,data-ink,data-fields(drei Hex-Farben). Halten Sie die Felder beim Akzent gesättigt und sonst weich; machen Sie das Feld hinter der Mitte der Perle niemals dunkel und flach. - Linten und prüfen:
npx --yes hyperframes lintdannnpx --yes hyperframes check. Beide müssen sauber sein. - Frame-Review (siehe unten). Optimieren. Wiederholen.
- Rendern:
npx --yes hyperframes render --workers 2 --output final.mp4. Überprüfen:ffprobesollte h264, 1920×1080, 30fps, die erwartete Dauer melden.
Bewegungsregeln (was das Format zum Funktionieren bringt)
- Unleserlich, nicht unsichtbar. Vor dem Platzen sollte der Betrachter Farbe und verzerrte Formen der Marke sehen, sie aber nie lesen können. Wenn ein Frame das Logo erkennbar zeigt, erhöhen Sie
thickness/ Verschiebungsamplitude / Drehung; wenn die Perle ein flacher Klecks ohne Andeutung der Marke ist, verringern Sie sie. - Die Marke sitzt hinter dem Glas, im undurchsichtigen Durchgang. Die Vor-Platzen-Ebene verwendet
alphaTest(undurchsichtige Warteschlange), damit der Transmissionsdurchgang von Three sie brechen kann. Eine einfachetransparent: true-Ebene würde nicht gebrochen werden. Die „enthüllte“ Kopie ist transparent und wird erst eingetauscht, wenn die Hülle kollabiert ist. - Phasen, in der Reihenfolge (alle Konstanten in
Toben injs/liquid-reveal.js): etablieren (enger Bildausschnitt zur vollen Perle, 0.7s) dann flüssige Performance, Druckaufbau (Perle wird breiter und flacher, Marke schwillt von 1.00 auf 1.06), Komma (0.4s totale Stille: Kamera, Marke, Perle und Shader-Uhr eingefroren), Ruptur (Hülle kollabiert in 0.2s mit Power-4-Ease-In, Tropfen starten radial), Andocken (Marke federt zurück und gleitet dann in ihren Lockup-Slot, während die Wortmarke von hinten hervorwischt), Halten. - Die Stille ist der Punkt. Der 0.4s-Einfrierpunkt vor dem Platzen ist das, was die Ruptur verkauft. Kein atmendes Schweben, keine Loop-Glühereffekte.
- Die Shader-Uhr ist getaktet. Die Rauschzeit schreitet nur in autorisierten Fenstern voran und friert beim Komma und nach dem Andocken ein.
- Die Wortmarke erscheint von der Marke aus, platzt nie herein. Ihr Clip-Linkskante folgt der rechten Kante der Marke, sodass der Text während des Andockens nie von der Marke übermalt wird.
- Tropfen: Goldener-Winkel-festes Layout (kein
Math.random), radialer Start, ein Schwerkraftterm, dann schrumpfen zu nichts, sodass der letzte Frame sauber ist. - Ende mit einem stillen Lockup. Marke und Wortmarke aufrecht, als Paar zentriert, kein Ausblenden. Wenn das Stück ein Intro ist, das in ein längeres Video geschnitten wird, verkürzen Sie das Halten anstatt auszublenden.
- Determinismus: Alles wird aus der
hf-seek-Zeit berechnet. KeinrequestAnimationFrame,Date.now,Math.random. Die einzige DOM-Messung ist die Breite der Wortmarke, einmal beim Laden gemessen (CanvasmeasureTextmit der ausgelieferten Schriftart).
Einstellknöpfe
| Wunsch | Änderung |
|---|---|
| Länger oder kürzer | T-Konstanten und data-duration auf #root und auf beiden .clip-Elementen (gleich halten) |
| Abstraktere Perle | thickness (3.2) oder die Verschiebungsamplitude (0.15) erhöhen; zum Lesbarmachen verringern |
| Geleeartig vs. tropfenförmig | dispersion, attenuationColor in liquidMaterial() |
| Größeres oder kleineres Lockup | L.markPx, L.fontPx, L.gap |
| Ruhigerer Hintergrund | Die drei Feldgewichte * 0.50 / 0.80 / 0.35 im Hintergrundshader verringern |
Wortmarke als Grafik
Wenn die Marke eine Wortmarke als SVG/PNG bereitstellt, ersetzen Sie den Text #wordmark durch ein <img> mit derselben Positions- und Breitenlogik: Messen Sie sein Seitenverhältnis, setzen Sie seine Höhe auf L.fontPx * 0.8 und behalten Sie dieselbe clip-path-Logik bei. Geben Sie eine stilisierte Wortmarke niemals in einer Ersatzschriftart wieder.
Validierung
lintundchecksauber (ein Lint-Fehler deaktiviert stillschweigend die Layout-Prüfungen).- Extrahieren Sie Frames und betrachten Sie sie:
npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5und öffnen Siesnapshots/contact-sheet.jpg, oderffmpeg -ss <t> -i final.mp4 -frames:v 1 f.pngauf dem Rendering. Überprüfen Sie: (1) frühe Frames zeigen eine Perle, in der die Marke nicht gelesen werden kann, (2) der Frame direkt nach dem Platzen hat keinen Wortmarkentext, der die Marke überlappt, (3) mid-dock-Text wird von der Markenkante abgeschnitten, (4) der letzte Frame hat eine scharfe Marke plus Wortmarke, zentriert, keine Tropfen, keine abgeschnittenen Glyphen. - Häufige Fehler: leere Leinwand (Importmap-Pfad falsch oder WebGL
three.core.jsnicht kopiert), Wortmarke nicht zentriert (Schriftart nicht geladen vor dem Messen), Logo mit weißem Kasten (undurchsichtiges PNG).
Lieferung
Übergeben Sie final.mp4 und den Projektordner (index.html, js/, assets/, vendor/), sodass er durch Bearbeiten der data-*-Attribute umgebrandet werden kann. Audio ist optional; ein kurzer Pop-SFX zum Zeitpunkt der Ruptur T.pop ist der einzige Ton, den das Stück braucht. Besorgen Sie Ton über das Skill media-use mit einem kommerziell lizenzierten Ergebnis, andernfalls liefern Sie stumm.