液體商標揭示動畫
一個WebGL (Three.js) 玻璃珠粒,具備物理透射、噪點位移表面與色散,置於商標前方。商標被劇烈折射而無法閱讀。壓力累積,一切停頓一拍,珠粒爆裂,15滴液滴飛散,然後商標向左滑入定位,文字標誌從其後方擦出。所有幀皆為搜尋時間的純函數,因此渲染結果是確定性的。
輸入
| 輸入 | 說明 |
|---|---|
| 商標圖案 | SVG 或 PNG。僅圖案(符號),接近正方形,透明背景。 |
| 文字標誌 | 預設使用Inter字體排版的文字字串。如果品牌有實際的文字標誌圖形,請參閱「文字標誌作為圖稿」。 |
| 色系 | 三種顏色:強烈強調色、柔和淡色、沈穩中性色。它們成為玻璃後方的模糊色塊;玻璃本身無色,僅顯示其後方的內容。文字標誌的墨水顏色。 |
| 時長 | 預設7秒。組合定位後的停頓是唯一可以延長的部分。 |
僅能使用使用者提供或品牌資料夾中的素材。切勿從網路擷取商標。
僅點陣圖的商標
- 範本需要含透明通道的PNG。如果商標有不透明背景(JPG、白色色塊),請先移除背景(
npx hyperframes remove-background,或向使用者索取透明檔案)。請勿在珠粒內呈現白色方塊折射。 - 較小的PNG(約600px以下)尚可接受,因為商標靜止時顯示約250px,但在珠粒內會放大至約360px。來源圖檔的長邊至少維持512px。
- 裁切透明邊距,使可見商標填滿影像;程式碼設定的是影像框的大小,而非墨水面積。
- SVG:點陣化為長邊約1720px的PNG(無頭Chrome螢幕截圖,或
rsvg-convert -w 1720),保留透明通道,並將data-logo-src指向該檔案。請勿重繪或重新著色商標。 - 如果品牌商標是合併的組合圖像(圖案與文字融合),則無法乾淨分離。請將整個組合圖像作為圖案使用,設定
data-wordmark="",並跳過文字標誌擦入效果(將文字標誌剪裁設為永遠隱藏)。此時圖案將定位在中央,而非左側。
建置工作流程
- 初始化:
npx --yes hyperframes init <dir> -e blank --non-interactive --skip-skills,然後將此技能的template/index.html取代其index.html,並複製template/js/、template/assets/logo.png(以品牌圖案覆蓋)。 - 將執行時期納入vendor,使渲染時無需網路連線。在暫存目錄中(勿在另一個專案內,
npm i會向上尋找最近的package.json)執行npm i [email protected] [email protected] @fontsource-variable/inter,然後複製到專案中:gsap/dist/gsap.min.js至vendor/gsap.min.jsthree/build/three.module.js與three/build/three.core.js至vendor/three/build/three/examples/jsm/environments/RoomEnvironment.js至vendor/three/examples/jsm/environments/@fontsource-variable/inter/files/inter-latin-wght-normal.woff2至assets/fonts/
- 在
index.html中透過#root上的資料屬性進行品牌設定:data-logo-src、data-wordmark、data-ink、data-fields(三個十六進制顏色)。保持色塊在強調色處飽和,其他地方柔和;切勿讓珠粒中央後方的色塊變得暗沉且平坦。 - 程式碼檢查與校驗:
npx --yes hyperframes lint接著npx --yes hyperframes check。兩者都必須乾淨通過。 - 影格檢視(下方)。調整。重複。
- 渲染:
npx --yes hyperframes render --workers 2 --output final.mp4。檢查:ffprobe應顯示 h264、1920x1080、30fps、預期時長。
動態規則(使格式有效的關鍵)
- 無法辨識,而非不可見。 在爆裂前,觀看者應看到顏色與商標的扭曲形狀,但從未讀出它。如果某影格顯示商標可辨識,請提高
thickness/ 位移振幅 / 旋轉;如果珠粒是平坦的團塊且沒有商標的跡象,請降低它們。 - 商標位於玻璃後方,在不透明通道中。 爆裂前的平面使用
alphaTest(不透明佇列),因此Three.js的透射通道可以折射它。普通的transparent: true平面將不會被折射。「揭示後」的副本是透明的,僅在外殼塌陷後才切換。 - 階段,依序(所有常數定義於
js/liquid-reveal.js頂部的T):建立(近景裁切至完整珠粒,0.7秒)接著是液體表演、壓力累積(珠粒壓縮變寬變平,商標放大1.00至1.06)、逗號(0.4秒完全靜止:攝影機、商標、珠粒與著色器時鐘凍結)、爆裂(外殼在0.2秒內以四次方緩入塌陷,液滴徑向發射)、定位(商標回彈然後滑入定位槽,同時文字標誌從其後方擦出)、停頓。 - 靜止是關鍵。 爆裂前的0.4秒凍結是讓破裂感真實的關鍵。任何地方都沒有無意義的呼吸、漂浮或循環發光。
- 著色器時鐘受控。 噪點時間僅在指定的時間窗口內推進,並在逗號階段與定位完成後凍結。
- 文字標誌從商標中浮現,絕不突然出現。 其剪裁的左邊緣追蹤商標的右邊緣,因此文字絕不會在定位過程中與商標重疊。
- 液滴:黃金角固定佈局(無
Math.random),徑向發射,一個重力項,然後縮小至消失,使最終影格乾淨。 - 以靜止的商標組合結束。 商標與文字標誌直立、居中成對,無淡出。如果作品是將被剪入較長影片的開場,請縮短停頓時間而非淡出。
- 確定性:所有內容均從
hf-seek時間計算得出。無requestAnimationFrame、Date.now、Math.random。唯一的DOM測量是文字標誌寬度,在載入時測量一次(使用內附字體的canvasmeasureText)。
調整旋鈕
| 想要 | 改變 |
|---|---|
| 更長或更短 | T 常數與 #root 及兩個 .clip 元素上的 data-duration(保持相等) |
| 更抽象的珠粒 | 提高 thickness (3.2) 或位移振幅 (0.15);降低以提高可讀性 |
| 果凍感 vs. 液滴感 | liquidMaterial() 中的 dispersion、attenuationColor |
| 更大或更小的組合 | L.markPx、L.fontPx、L.gap |
| 更平靜的背景 | 降低背景著色器中三個 * 0.50 / 0.80 / 0.35 的色塊權重 |
文字標誌作為圖稿
如果品牌提供文字標誌的SVG/PNG,請將 #wordmark 文字替換為具有相同位置與寬度邏輯的 <img>:測量其長寬比,將其高度設為 L.fontPx * 0.8,並保持相同的 clip-path 邏輯。切勿以替代字體重新輸入風格化的文字標誌。
校驗
lint與check乾淨(lint錯誤會靜默停用佈局審核)。- 提取影格並檢視:
npx --yes hyperframes snapshot --at 0.3,1.5,3.3,3.55,3.9,6.5並開啟snapshots/contact-sheet.jpg,或在渲染檔上執行ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png。驗證:(1) 早期影格顯示珠粒,其中商標無法閱讀,(2) 爆裂後的影格沒有文字標誌文字與商標重疊,(3) 定位中段文字被商標邊緣剪裁,(4) 最終影格有清晰的商標加文字標誌、居中、無液滴、無被剪裁的字形。 - 常見失敗:空白畫布(importmap路徑錯誤,或WebGL
three.core.js未複製)、文字標誌偏移(字體載入前已測量)、帶白色背景的商標(不透明PNG)。
交付
交付 final.mp4 與專案資料夾(index.html、js/、assets/、vendor/),以便可透過編輯 data-* 屬性重新品牌化。音訊為選配;在爆裂時間 T.pop 處的短促爆裂音效是作品所需的唯一聲音。透過 media-use 技能取得具有商業授權結果的聲音,否則交付無聲版本。