mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-19 11:26:02 +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.
439 lines
16 KiB
Plaintext
439 lines
16 KiB
Plaintext
---
|
||
title: "Product Turntable"
|
||
description: "A product turns a full revolution on a studio plinth in a seamless loop. Drop in a GLB or glTF model, or keep the built-in drink can with your own label."
|
||
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>Product Turntable</h1>
|
||
<p>A product turns a full revolution on a studio plinth in a seamless loop. Drop in a GLB or glTF model, or keep the built-in drink can with your own label.</p>
|
||
</div>
|
||
|
||
<CatalogDetail
|
||
previewSrc="/public/catalog/blocks/product-turntable.json"
|
||
compositionId="product-turntable"
|
||
compositionSrc="compositions/product-turntable.html"
|
||
title="Product Turntable"
|
||
variables={[{"id":"model_url","type":"string","role":"content","label":"Model URL (.glb or .gltf)","description":"Leave empty for the built-in drink can.","default":""},{"id":"product_name","type":"string","role":"content","label":"Label wordmark","default":"YUZU","maxLength":10},{"id":"flavor","type":"string","role":"content","label":"Label line","default":"Sparkling Citrus","maxLength":28},{"id":"caption","type":"string","role":"content","label":"Caption","default":"Sparkling Citrus · 355 ml","maxLength":40},{"id":"label_color","type":"color","role":"style","label":"Label color","default":"#f2c230"},{"id":"ink_color","type":"color","role":"style","label":"Label ink","default":"#1d2a24"},{"id":"background","type":"color","role":"style","label":"Backdrop","default":"#e8e4dc"},{"id":"turns","type":"number","role":"motion","label":"Turns per clip","default":1,"min":1,"max":4,"step":1}]}
|
||
meta={{"duration":6,"width":1920,"height":1080,"category":"3D objects","badge":"Stable","codeLines":363}}
|
||
attribution={{"path":"registry/blocks/product-turntable","tags":["3d-object","three-js","webgl","product","turntable","glb","loop"]}}
|
||
hasCode
|
||
rawUrl="https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/blocks/product-turntable/product-turntable.html"
|
||
>
|
||
|
||
<CatalogSlot slot="code">
|
||
|
||
```html product-turntable.html
|
||
<!doctype html>
|
||
<!--
|
||
Product Turntable: one product turns a full revolution on a studio plinth, a seamless loop.
|
||
model_url takes a .glb/.gltf; empty uses the built-in procedural drink can.
|
||
Seek-safe: every frame is render(t), driven by one linear GSAP clock.
|
||
-->
|
||
<html
|
||
lang="en"
|
||
data-composition-variables='[
|
||
{ "id": "model_url", "type": "string", "role": "content", "label": "Model URL (.glb or .gltf)", "description": "Leave empty for the built-in drink can.", "default": "" },
|
||
{ "id": "product_name", "type": "string", "role": "content", "label": "Label wordmark", "default": "YUZU", "maxLength": 10 },
|
||
{ "id": "flavor", "type": "string", "role": "content", "label": "Label line", "default": "Sparkling Citrus", "maxLength": 28 },
|
||
{ "id": "caption", "type": "string", "role": "content", "label": "Caption", "default": "Sparkling Citrus · 355 ml", "maxLength": 40 },
|
||
{ "id": "label_color", "type": "color", "role": "style", "label": "Label color", "default": "#f2c230" },
|
||
{ "id": "ink_color", "type": "color", "role": "style", "label": "Label ink", "default": "#1d2a24" },
|
||
{ "id": "background", "type": "color", "role": "style", "label": "Backdrop", "default": "#e8e4dc" },
|
||
{ "id": "turns", "type": "number", "role": "motion", "label": "Turns per clip", "default": 1, "min": 1, "max": 4, "step": 1 }
|
||
]'
|
||
>
|
||
<head>
|
||
<meta charset="UTF-8" />
|
||
<meta name="viewport" content="width=1920, height=1080" />
|
||
<title>Product Turntable</title>
|
||
<script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
|
||
<style>
|
||
@font-face {
|
||
font-family: "PT Caption";
|
||
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: #e8e4dc;
|
||
}
|
||
#pt-root {
|
||
position: relative;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
overflow: hidden;
|
||
background:
|
||
radial-gradient(1100px 760px at 50% 38%, rgba(255, 255, 255, 0.72), transparent 70%),
|
||
var(--pt-bg, #e8e4dc);
|
||
}
|
||
#pt-canvas {
|
||
position: absolute;
|
||
inset: 0;
|
||
width: 1920px;
|
||
height: 1080px;
|
||
display: block;
|
||
}
|
||
#pt-caption {
|
||
position: absolute;
|
||
left: 96px;
|
||
bottom: 96px;
|
||
font:
|
||
500 30px/1 "PT Caption",
|
||
system-ui,
|
||
sans-serif;
|
||
letter-spacing: 0.01em;
|
||
color: rgba(20, 22, 24, 0.62);
|
||
}
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div
|
||
id="pt-root"
|
||
data-composition-id="product-turntable"
|
||
data-start="0"
|
||
data-duration="6"
|
||
data-width="1920"
|
||
data-height="1080"
|
||
>
|
||
<canvas
|
||
id="pt-canvas"
|
||
class="clip"
|
||
data-start="0"
|
||
data-duration="6"
|
||
data-track-index="1"
|
||
></canvas>
|
||
<div id="pt-caption"></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("pt-root");
|
||
var duration = Math.max(0.001, parseFloat(root.dataset.duration) || 6);
|
||
root.style.setProperty("--pt-bg", vars.background || "#e8e4dc");
|
||
document.getElementById("pt-caption").textContent = vars.caption || "";
|
||
|
||
var clock = { t: 0 };
|
||
var scene = { vars: vars, duration: duration, clock: clock, render: null };
|
||
window.__productTurntable = scene;
|
||
window.__hf = window.__hf || {};
|
||
window.__hf.buildReady = window.__hf.buildReady || {};
|
||
window.__hf.buildReady["product-turntable"] = 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);
|
||
},
|
||
});
|
||
window.__timelines = window.__timelines || {};
|
||
window.__timelines["product-turntable"] = tl;
|
||
})();
|
||
</script>
|
||
|
||
<script type="module">
|
||
import * as THREE from "https://cdn.jsdelivr.net/npm/three@0.184.0/+esm";
|
||
import { RoomEnvironment } from "https://cdn.jsdelivr.net/npm/three@0.184.0/examples/jsm/environments/RoomEnvironment.js/+esm";
|
||
import { GLTFLoader } from "https://cdn.jsdelivr.net/npm/three@0.184.0/examples/jsm/loaders/GLTFLoader.js/+esm";
|
||
|
||
const host = window.__productTurntable;
|
||
const V = host.vars;
|
||
const hex = (v, fallback) => (/^#[0-9a-f]{6}$/i.test(String(v)) ? String(v) : fallback);
|
||
const turns = Math.max(1, Math.min(4, Math.round(Number(V.turns) || 1)));
|
||
|
||
const renderer = new THREE.WebGLRenderer({
|
||
canvas: document.getElementById("pt-canvas"),
|
||
antialias: true,
|
||
alpha: true,
|
||
preserveDrawingBuffer: true,
|
||
});
|
||
renderer.setPixelRatio(1);
|
||
renderer.setSize(1920, 1080, false);
|
||
renderer.outputColorSpace = THREE.SRGBColorSpace;
|
||
renderer.toneMapping = THREE.ACESFilmicToneMapping;
|
||
renderer.toneMappingExposure = 1.3;
|
||
|
||
const scene = new THREE.Scene();
|
||
const pmrem = new THREE.PMREMGenerator(renderer);
|
||
// Studio: two tall softbox strips (key 35 deg left, rim 120 deg right at 1.6x) over a dimmed room fill.
|
||
const studio = new THREE.Scene();
|
||
const room = new RoomEnvironment();
|
||
room.traverse((o) => {
|
||
if (o.isLight) o.intensity *= 0.3;
|
||
if (o.material && o.material.emissiveIntensity) o.material.emissiveIntensity *= 0.3;
|
||
});
|
||
studio.add(room);
|
||
for (const [deg, intensity] of [
|
||
[-35, 5],
|
||
[120, 8],
|
||
]) {
|
||
const strip = new THREE.Mesh(
|
||
new THREE.PlaneGeometry(1.2, 8),
|
||
new THREE.MeshLambertMaterial({
|
||
color: 0x000000,
|
||
emissive: 0xffffff,
|
||
emissiveIntensity: intensity,
|
||
side: THREE.DoubleSide,
|
||
}),
|
||
);
|
||
const a = THREE.MathUtils.degToRad(deg);
|
||
strip.position.set(6 * Math.sin(a), 1, 6 * Math.cos(a));
|
||
strip.lookAt(0, 1, 0);
|
||
studio.add(strip);
|
||
}
|
||
scene.environment = pmrem.fromScene(studio, 0.02).texture;
|
||
|
||
// Can and plinth vertically centred, about 140 px clear above and below.
|
||
const camera = new THREE.PerspectiveCamera(24, 1920 / 1080, 0.1, 100);
|
||
camera.position.set(0, 2.1, 9.4);
|
||
camera.lookAt(0, 0.9, 0);
|
||
|
||
const key = new THREE.DirectionalLight(0xffffff, 1.6);
|
||
key.position.set(-3.5, 5, 4);
|
||
scene.add(key);
|
||
const rim = new THREE.DirectionalLight(0xfff1dc, 2.2);
|
||
rim.position.set(4, 3, -4);
|
||
scene.add(rim);
|
||
|
||
// Plinth with a soft baked contact shadow: no shadow maps, no per-frame cost.
|
||
const plinth = new THREE.Mesh(
|
||
new THREE.CylinderGeometry(1.42, 1.46, 0.2, 96),
|
||
new THREE.MeshStandardMaterial({ color: 0xf4f1ec, roughness: 0.55, metalness: 0 }),
|
||
);
|
||
plinth.position.y = -0.1;
|
||
scene.add(plinth);
|
||
|
||
function radialTexture(inner, outer) {
|
||
const c = document.createElement("canvas");
|
||
c.width = c.height = 256;
|
||
const g = c.getContext("2d");
|
||
const grad = g.createRadialGradient(128, 128, 0, 128, 128, 128);
|
||
grad.addColorStop(0, inner);
|
||
grad.addColorStop(1, outer);
|
||
g.fillStyle = grad;
|
||
g.fillRect(0, 0, 256, 256);
|
||
const tex = new THREE.CanvasTexture(c);
|
||
tex.colorSpace = THREE.SRGBColorSpace;
|
||
return tex;
|
||
}
|
||
const shadow = new THREE.Mesh(
|
||
new THREE.PlaneGeometry(2.4, 2.4),
|
||
new THREE.MeshBasicMaterial({
|
||
map: radialTexture("rgba(0,0,0,0.55)", "rgba(0,0,0,0)"),
|
||
transparent: true,
|
||
depthWrite: false,
|
||
}),
|
||
);
|
||
shadow.rotation.x = -Math.PI / 2;
|
||
shadow.position.y = 0.002;
|
||
scene.add(shadow);
|
||
|
||
const turntable = new THREE.Group();
|
||
scene.add(turntable);
|
||
|
||
async function labelTexture() {
|
||
try {
|
||
const face = new FontFace(
|
||
"PT Inter",
|
||
"url(https://cdn.jsdelivr.net/fontsource/fonts/inter@latest/latin-800-normal.woff2)",
|
||
{ weight: "800" },
|
||
);
|
||
document.fonts.add(await face.load());
|
||
} catch (error) {
|
||
console.error("[product-turntable] label font failed to load, using system sans", error);
|
||
}
|
||
const c = document.createElement("canvas");
|
||
// 2.35:1 matches the label's circumference to height, so type is not stretched.
|
||
c.width = 2048;
|
||
c.height = 872;
|
||
const g = c.getContext("2d");
|
||
const label = hex(V.label_color, "#f2c230");
|
||
const ink = hex(V.ink_color, "#1d2a24");
|
||
g.fillStyle = label;
|
||
g.fillRect(0, 0, 2048, 872);
|
||
g.fillStyle = ink;
|
||
g.fillRect(0, 70, 2048, 12);
|
||
g.fillRect(0, 790, 2048, 12);
|
||
const name = String(V.product_name || "YUZU").toUpperCase();
|
||
const flavor = String(V.flavor || "").toUpperCase();
|
||
// Two faces, front and back, so the wordmark reads twice per revolution.
|
||
for (const cx of [512, 1536]) {
|
||
g.save();
|
||
g.textAlign = "center";
|
||
g.textBaseline = "middle";
|
||
let size = 280;
|
||
g.font = `800 ${size}px "PT Inter", system-ui, sans-serif`;
|
||
while (g.measureText(name).width > 600 && size > 80) {
|
||
size -= 10;
|
||
g.font = `800 ${size}px "PT Inter", system-ui, sans-serif`;
|
||
}
|
||
g.fillText(name, cx, 400);
|
||
g.font = `800 50px "PT Inter", system-ui, sans-serif`;
|
||
g.globalAlpha = 0.8;
|
||
g.fillText(flavor, cx, 590, 540);
|
||
g.restore();
|
||
}
|
||
g.save();
|
||
g.textAlign = "center";
|
||
g.font = `800 34px "PT Inter", system-ui, sans-serif`;
|
||
g.globalAlpha = 0.7;
|
||
for (const cx of [0, 1024, 2048]) g.fillText("355 ML", cx, 450);
|
||
g.restore();
|
||
const tex = new THREE.CanvasTexture(c);
|
||
tex.colorSpace = THREE.SRGBColorSpace;
|
||
tex.anisotropy = renderer.capabilities.getMaxAnisotropy();
|
||
return tex;
|
||
}
|
||
|
||
async function builtInCan() {
|
||
const can = new THREE.Group();
|
||
const metal = new THREE.MeshStandardMaterial({
|
||
color: 0xd4d7dc,
|
||
metalness: 1,
|
||
roughness: 0.24,
|
||
});
|
||
// Lathe profile (radius, height): domed base, straight wall, necked shoulder, rolled lip.
|
||
const profile = [
|
||
[0.0, 0.1],
|
||
[0.46, 0.06],
|
||
[0.6, 0.0],
|
||
[0.66, 0.06],
|
||
[0.67, 0.16],
|
||
[0.67, 2.02],
|
||
[0.63, 2.14],
|
||
[0.56, 2.24],
|
||
[0.555, 2.29],
|
||
[0.575, 2.31],
|
||
[0.56, 2.33],
|
||
[0.5, 2.3],
|
||
[0.0, 2.27],
|
||
].map(([x, y]) => new THREE.Vector2(x, y));
|
||
can.add(new THREE.Mesh(new THREE.LatheGeometry(profile, 128), metal));
|
||
const labelMat = new THREE.MeshPhysicalMaterial({
|
||
map: await labelTexture(),
|
||
metalness: 0.45,
|
||
roughness: 0.32,
|
||
clearcoat: 1,
|
||
clearcoatRoughness: 0.12,
|
||
});
|
||
const label = new THREE.Mesh(
|
||
new THREE.CylinderGeometry(0.674, 0.674, 1.8, 128, 1, true),
|
||
labelMat,
|
||
);
|
||
label.position.y = 1.1;
|
||
can.add(label);
|
||
// Pull tab: a thin rounded plate on the lid.
|
||
const tab = new THREE.Mesh(new THREE.CapsuleGeometry(0.07, 0.22, 4, 12), metal);
|
||
tab.rotation.set(Math.PI / 2, 0, Math.PI / 2);
|
||
tab.scale.set(1, 1, 0.25);
|
||
tab.position.set(0.1, 2.285, 0);
|
||
can.add(tab);
|
||
return can;
|
||
}
|
||
|
||
function fitModel(object) {
|
||
const box = new THREE.Box3().setFromObject(object);
|
||
const size = box.getSize(new THREE.Vector3());
|
||
const center = box.getCenter(new THREE.Vector3());
|
||
const scale = Math.min(2.3 / size.y, 2.6 / Math.max(size.x, size.z));
|
||
object.scale.setScalar(scale);
|
||
object.position.set(-center.x * scale, -box.min.y * scale, -center.z * scale);
|
||
const wrapper = new THREE.Group();
|
||
wrapper.add(object);
|
||
return wrapper;
|
||
}
|
||
|
||
// A model_url that fails to load fails the render; it never swaps in a different product.
|
||
async function product() {
|
||
const url = String(V.model_url || "").trim();
|
||
if (!url) return builtInCan();
|
||
const gltf = await new GLTFLoader().loadAsync(url);
|
||
return fitModel(gltf.scene);
|
||
}
|
||
|
||
turntable.add(await product());
|
||
|
||
host.render = (t) => {
|
||
turntable.rotation.y = (t / host.duration) * turns * Math.PI * 2;
|
||
renderer.render(scene, camera);
|
||
};
|
||
host.render(host.clock.t);
|
||
host.ready();
|
||
</script>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
</CatalogSlot>
|
||
|
||
<CatalogSlot slot="install">
|
||
|
||
<InstallCommand command="npx hyperframes add product-turntable" item="product-turntable" />
|
||
|
||
That writes one file: `compositions/product-turntable.html`.
|
||
|
||
</CatalogSlot>
|
||
|
||
</CatalogDetail>
|
||
|
||
<div data-static-slot="docs" className="prose prose-gray dark:prose-invert">
|
||
|
||
## Add it to your video
|
||
|
||
It runs for 6 seconds at 1920×1080. Paste this into your composition:
|
||
|
||
```html index.html
|
||
<div
|
||
data-composition-id="product-turntable"
|
||
data-composition-src="compositions/product-turntable.html"
|
||
data-start="0"
|
||
data-duration="6"
|
||
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` `product` `turntable` `glb` `loop`.
|
||
|
||
## 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>
|