Revelación de logotipo líquido
Una gota de vidrio WebGL (Three.js) con transmisión física, superficie desplazada por ruido y dispersión se sitúa frente al logotipo. El logotipo se refracta tanto que no puede leerse. Se acumula presión, todo se congela por un instante, la gota estalla, 15 gotitas vuelan, y la marca se desliza hacia la izquierda mientras el texto emerge desde detrás de ella. Los fotogramas son funciones puras del tiempo de búsqueda, por lo que los renders son deterministas.
Entradas
| Entrada | Notas |
|---|---|
| Marca del logotipo | SVG o PNG. Solo la marca (símbolo), forma más bien cuadrada, fondo transparente. |
| Texto de marca | Una cadena de texto tipografiada en Inter por defecto. Si la marca tiene un texto gráfico real, consulta 'Texto como obra gráfica'. |
| Paleta | Tres colores: un acento fuerte, un tinte suave, un neutro apagado. Se convierten en campos de color borrosos detrás del vidrio; el vidrio es incoloro y solo muestra lo que tiene detrás. Color de tinta para el texto de marca. |
| Duración | Por defecto 7 s. La pausa después de que el logotipo se asienta es la única parte que deberías estirar. |
Usa únicamente los activos que el usuario haya proporcionado o que estén en el kit de marca. Nunca obtengas logotipos de la web.
Logotipos solo raster
- La plantilla requiere un PNG con canal alfa. Si el logotipo tiene fondo opaco (JPG, recuadro blanco), elimínalo primero (
npx hyperframes remove-background, o pídele al usuario un archivo transparente). No entregues un cuadrado blanco refractándose dentro de la gota. - Un PNG pequeño (menos de ~600 px) es suficiente porque la marca se muestra a unos 250 px en reposo, pero se escala a ~360 px dentro de la gota. Mantén la fuente al menos 512 px en el lado más largo.
- Recorta el relleno transparente para que la marca visible llene la imagen; el código dimensiona el cuadro de la imagen, no la tinta.
- SVG: rasteriza a un PNG de unos 1720 px en el lado más largo (captura de pantalla con headless Chrome, o
rsvg-convert -w 1720), conserva el alfa y apuntadata-logo-srca él. No redibujes ni recolorees el logotipo. - Si el logotipo de la marca es una imagen combinada (marca y texto fusionados), no puedes separarlos limpiamente. Usa el logotipo completo como marca, establece
data-wordmark=""y omite la aparición del texto (configura el clip del texto para que esté siempre oculto). La marca entonces se ancla al centro, no a la izquierda.
Flujo de trabajo de construcción
- Andamio:
npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, luego reemplaza suindex.htmlcon eltemplate/index.htmlde esta habilidad y copiatemplate/js/,template/assets/logo.png(sobrescribe con la marca). - Añade las dependencias como archivos locales para que el renderizado nunca toque la red. En un directorio temporal (NO dentro de otro proyecto,
npm isube hasta elpackage.jsonmás cercano) ejecutanpm i [email protected] [email protected] @fontsource-variable/inter, luego copia en el proyecto:gsap/dist/gsap.min.jsavendor/gsap.min.jsthree/build/three.module.jsythree/build/three.core.jsavendor/three/build/three/examples/jsm/environments/RoomEnvironment.jsavendor/three/examples/jsm/environments/@fontsource-variable/inter/files/inter-latin-wght-normal.woff2aassets/fonts/
- Personaliza con los atributos
data-*en#rootdentro deindex.html:data-logo-src,data-wordmark,data-ink,data-fields(tres colores hex). Mantén los campos saturados en el acento y suaves en los demás; nunca hagas que el campo detrás del centro de la gota sea oscuro y plano. - Revisa y verifica:
npx --yes hyperframes lintluegonpx --yes hyperframes check. Ambos deben estar limpios. - Revisión de fotogramas (abajo). Ajusta. Repite.
- Renderiza:
npx --yes hyperframes render --workers 2 --output final.mp4. Verifícalo:ffprobedebe reportar h264, 1920×1080, 30 fps, la duración esperada.
Reglas de movimiento (lo que hace que el formato funcione)
- Ilegible, no invisible. Antes del estallido, el espectador debe ver color y formas distorsionadas de la marca, nunca leerla. Si un fotograma muestra el logotipo reconocible, aumenta
thickness/ amplitud de desplazamiento / giro; si la gota es una mancha plana sin indicio de la marca, redúcelos. - La marca está detrás del vidrio, en el pase opaco. El plano previo al estallido usa
alphaTest(cola opaca) para que el pase de transmisión de Three pueda refractarlo. Un planotransparent: truenormal no se refractaría. La copia 'revelada' es transparente y se intercambia solo después de que la carcasa haya colapsado. - Fases, en orden (todas las constantes en
Tal principio dejs/liquid-reveal.js): establecimiento (recorte cercano a gota completa, 0,7 s) luego rendimiento líquido, acumulación de presión (la gota se aplasta más ancha y plana, la marca se hincha de 1,00 a 1,06), coma (0,4 s de inmovilidad total: cámara, marca, gota y reloj del sombreado congelados), ruptura (la carcasa colapsa en 0,2 s con una facilidad de potencia 4, las gotitas se lanzan radialmente), anclaje (la marca retrocede y luego se desliza a su posición de bloqueo mientras el texto emerge desde detrás), pausa. - La inmovilidad es el punto. La congelación de 0,4 s antes del estallido es lo que vende la ruptura. Sin respiración ociosa, flotación o brillo en bucle en ningún lugar.
- El reloj del sombreado está controlado. El tiempo de ruido avanza solo en ventanas autorizadas y se congela en la coma y después del anclaje.
- El texto emerge desde la marca, nunca aparece de golpe. El borde izquierdo de su clip sigue el borde derecho de la marca, por lo que el texto nunca es sobrescrito por la marca durante el anclaje.
- Gotitas: diseño fijo de ángulo dorado (sin
Math.random), lanzamiento radial, un término de gravedad, luego se reducen a nada para que el fotograma final esté limpio. - Termina con un bloqueo estático. Marca y texto erguidos, centrados como un par, sin atenuación. Si la pieza es una intro que se cortará en un video más largo, acorta la pausa en lugar de atenuar.
- Determinismo: todo se calcula a partir del tiempo
hf-seek. SinrequestAnimationFrame,Date.now,Math.random. La única medición del DOM es el ancho del texto, tomada una vez al cargar (canvasmeasureTextcon la fuente incluida).
Ajustes
| Quieres | Cambia |
|---|---|
| Más largo o más corto | Constantes T y data-duration en #root y en ambos elementos .clip (mantenlos iguales) |
| Gota más abstracta | aumenta thickness (3,2) o la amplitud de desplazamiento (0,15); reduce para legibilidad |
| Aspecto gelatinoso vs. de gotita | dispersion, attenuationColor en liquidMaterial() |
| Bloqueo más grande o más pequeño | L.markPx, L.fontPx, L.gap |
| Fondo más tranquilo | reduce los tres pesos de campo * 0.50 / 0.80 / 0.35 en el sombreado de fondo |
Texto como obra gráfica
Si la marca proporciona un SVG/PNG del texto, reemplaza el texto #wordmark con un <img> de la misma lógica de posición y ancho: mide su relación de aspecto, establece su altura a L.fontPx * 0.8 y mantén la misma lógica de clip-path. Nunca reescribas un texto estilizado con una fuente sustituta.
Validación
lintychecklimpios (un error de lint deshabilita silenciosamente las auditorías de diseño).- Extrae fotogramas y míralos:
npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5y abresnapshots/contact-sheet.jpg, offmpeg -ss <t> -i final.mp4 -frames:v 1 f.pngsobre el render. Verifica: (1) los primeros fotogramas muestran una gota donde la marca no puede leerse, (2) el fotograma justo después del estallido no tiene texto superpuesto a la marca, (3) el texto a medio anclar está recortado por el borde de la marca, (4) el fotograma final tiene marca más texto nítidos, centrados, sin gotitas, sin glifos recortados. - Fallos comunes: lienzo en blanco (ruta de importmap incorrecta, o
three.core.jsde WebGL no copiado), texto descentrado (fuente no cargada antes de medir), logotipo con recuadro blanco (PNG opaco).
Entrega
Entrega final.mp4 y la carpeta del proyecto (index.html, js/, assets/, vendor/) para que pueda ser personalizado editando los atributos data-*. El audio es opcional; un breve SFX de estallido en el momento de ruptura T.pop es el único sonido que la pieza necesita. Obtén cualquier sonido a través de la habilidad media-use con un resultado con licencia comercial; de lo contrario, entrégalo sin sonido.