Revelação líquida do logo
Uma conta de vidro WebGL (Three.js) com transmissão física, superfície deslocada por ruído e dispersão fica na frente do logo. O logo é refratado tão intensamente que não pode ser lido. A pressão aumenta, tudo congela por um instante, a conta estoura, 15 gotículas voam para fora, e a marca desliza para a esquerda enquanto o logotipo se revela por trás dela. Os quadros são funções puras do tempo de busca, portanto os renders são determinísticos.
Entradas
| Entrada | Notas |
|---|---|
| Marca do logo | SVG ou PNG. Marca apenas (símbolo), formato quadrado, fundo transparente. |
| Logotipo | Uma string de texto tipografada em Inter por padrão. Se a marca tiver um logotipo gráfico real, veja "Logotipo como arte". |
| Paleta | Três cores: um acento forte, um tom suave, um neutro opaco. Elas se tornam campos de cor desfocados atrás do vidro; o vidro é incolor e mostra apenas o que está atrás dele. Cor da tinta para o logotipo. |
| Duração | Padrão 7s. A pausa após o encaixe do conjunto é a única parte que você deve esticar. |
Use apenas ativos fornecidos pelo usuário ou que estejam no kit da marca. Nunca busque logos da web.
Logos apenas raster
- O modelo espera um PNG com alfa. Se o logo tiver um fundo opaco (JPG, caixa branca), remova-o primeiro (
npx hyperframes remove-background, ou peça ao usuário um arquivo transparente). Não entregue um quadrado branco sendo refratado dentro da conta. - Um PNG pequeno (abaixo de ~600px) é aceitável porque a marca é exibida com cerca de 250px em repouso, mas é ampliada para ~360px dentro da conta. Mantenha a fonte com pelo menos 512px no lado maior.
- Corte o preenchimento transparente para que a marca visível preencha a imagem; o código dimensiona a caixa da imagem, não a tinta.
- SVG: rasterize para um PNG com cerca de 1720px no lado maior (captura de tela do Chrome headless, ou
rsvg-convert -w 1720), mantenha alfa e apontedata-logo-srcpara ele. Não redesenhe ou recolorir o logo. - Se o logo da marca for uma imagem de conjunto combinada (marca e texto fundidos), você não pode separá-los limpidamente. Use o conjunto inteiro como a marca, defina
data-wordmark=""e pule a revelação do logotipo (defina o clipe do logotipo como sempre oculto). A marca então se ancora ao centro, não à esquerda.
Fluxo de construção
- Scaffolding:
npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills, depois substitua seuindex.htmlpelotemplate/index.htmldeste skill e copietemplate/js/,template/assets/logo.png(sobrescreva com a marca da marca). - Vendedorize o runtime para que a renderização nunca toque a rede. Em um diretório temporário (NÃO dentro de outro projeto,
npm isobe até o package.json mais próximo) executenpm i [email protected] [email protected] @fontsource-variable/inter, depois copie para o projeto:gsap/dist/gsap.min.jsparavendor/gsap.min.jsthree/build/three.module.jsethree/build/three.core.jsparavendor/three/build/three/examples/jsm/environments/RoomEnvironment.jsparavendor/three/examples/jsm/environments/@fontsource-variable/inter/files/inter-latin-wght-normal.woff2paraassets/fonts/
- Personalize com os atributos de dados em
#rootnoindex.html:data-logo-src,data-wordmark,data-ink,data-fields(três cores hexadecimais). Mantenha os campos saturados no acento e suaves nas outras cores; nunca deixe o campo atrás do centro da conta escuro e plano. - Linting e verificação:
npx --yes hyperframes lintdepoisnpx --yes hyperframes check. Ambos devem estar limpos. - Revisão de quadros (abaixo). Ajuste. Repita.
- Renderização:
npx --yes hyperframes render --workers 2 --output final.mp4. Analise:ffprobedeve relatar h264, 1920x1080, 30fps, a duração esperada.
Regras de movimento (o que faz o formato funcionar)
- Ilegível, não invisível. Antes do estouro, o espectador deve ver cor e formas distorcidas da marca, nunca lê-la. Se um quadro mostrar o logo reconhecível, aumente
thickness/ amplitude de deslocamento / rotação; se a conta for uma mancha plana sem vestígio da marca, reduza-os. - Marca atrás do vidro, na passagem opaca. O plano pré-estouro usa
alphaTest(fila opaca) para que a passagem de transmissão do Three.js possa refratá-lo. Um plano simplestransparent: truenão seria refratado. A cópia "revelada" é transparente e trocada apenas após o colapso da casca. - Fases, em ordem (todas constantes em
Tno topo dejs/liquid-reveal.js): estabelecimento (corte próximo à conta cheia, 0,7s) depois performance líquida, acúmulo de pressão (conta fica mais larga e achatada, marca incha de 1,00 para 1,06), vírgula (0,4s de imobilidade total: câmera, marca, conta e relógio do shader congelados), ruptura (casca colapsa em 0,2s com facilidade power-4, gotículas lançam radialmente), encaixe (marca recua e desliza para sua posição final enquanto o logotipo se revela por trás), pausa. - A imobilidade é o ponto. O congelamento de 0,4s antes do estouro é o que vende a ruptura. Nenhuma respiração ociosa, flutuação ou brilho em loop em nenhum lugar.
- Relógio do shader é controlado. O tempo de ruído avança apenas em janelas autorizadas e congela na vírgula e após o encaixe.
- Logotipo emerge da marca, nunca aparece de repente. Sua borda esquerda do clipe segue a borda direita da marca, então o texto nunca é sobreposto pela marca durante o encaixe.
- Gotículas: layout fixo de ângulo dourado (sem
Math.random), lançamento radial, um termo de gravidade, depois encolhem até nada para que o quadro final esteja limpo. - Termine com um conjunto parado. Marca e logotipo verticais, centralizados como um par, sem desaparecimento. Se a peça for uma introdução que será cortada em um vídeo mais longo, encurte a pausa em vez de desvanecer.
- Determinismo: tudo é calculado a partir do tempo
hf-seek. SemrequestAnimationFrame,Date.now,Math.random. A única medição de DOM é a largura do logotipo, feita uma vez no carregamento (measureTextcom a fonte fornecida).
Parâmetros de ajuste
| Desejo | Mudança |
|---|---|
| Mais longo ou mais curto | Constantes T e data-duration em #root e em ambos os elementos .clip (mantenha-os iguais) |
| Conta mais abstrata | aumentar thickness (3.2) ou a amplitude de deslocamento (0.15); diminuir para legibilidade |
| Aparência gelatinosa vs. gotícula | dispersion, attenuationColor em liquidMaterial() |
| Conjunto maior ou menor | L.markPx, L.fontPx, L.gap |
| Fundo mais calmo | reduzir os três pesos de campo * 0.50 / 0.80 / 0.35 no shader de fundo |
Logotipo como arte
Se a marca fornecer um SVG/PNG do logotipo, substitua o texto #wordmark por uma <img> com a mesma lógica de posição e largura: meça sua proporção, defina sua altura para L.fontPx * 0.8 e mantenha a mesma lógica de clip-path. Nunca redigite um logotipo estilizado em uma fonte substituta.
Validação
lintechecklimpos (um erro de lint desabilita silenciosamente as auditorias de layout).- Extraia quadros e observe-os:
npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5e abrasnapshots/contact-sheet.jpg, ouffmpeg -ss <t> -i final.mp4 -frames:v 1 f.pngno render. Verifique: (1) quadros iniciais mostram uma conta onde a marca não pode ser lida, (2) o quadro logo após o estouro não tem texto do logotipo sobrepondo a marca, (3) texto durante o encaixe é cortado pela borda da marca, (4) quadro final tem marca mais logotipo nítidos, centralizados, sem gotículas, sem glifos cortados. - Falhas comuns: tela em branco (caminho do importmap errado, ou
three.core.jsnão copiado), logotipo descentralizado (fonte não carregada antes da medição), logo com caixa branca (PNG opaco).
Entrega
Entregue final.mp4 e a pasta do projeto (index.html, js/, assets/, vendor/) para que possa ser personalizado novamente editando os atributos data-*. O áudio é opcional; um efeito sonoro curto de estouro no momento da ruptura T.pop é o único som que a peça precisa. Obtenha qualquer som através do skill media-use com um resultado licenciado comercialmente, caso contrário, entregue sem áudio.