Motiva
Мои коллекции
← каталог

Halftone Scene

Живая 3D-сцена выведена полиграфическим растром: точками переменного размера, штриховкой или ASCII-глифами. Растрируется не картинка, а кадр сцены — свет ходит за курсором, форма дышит, и узор пересчитывается каждый кадр вместе с ними. Поэтому точка здесь означает свет на форме, а не яркость пикселя готового снимка. Яркость берётся в центре клетки повёрнутого растра, как в типографском экране; площадь точки пропорциональна темноте. Переключаются способ растра, предмет, шаг и угол экрана, краска и бумага.

threemouse-moveautoadvanced~162 КБreduced-motion ✓
↗
🎛 Настройки — крути и копируй

Установка

npx shadcn@latest add https://motiva.pages.dev/r/halftone-scene.json

зависимости: three@^0.185.1 · @types/three@^0.185.0

Что нужно в проекте до установки
  1. Файл components.json в корне

    Из него CLI узнаёт, куда класть файлы. Алиасы — в такой форме:

    "aliases": { "components": "@/components", "lib": "@/lib" }

    Нет файла — установка не начнётся вовсе.

  2. Алиас @ объявлен дважды

    В корневом tsconfig.json и в конфиге сборщика. В Vite корневой tsconfig часто содержит только references — этого мало.

    "paths": { "@/*": ["./src/*"] }        // tsconfig.json
    resolve.alias = { "@": "/src" }        // vite.config.ts

    Без paths CLI молча создаёт папку с именем @.

  3. Токены подключены один раз на приложение

    Они приезжают вместе с записью — достаточно импортировать их в точке входа:

    import "@/styles/motiva-tokens.css";

    Без них блок потеряет цвета, ритм и тему.

  4. Своя типографика не спорит с блоком

    Наследуемые свойства протекают внутрь: text-align: center на обёртке отцентрует содержимое секции. То же касается font-familyи line-height.

  5. Проект без TypeScript? всё равно нужен tsconfig

    CLI грузит tsconfig.json безусловно, а при "tsx": false идёт за jsconfig.json и падает так же. Минимум — файл с pathsи "tsx": true в components.json.

    Приехавший рядом .tsx можно не трогать — вам нужен .vanilla.js.

Экспорт

↓ Скачать .zip

Код

"use client";

import { useEffect, useRef } from "react";
import { createHalftoneScene, type HalftoneScene as Engine, type HalftoneSceneOptions } from "@/lib/halftone-scene-engine";

export type HalftoneSceneProps = Omit<HalftoneSceneOptions, "animate"> & {
  /** Подложка под холст: CSS `background` или `false`, если её задаёт секция. */
  backdrop?: string | false;
};

/** Подложка = бумага выбранной палитры: холст растрирует кадр целиком, кромка не должна спорить. */
const PAPERS: Record<"print" | "neon" | "ash", string> = {
  print: "oklch(0.89 0.02 85)",
  neon: "oklch(0.16 0.02 250)",
  ash: "oklch(0.17 0.005 270)",
};

/**
 * Halftone Scene — живая 3D-сцена, выведенная полиграфическим растром: точки,
 * штриховка или ASCII. Свет ходит за курсором, форма дышит, узор пересчитывается
 * вместе с ними.
 *
 * Сцена — `createHalftoneScene` из соседнего файла; компонент держит холст, прокидывает
 * крутилки через `set()` и разбирает всё при размонтировании.
 * `prefers-reduced-motion` и `data-shot` рисуют один стоячий кадр.
 */
export function HalftoneScene({ backdrop, ...options }: HalftoneSceneProps = {}) {
  const canvasRef = useRef<HTMLCanvasElement>(null);
  const engine = useRef<Engine | null>(null);
  const first = useRef(options);

  useEffect(() => {
    const canvas = canvasRef.current;
    if (!canvas) return;
    const animate = !(
      document.documentElement.hasAttribute("data-shot") ||
      window.matchMedia("(prefers-reduced-motion: reduce)").matches
    );
    engine.current = createHalftoneScene(canvas, { ...first.current, animate });
    return () => {
      engine.current?.destroy();
      engine.current = null;
    };
  }, []);

  const { mode, shape, cell, angle, contrast, palette, speed, light } = options;
  useEffect(() => {
    engine.current?.set({ mode, shape, cell, angle, contrast, palette, speed, light });
  }, [mode, shape, cell, angle, contrast, palette, speed, light]);

  const ground = backdrop === undefined ? PAPERS[options.palette ?? "print"] : backdrop;

  return (
    <div
      style={{
        position: "absolute",
        inset: 0,
        overflow: "hidden",
        ...(ground === false ? null : { background: ground }),
      }}
    >
      <canvas ref={canvasRef} aria-hidden="true" style={{ display: "block", width: "100%", height: "100%" }} />
    </div>
  );
}
лицензия: MITавтор: Motivaисточник: оригинал (Motiva); пункт 8 очереди моушн-волн 13.09.2026 — вторая версия приёма «растр» рядом с `ascii-image`: там фото на канвасе, здесь живая 3D-сценаv1.0.0