PixiJS добавил 3D в 2D-сцену и открыл бету под MIT
Команда PixiJS открыла публичную бету PixiJS 3D, официального трёхмерного расширения своего 2D-движка для браузера. 3D-сцена здесь подключается как обычный элемент 2D-сцены: её добавляют на тот же холст, что спрайты, текст и интерфейс, и она рисуется с ними в общем порядке слоёв. Для студий, которые делают на PixiJS браузерные игры, промо и интерактивные интерфейсы, это значит, что 3D-модель можно вставить в уже готовый проект. Переписывать его или запускать рядом второй движок не нужно.
Расширение бесплатное и распространяется под лицензией MIT. Разработчики проектировали его в первую очередь под WebGPU, тот же код сцены работает и на WebGL2. API пока не зафиксирован, версию 1.0 обещают выпустить после того, как разберут отзывы участников открытой беты.
«Это бесплатно. Лицензия MIT, и так будет всегда».
— команда PixiJS в анонсе открытой беты
3D-вид на сцене кладут как спрайт
Вся трёхмерная сцена живёт внутри отдельного 3D-вида, а сам он на 2D-сцене ведёт себя как спрайт. Таких видов можно поставить несколько и в любых местах композиции, у каждого своя сцена и камера, это показывает пример с несколькими видами. Порядок наложения простой: 2D-элементы, которые идут в списке позже, рисуются поверх 3D, а более ранние видны сквозь него, если у вида не задан фон. В песочнице есть сцена, где стеклянный 3D-логотип преломляет 2D-постер, нарисованный за ним.
2D и 3D всё же остаются раздельными мирами. Спрайт нельзя положить внутрь 3D-дерева, а 3D-узел нельзя поставить прямо на 2D-сцену. Чтобы показать 2D-интерфейс на поверхности 3D-объекта, его рендерят в текстуру, которая может обновляться каждый кадр. В примере на сайте так на гранях куба отображается живой 2D-контейнер, а в анонсе 2D-сцена с часами идёт на экране 3D-монитора. Для подписей, которые следуют за 3D-объектом, есть пересчёт координат из пространства сцены в экранные. По умолчанию 3D-вид перехватывает клики и наведение во всей своей прямоугольной области, поэтому 2D-кнопки под ним не нажимаются, пока это поведение не настроить. Указатель реагирует и на сами 3D-объекты.
Что умеет движок
- Модели. Загружается glTF 2.0 в виде .gltf или .glb, со сжатием геометрии Draco и meshopt, сжатыми текстурами, скиннингом, morph targets и анимацией. Анимационные клипы запускаются по имени, как у модели лисы из демо на сайте.
- Материалы. Доступны PBR, Phong, flat и toon, можно писать собственные материалы, в том числе многопроходные.
- Свет и картинка. Есть тени, включая каскадные, HDR, тональная компрессия, граф рендеринга и постобработка, в том числе bloom и ambient occlusion.
- Прочее. В комплекте частицы и камера с облётом вокруг объекта.
Копии одного пропа почти ничего не стоят. Каждая модель строит свои узлы, но использует общие геометрию, материалы и текстуры, так же как спрайты используют одну текстуру. Если расставить по уровню несколько ящиков из одного файла, файл загрузится один раз. Для тысяч копий предусмотрен отдельный пакетный режим.
Скорость без ручной оптимизации
Главное обещание релиза: сцена, собранная самым очевидным способом, уже должна работать быстро. Разработчики сравнили разные способы рендеринга, и движок сам выбирает подходящий под устройство, браузер и конкретную сцену. Объекты с общими геометрией и материалом автоматически объединяются в один инстансированный вызов отрисовки. Пять кубов с общей геометрией и материалом рисуются за один вызов, двенадцать анимированных персонажей из одного файла модели тоже за один.
Отсечение невидимых объектов в большинстве браузеров с WebGPU выполняется на видеокарте в вычислительном шейдере. В Safari и на любых iPhone и iPad для типичной сцены его считает процессор, а на видеокарту оно переходит, когда пакет объектов становится достаточно большим. Движок пересчитывает только изменившиеся меши, поэтому статичная сцена почти не нагружает процессор. Вероятно, это особенно полезно для интерфейсов, где 3D-объект большую часть времени неподвижен. Каждый браузер скачивает только нужный ему бэкенд, WebGPU или WebGL2.
В пакетной демонстрации на экране 100 000 объектов с тенями при 60 кадрах в секунду. На каком железе получены эти цифры, в анонсе не указано. Чтобы показать работу движка вне бенчмарков, команда опубликовала две игры на своей витрине экспериментов Good Stuff. Nightward генерирует всю графику и музыку кодом и не загружает ни одного файла изображений или звука. Mach 2 работает на WebGPU и WebGL2, в неё можно играть с клавиатуры или на телефоне. Новые 3D-эксперименты команда обещает выкладывать туда же.
Что придётся учесть при сборке сцены
У 3D-части своя система координат, и к ней придётся привыкать тем, кто работает в 2D-пикселях. Ось Y смотрит вверх, а за единицу принят метр. Камера по умолчанию ничего не рисует дальше 1000 единиц, поэтому сцена, собранная в пиксельных размерах, обрежется. Модели может потребоваться масштабировать: в демо с лисой модель уменьшена до 0,01 исходного размера.
Второй нюанс касается совместимости. Если браузер выбрал WebGPU, но видеокарте не хватает нужной функции, приложение не переключится на WebGL2 автоматически и выдаст ошибку при запуске. В документации описано, как проверить поддержку заранее. Для телефонов руководство советует ограничить плотность пикселей значением 2: на экране с тройной плотностью это сокращает число отрисовываемых пикселей больше чем вдвое.
Закрытая бета уже выявила характерные проблемы. Экспорт из Blender ронял загрузчик glTF, а на некоторых Android-телефонах шейдеры запрашивали больше параметров, чем допускает WebGL2. Всего тестировщики прислали более 30 отчётов об ошибках и запросов функций, большая часть из них вошла в релиз.
Где взять и как начать
Пакет @pixi/3d ставится вместе с pixi.js через npm или из CDN и требует pixi.js версии 8.23.0 или новее. Исходники лежат в репозитории PixiJS 3D на GitHub, документация и примеры собраны на странице PixiJS 3D. Там 35 руководств, более 100 интерактивных примеров и три туториала, которые работают прямо в браузерном редакторе. Вводный урок по шагам собирает вращающийся куб на полу, ставит камеру и направленный свет, а затем загружает glTF-модель.
Вместе с расширением вышел навык для ИИ-агентов, его можно подключить в Claude Code, Cursor, Codex и Copilot, и он входит в npm-пакет. Документация опубликована в формате llms.txt, удобном для языковых моделей. Сами разработчики называют PixiJS 3D крупнейшим дополнением к PixiJS со времён восьмой версии движка.
Кому это пригодится и где риски
У PixiJS давно было стороннее 3D-расширение Pixi3D от независимого разработчика. Оно поддерживает PBR и освещение по картам окружения, его автор сообщает о работе в продакшене на сотнях тысяч устройств, но совместимо оно с PixiJS версий 5, 6 и 7. Официальный пакет рассчитан на восьмую ветку, начиная с 8.23.0. Студиям со старыми проектами на Pixi3D, вероятно, сначала придётся перевести их на актуальный PixiJS, и только потом пересаживаться на новое расширение. Готового пути миграции в материалах не описано.
Больше всего, по всей видимости, выигрывают команды, у которых основа проекта двумерная: казуальные браузерные игры, playable-реклама, интерактивные лендинги и интерфейсы с отдельными 3D-элементами. Им больше не нужно держать в проекте второй рендерер и синхронизировать его с 2D-слоем. Для проектов, где нужна полноценная 3D-сцена с минимумом 2D, преимущества менее очевидны: сравнения с крупными веб-3D-движками разработчики не приводят.
Главный риск следует из самого статуса: API ещё может измениться до 1.0, и код, написанный сейчас, возможно, придётся править. Отдельно имеет смысл проверить экспорт моделей из Blender и поведение на Android-устройствах: именно там закрытая бета находила сбои, в том числе упиралась в лимиты WebGL2 на некоторых телефонах.
Где вы бы встроили 3D-вид из PixiJS 3D?
- Казуальная браузерная игра
- Playable-реклама