code-slice-hero

تیترهای جسورانه را با موجی از کاشی‌های سه‌بعدی، سلول‌به‌سلول آشکار کنید.

این بلاک HyperFrames یک سطح شبکه‌ای از کاشی‌های مربعی می‌سازد که با عبور یک میدان عمق، به‌صورت مرحله‌ای می‌چرخند و تیتر پشتی را نمایان می‌کنند. افکت با WebGL 2، GSAP و سایه‌های پردازش‌شده ساخته شده و برای ویدیوی 1920×1080 با مدت ۸ ثانیه آماده است.

می‌توانید متن‌های جلو و پشت، جهت حرکت، اندازه سلول‌ها، عمق، شیب، easing، bounce و شدت سایه را بدون کش‌آمدن کاشی‌ها تنظیم کنید. ساختار timeline قابل seek است و برای render پایدار در HyperFrames طراحی شده است.

چه چیزی می‌گیرید

  • کامپوزیشن آماده `code-slice-hero` برای HyperFrames
  • تیتر جلو و تیتر پشت با حداکثر ۳۲ کاراکتر
  • کنترل جهت sweep، سرعت flip، شعاع cursor و عمق میدان
  • تنظیم مستقل اندازه کاشی، اندازه فونت، bounce و سایه
  • فایل‌های محلی GSAP، فونت Geist-Bold و اسکریپت‌های WebGL موردنیاز

برای چه کاری خوب است

  • برای تیزرهای برند، معرفی محصول و ویدیوهای kinetic typography
  • برای کاور یا hero ویدیوهایی که باید یک پیام دوم را به‌صورت غافلگیرکننده آشکار کنند
  • برای پروژه‌هایی که به خروجی 1920×1080 با timeline قابل seek و render تکرارپذیر نیاز دارند

برای چه کاری نیست

  • وقتی به متن‌های طولانی، پاراگراف یا چیدمان چندخطی پیچیده نیاز دارید
  • برای صحنه‌هایی که به تعامل زنده کاربر یا انیمیشن مبتنی بر `requestAnimationFrame` نیاز دارند
  • اگر پروژه شما به‌جای HyperFrames به یک کامپوننت مستقل React یا CSS نیاز دارد

دربارهٔ این اسکیل

Code Slice Hero

A full square-tile surface carries one seamless headline. An imaginary cursor crosses the surface; nearby tiles respond to its Gaussian depth field with lift and tilt, and only the cells intersecting either headline silhouette turn over to reveal the rear headline. The whole grid is one instanced WebGL 2 draw with a shared front/rear texture pair, plus a batched projected-shadow pass. Copy, text size and square cell size are independent, so tiles never stretch. Sweep direction, easing strength, cursor radius, falloff, depth, bounce and shadow are all variables.

Composition id: code-slice-hero. Duration 8 s at 30 fps, 1920×1080.

Files

  • code-slice-hero.html (24 KB)
  • assets/Geist-Bold.ttf (65 KB)
  • assets/Geist-OFL.txt (4 KB)
  • assets/gsap-3.14.2.min.js (128 KB)
  • assets/GSAP-NOTICE.txt (1 KB)
  • shadows.js (10 KB)
  • surface.js (8 KB)

Install

Install with npx hyperframes add code-slice-hero; by default the files above land under compositions/code-slice-hero/. Then mount the block from the host index.html:

<div
  data-composition-id="code-slice-hero"
  data-composition-src="compositions/code-slice-hero/code-slice-hero.html"
  data-start="0"
  data-duration="8"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Render with custom values by targeting the composition file directly:

npx --yes hyperframes@0.8.12 render 'compositions/code-slice-hero/code-slice-hero.html' --variables '{"headline":"MAKE IT","reverseHeadline":"MATTER."}'

Variables

Read at runtime via window.__hyperframes.getVariables(); declared on the composition root as data-composition-variables (single-quoted attribute, plain JSON).

idtypedefaultlabel / range
headlinestring"MAKE IT"Copy · Front headline max 32 chars
reverseHeadlinestring"MATTER."Copy · Rear headline max 32 chars
directionenum"left-to-right"Motion · Sweep direction (left-to-right
sweepDurationnumber4.2Motion · Sweep duration 2.6–4.5 step 0.05
sweepEaseStrengthnumber3Motion · Sweep easing strength 0–3 step 0.05
flipDurationnumber0.75Motion · Each tile flip 0.65–1.65 step 0.05
cursorRadiusnumber210Cursor · Influence radius 160–480 step 10
cursorFalloffnumber1.4Cursor · Influence falloff 0.4–3.5 step 0.05
cursorDepthnumber80Cursor · Depth (+ toward camera) -320–320 step 10
tiltStrengthnumber55Cursor · Pull / tilt strength 0–55 step 1
noiseStrengthnumber2Motion · Organic variation 0–2 step 0.05
flipBouncenumber0.15Motion · Elastic flip bounce 0–0.8 step 0.05
cellSizenumber112Slices · Square cell size 24–120 step 4
formationScalenumber1Slices · Local formation scale 0.94–1 step 0.001
fontSizenumber310Type · Maximum size 160–480 step 5
behindColorcolor"#212121"Surface · Behind-tile background
shadowStrengthnumber0.19Surface · Cast shadow strength 0–0.65 step 0.01
shadowSoftnessnumber4Surface · Cast shadow softness 0.5–4 step 0.1

Runtime contract

  • One paused GSAP timeline registered as window.__timelines["code-slice-hero"].
  • Re-syncs on the hf-seek CustomEvent; every frame is a closed-form function of time (seeded PRNG only, no rAF loops, no Date.now).
  • Renderer: GSAP, Canvas 2D, Seeded PRNG.
  • External runtime dependencies: none (served locally).
  • Local fonts: assets/Geist-Bold.ttf.

Editing rules (from the source project)

  1. Keep data-composition-variables a single-quoted attribute with plain " JSON. Never save it through Studio's Design panel.
  2. Do not put <canvas> in static markup; create it at runtime.
  3. Keep every visual state a function of t; seek-safety is what makes the block renderable.

دانلود ZIP