Pixi + Three-as-texture: 3D в спрайте
Нарисуем 3D-объект внутри Pixi-экрана.
Для 3D-предмета в меню или поля внутри Pixi-игры выберем PixiThreeTextureRendererModule из @gamedevland/engine/renderers/hybrid: system.renderer: new PixiThreeTextureRendererModule(). Нужны pixi.js, three и @types/three.
В JSON layout добавим ThreeViewport. SDK создаст отдельный Three canvas и назначит его изображение текстурой Pixi-спрайта:
{
"itemPreview": {
"type": "ThreeViewport",
"props": {
"width": 400,
"height": 400,
"resolution": 1.5,
"sceneLayout": "json/layouts/previews/item.json",
"camera": "world.camera"
}
}
}
sceneLayout — id JSON-ассета с Three-нодами: группами, моделями, камерой и светом. camera указывает на камеру внутри этого файла. Посмотрим пример Three-layout. У каждого viewport свой граф и свои id; children у самого ThreeViewport не задаём.
В onReady компонента получим ноды через viewport.world.requireNode(id, ThreeNode). По умолчанию изображение обновляется по запросу: после изменения 3D-объектов вызовем viewport.invalidate(). Для постоянной анимации зададим renderMode: "always" в props.
viewport.resize(width, height, resolution) меняет размер текстуры и проекцию камеры. Допустимая resolution — от 0,25 до 2. При уничтожении ноды SDK освобождает вложенный layout, экземпляры GLB, renderer и текстуру. Ресурсы, созданные игровым компонентом, освобождает сам компонент.
Ввод остаётся на Pixi-спрайте: Three-raycast внутри изображения автоматически не выполняется. Передача изображения требует копирования пикселей. Для собственного рендера через код остаётся ThreeTextureSurface.