mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +00:00
* docs(catalog): put each item page's title, description and Docs text in the server HTML Mintlify renders snippet components in the browser only, so everything inside CatalogDetail (title, standfirst, the Docs tab) was missing from the HTML search engines read: 448 catalog pages served Googlebot no body text. The generator now writes the H1 and standfirst as page markup above the component and the Docs tab as page markup after it, shown with that tab (docs/custom.css). The component no longer draws its own title. Pages patched structurally only; registry drift on 14 pages is left for a regeneration of its own. * docs(catalog): keep the title's top spacing the component gave it * fix(docs): catalog titles and descriptions keep markdown markers literal MDX reads text inside the static <h1> and <p> as inline markdown, so @_blue_sweater_ rendered as italic blue_sweater. mdxText now writes backslash, backtick, * _ [ ] ~ as character references too, with a unit test; the four affected pages are re-escaped.
407 lines
15 KiB
Plaintext
407 lines
15 KiB
Plaintext
---
|
||
title: "Extruded Logo"
|
||
description: "Beveled 3D letters flip up one by one, the word swings so light runs across the bevels, then settles for a readable hold. Chrome, gold or matte."
|
||
mode: "frame"
|
||
---
|
||
|
||
import { CatalogDetail, CatalogSlot } from "/snippets/catalog-detail.jsx";
|
||
import { InstallCommand } from "/snippets/install-command.jsx";
|
||
|
||
<div className="hf-ve-static-head not-prose">
|
||
<h1>Extruded Logo</h1>
|
||
<p>Beveled 3D letters flip up one by one, the word swings so light runs across the bevels, then settles for a readable hold. Chrome, gold or matte.</p>
|
||
</div>
|
||
|
||
<CatalogDetail
|
||
previewSrc="/public/catalog/blocks/extruded-logo.json"
|
||
compositionId="extruded-logo"
|
||
compositionSrc="compositions/extruded-logo.html"
|
||
title="Extruded Logo"
|
||
variables={[{"id":"text","type":"string","role":"content","label":"Word or lettermark","description":"Basic Latin letters, digits and punctuation only; other characters render as ?","default":"NOVA","maxLength":8},{"id":"tagline","type":"string","role":"content","label":"Tagline","default":"Ships Thursday","maxLength":40},{"id":"finish","type":"enum","role":"style","label":"Finish","default":"chrome","options":[{"value":"chrome","label":"Chrome"},{"value":"gold","label":"Gold"},{"value":"matte","label":"Matte clay"}]},{"id":"rim_color","type":"color","role":"style","label":"Rim light","default":"#fff4e6"},{"id":"background","type":"color","role":"style","label":"Backdrop","default":"#0c0d12"}]}
|
||
meta={{"duration":5,"width":1920,"height":1080,"category":"3D objects","badge":"Stable","codeLines":331}}
|
||
attribution={{"path":"registry/blocks/extruded-logo","tags":["3d-object","three-js","webgl","logo","text","extruded","title-card"]}}
|
||
hasCode
|
||
rawUrl="https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/blocks/extruded-logo/extruded-logo.html"
|
||
>
|
||
|
||
<CatalogSlot slot="code">
|
||
|
||
```html extruded-logo.html
|
||
<!doctype html>
|
||
<!--
|
||
Extruded Logo: beveled 3D letters flip up one by one, the word swings slowly so light runs
|
||
across the bevels, then settles facing the camera for a readable hold.
|
||
Seek-safe: every frame is render(t), driven by one linear GSAP clock.
|
||
-->
|
||
<html
|
||
lang="en"
|
||
data-composition-variables='[
|
||
{ "id": "text", "type": "string", "role": "content", "label": "Word or lettermark", "description": "Basic Latin letters, digits and punctuation only; other characters render as ?", "default": "NOVA", "maxLength": 8 },
|
||
{ "id": "tagline", "type": "string", "role": "content", "label": "Tagline", "default": "Ships Thursday", "maxLength": 40 },
|
||
{ "id": "finish", "type": "enum", "role": "style", "label": "Finish", "default": "chrome", "options": [ { "value": "chrome", "label": "Chrome" }, { "value": "gold", "label": "Gold" }, { "value": "matte", "label": "Matte clay" } ] },
|
||
{ "id": "rim_color", "type": "color", "role": "style", "label": "Rim light", "default": "#fff4e6" },
|
||
{ "id": "background", "type": "color", "role": "style", "label": "Backdrop", "default": "#0c0d12" }
|
||
]'
|
||
>
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=1920, height=1080" />
|
||
<title>Extruded Logo</title>
|
||
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
||
<style>
|
||
@font-face {
|
||
font-family: "EL Inter";
|
||
font-weight: 500;
|
||
src: url(https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-500-normal.woff2)
|
||
format("woff2");
|
||
}
|
||
html,
|
||
body {
|
||
margin: 0;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
overflow: hidden;
|
||
background: #0c0d12;
|
||
}
|
||
#el-root {
|
||
position: relative;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
overflow: hidden;
|
||
background:
|
||
radial-gradient(900px 560px at 50% 46%, rgba(255, 255, 255, 0.09), transparent 70%),
|
||
var(--el-bg, #0c0d12);
|
||
}
|
||
#el-canvas {
|
||
position: absolute;
|
||
inset: 0;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
display: block;
|
||
}
|
||
#el-tagline {
|
||
position: absolute;
|
||
left: 0;
|
||
right: 0;
|
||
top: 790px;
|
||
text-align: center;
|
||
font:
|
||
500 38px/1.2 "EL Inter",
|
||
system-ui,
|
||
sans-serif;
|
||
letter-spacing: 0.02em;
|
||
color: rgba(236, 238, 245, 0.72);
|
||
opacity: 0;
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div
|
||
id="el-root"
|
||
data-composition-id="extruded-logo"
|
||
data-start="0"
|
||
data-duration="5"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
>
|
||
<canvas
|
||
id="el-canvas"
|
||
class="clip"
|
||
data-start="0"
|
||
data-duration="5"
|
||
data-track-index="1"
|
||
></canvas>
|
||
<div id="el-tagline"></div>
|
||
</div>
|
||
|
||
<script>
|
||
(function () {
|
||
var html = document.documentElement;
|
||
var defaults = {};
|
||
try {
|
||
JSON.parse(html.getAttribute("data-composition-variables") || "[]").forEach(function (v) {
|
||
defaults[v.id] = v.default;
|
||
});
|
||
} catch (error) {
|
||
/* malformed declaration: the scene module falls back to its own defaults */
|
||
}
|
||
var scoped =
|
||
(window.__hyperframes &&
|
||
window.__hyperframes.getVariables &&
|
||
window.__hyperframes.getVariables()) ||
|
||
{};
|
||
var vars = Object.assign({}, defaults, window.__hfVariables || {}, scoped);
|
||
var root = document.getElementById("el-root");
|
||
var duration = Math.max(0.001, parseFloat(root.dataset.duration) || 5);
|
||
if (/^#[0-9a-f]{6}$/i.test(String(vars.background)))
|
||
root.style.setProperty("--el-bg", vars.background);
|
||
var tagline = document.getElementById("el-tagline");
|
||
tagline.textContent = vars.tagline || "";
|
||
|
||
var clock = { t: 0 };
|
||
var scene = { vars: vars, duration: duration, clock: clock, render: null };
|
||
window.__extrudedLogo = scene;
|
||
window.__hf = window.__hf || {};
|
||
window.__hf.buildReady = window.__hf.buildReady || {};
|
||
window.__hf.buildReady["extruded-logo"] = new Promise(function (resolve) {
|
||
scene.ready = resolve;
|
||
});
|
||
|
||
var tl = gsap.timeline({ paused: true });
|
||
tl.to(clock, {
|
||
t: duration,
|
||
duration: duration,
|
||
ease: "none",
|
||
onUpdate: function () {
|
||
if (scene.render) scene.render(clock.t);
|
||
},
|
||
});
|
||
tl.fromTo(
|
||
tagline,
|
||
{ opacity: 0, y: 16 },
|
||
{ opacity: 1, y: 0, duration: 0.6, ease: "power2.out" },
|
||
Math.min(1.7, duration * 0.34),
|
||
);
|
||
window.__timelines = window.__timelines || {};
|
||
window.__timelines["extruded-logo"] = tl;
|
||
})();
|
||
</script>
|
||
|
||
<script type="module">
|
||
import * as THREE from "https://cdn.jsdelivr.net/npm/three@0.184.0/+esm";
|
||
import { FontLoader } from "https://cdn.jsdelivr.net/npm/three@0.184.0/examples/jsm/loaders/FontLoader.js/+esm";
|
||
import { TextGeometry } from "https://cdn.jsdelivr.net/npm/three@0.184.0/examples/jsm/geometries/TextGeometry.js/+esm";
|
||
|
||
const host = window.__extrudedLogo;
|
||
const V = host.vars;
|
||
const hex = (v, fallback) => (/^#[0-9a-f]{6}$/i.test(String(v)) ? String(v) : fallback);
|
||
|
||
const renderer = new THREE.WebGLRenderer({
|
||
canvas: document.getElementById("el-canvas"),
|
||
antialias: true,
|
||
alpha: true,
|
||
preserveDrawingBuffer: true,
|
||
});
|
||
renderer.setPixelRatio(1);
|
||
renderer.setSize(1920, 1080, false);
|
||
renderer.outputColorSpace = THREE.SRGBColorSpace;
|
||
renderer.toneMapping = THREE.ACESFilmicToneMapping;
|
||
|
||
const scene = new THREE.Scene();
|
||
// Softbox studio: bright strips on black, so chrome shows crisp bands instead of grey.
|
||
const studio = new THREE.Scene();
|
||
studio.background = new THREE.Color(0x040406);
|
||
const softbox = (w, h, x, y, z, color, power) => {
|
||
const mat = new THREE.MeshBasicMaterial({
|
||
color: new THREE.Color(color).multiplyScalar(power),
|
||
side: THREE.DoubleSide,
|
||
});
|
||
const panel = new THREE.Mesh(new THREE.PlaneGeometry(w, h), mat);
|
||
panel.position.set(x, y, z);
|
||
panel.lookAt(0, 0, 0);
|
||
studio.add(panel);
|
||
};
|
||
softbox(10, 2.2, 0, 7, 1, 0xffffff, 3);
|
||
softbox(1.2, 7, -7, 1, 2, 0xffffff, 2.2);
|
||
softbox(1.2, 7, 7, 1, -1, 0xffffff, 1.6);
|
||
// Behind the camera: the panel the letter faces mirror. Vertical bars sweep across
|
||
// the faces as the word swings.
|
||
const bars = document.createElement("canvas");
|
||
bars.width = 1024;
|
||
bars.height = 256;
|
||
const bg = bars.getContext("2d");
|
||
const fade = bg.createLinearGradient(0, 0, 0, 256);
|
||
fade.addColorStop(0, "#9a9ca3");
|
||
fade.addColorStop(1, "#15161a");
|
||
bg.fillStyle = fade;
|
||
bg.fillRect(0, 0, 1024, 256);
|
||
bg.fillStyle = "#ffffff";
|
||
for (const [x, w] of [
|
||
[150, 60],
|
||
[430, 140],
|
||
[760, 36],
|
||
])
|
||
bg.fillRect(x, 0, w, 256);
|
||
const mirror = new THREE.Mesh(
|
||
new THREE.PlaneGeometry(22, 8),
|
||
new THREE.MeshBasicMaterial({
|
||
map: new THREE.CanvasTexture(bars),
|
||
color: new THREE.Color(2.2, 2.2, 2.2),
|
||
side: THREE.DoubleSide,
|
||
}),
|
||
);
|
||
mirror.position.set(0, 1, 9);
|
||
mirror.lookAt(0, 1, 0);
|
||
studio.add(mirror);
|
||
softbox(9, 1.4, 0, 0.5, -7, hex(V.rim_color, "#fff4e6"), 2);
|
||
const pmrem = new THREE.PMREMGenerator(renderer);
|
||
scene.environment = pmrem.fromScene(studio, 0.01).texture;
|
||
|
||
const camera = new THREE.PerspectiveCamera(26, 1920 / 1080, 0.1, 100);
|
||
camera.position.set(0, 0.9, 11);
|
||
camera.lookAt(0, 0.35, 0);
|
||
|
||
const rim = new THREE.DirectionalLight(new THREE.Color(hex(V.rim_color, "#fff4e6")), 5);
|
||
rim.position.set(0, 3, -6);
|
||
scene.add(rim);
|
||
const key = new THREE.DirectionalLight(0xffffff, 1.4);
|
||
key.position.set(-5, 4, 6);
|
||
scene.add(key);
|
||
|
||
const finishes = {
|
||
chrome: { color: 0xe9ecf2, metalness: 1, roughness: 0.16 },
|
||
gold: { color: 0xe7bf6a, metalness: 1, roughness: 0.2 },
|
||
matte: { color: 0xe8e2d8, metalness: 0, roughness: 0.62 },
|
||
};
|
||
const material = new THREE.MeshStandardMaterial(finishes[V.finish] || finishes.chrome);
|
||
|
||
// Beside this file when mounted; a runtime without assetUrl keeps the plain path.
|
||
const assetUrl = (path) =>
|
||
typeof __hyperframes !== "undefined" && __hyperframes.assetUrl
|
||
? __hyperframes.assetUrl(path)
|
||
: path;
|
||
// Geist Bold (OFL), basic Latin only, converted to three.js typeface JSON.
|
||
const font = await new FontLoader().loadAsync(
|
||
assetUrl("assets/fonts/Geist-Bold.typeface.json"),
|
||
);
|
||
const text = String(V.text || "NOVA")
|
||
.toUpperCase()
|
||
.slice(0, 8)
|
||
.split("");
|
||
const SIZE = 1.5;
|
||
const scale = SIZE / font.data.resolution;
|
||
const tracking = 0.08;
|
||
const word = new THREE.Group();
|
||
scene.add(word);
|
||
|
||
// One mesh per letter, pivoting on its baseline so each can flip up on its own beat.
|
||
const letters = [];
|
||
let cursor = 0;
|
||
for (const ch of text) {
|
||
const advance = ((font.data.glyphs[ch] || font.data.glyphs["?"]).ha || 600) * scale;
|
||
if (ch.trim()) {
|
||
const geometry = new TextGeometry(ch, {
|
||
font,
|
||
size: SIZE,
|
||
depth: 0.42,
|
||
curveSegments: 10,
|
||
bevelEnabled: true,
|
||
bevelThickness: 0.06,
|
||
bevelSize: 0.035,
|
||
bevelSegments: 5,
|
||
});
|
||
geometry.computeBoundingBox();
|
||
const b = geometry.boundingBox;
|
||
geometry.translate(-(b.min.x + b.max.x) / 2, 0, -0.21);
|
||
const pivot = new THREE.Group();
|
||
pivot.position.x = cursor + advance / 2;
|
||
pivot.add(new THREE.Mesh(geometry, material));
|
||
word.add(pivot);
|
||
letters.push(pivot);
|
||
}
|
||
cursor += advance + tracking;
|
||
}
|
||
const width = cursor - tracking;
|
||
for (const p of letters) p.position.x -= width / 2;
|
||
// Longer words shrink to keep a margin either side.
|
||
word.scale.setScalar(Math.min(1, 7.4 / width));
|
||
|
||
const shadowCanvas = document.createElement("canvas");
|
||
shadowCanvas.width = 512;
|
||
shadowCanvas.height = 128;
|
||
const sg = shadowCanvas.getContext("2d");
|
||
const grad = sg.createRadialGradient(256, 64, 0, 256, 64, 256);
|
||
grad.addColorStop(0, "rgba(0,0,0,0.6)");
|
||
grad.addColorStop(1, "rgba(0,0,0,0)");
|
||
sg.setTransform(1, 0, 0, 0.25, 0, 48);
|
||
sg.fillStyle = grad;
|
||
sg.fillRect(0, 0, 512, 512);
|
||
const shadow = new THREE.Mesh(
|
||
new THREE.PlaneGeometry(Math.min(width, 7.4) * 1.25, 1.4),
|
||
new THREE.MeshBasicMaterial({
|
||
map: new THREE.CanvasTexture(shadowCanvas),
|
||
transparent: true,
|
||
depthWrite: false,
|
||
}),
|
||
);
|
||
shadow.rotation.x = -Math.PI / 2;
|
||
shadow.position.y = -0.02;
|
||
scene.add(shadow);
|
||
|
||
const clamp01 = (x) => Math.min(1, Math.max(0, x));
|
||
const easeOutBack = (x) => {
|
||
const u = clamp01(x) - 1;
|
||
return 1 + 2.2 * u * u * u + 1.2 * u * u;
|
||
};
|
||
const easeInOut = (x) => {
|
||
const u = clamp01(x);
|
||
return u < 0.5 ? 4 * u * u * u : 1 - Math.pow(-2 * u + 2, 3) / 2;
|
||
};
|
||
|
||
host.render = (t) => {
|
||
const D = host.duration;
|
||
const k = Math.min(1, D / 5);
|
||
letters.forEach((p, i) => {
|
||
const u = easeOutBack((t - 0.1 * k - i * 0.13 * k) / (0.9 * k));
|
||
// Lying face-down behind the baseline at 0, standing at 1.
|
||
p.rotation.x = (1 - u) * (-Math.PI / 2);
|
||
p.position.y = (1 - clamp01(u)) * -0.2;
|
||
p.visible = t >= 0.1 * k + i * 0.13 * k;
|
||
});
|
||
const swing = easeInOut((t - 0.9 * k) / (D - 0.9 * k - 0.7 * k));
|
||
word.rotation.y = -0.42 + swing * 0.42;
|
||
word.rotation.x = 0.04 - swing * 0.04;
|
||
renderer.render(scene, camera);
|
||
};
|
||
host.render(host.clock.t);
|
||
host.ready();
|
||
</script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
</CatalogSlot>
|
||
|
||
<CatalogSlot slot="install">
|
||
|
||
<InstallCommand command="npx hyperframes add extruded-logo" item="extruded-logo" />
|
||
|
||
That writes `compositions/extruded-logo.html`, plus 2 supporting files under `compositions/assets/fonts/`.
|
||
|
||
</CatalogSlot>
|
||
|
||
</CatalogDetail>
|
||
|
||
<div data-static-slot="docs" className="prose prose-gray dark:prose-invert">
|
||
|
||
## Add it to your video
|
||
|
||
It runs for 5 seconds at 1920×1080. Paste this into your composition:
|
||
|
||
```html index.html
|
||
<div
|
||
data-composition-id="extruded-logo"
|
||
data-composition-src="compositions/extruded-logo.html"
|
||
data-start="0"
|
||
data-duration="5"
|
||
data-track-index="1"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
></div>
|
||
```
|
||
|
||
Move it in time with `data-start`. Put it on a different timeline row with
|
||
`data-track-index`. See [data attributes](/concepts/data-attributes) for the rest.
|
||
|
||
{/* hf:generated-footer */}
|
||
|
||
Tagged `3d-object` `three-js` `webgl` `logo` `text` `extruded` `title-card`.
|
||
|
||
## Related topics
|
||
|
||
- [Browse the complete Catalog](/catalog)
|
||
- [Add assets and Catalog items in the browser editor](/studio/assets-and-blocks)
|
||
- [Put blocks together into one video](/concepts/compositions)
|
||
|
||
</div>
|