PixiThreeTextureRendererModule05 / 7

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 не задаём.

Three-layoutМодели, камера и свет
ТекстураКопия изображения Three-сцены
ThreeViewportПоложение, масштаб, прозрачность и ввод Pixi

В 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.