HybridRendererModule04 / 7

Three + Pixi: мир и интерфейс

Расположим Pixi-интерфейс поверх 3D-мира.

Если игровой мир трёхмерный, а кнопки и счётчики удобнее сделать в PixiJS, выберем HybridRendererModule из @gamedevland/engine/renderers/hybrid. Установим three, pixi.js и @types/three.

В GameConfig зададим system.renderer: new HybridRendererModule(). В одном layout опишем два отдельных корня:

{
  "world": {
    "type": "Group",
    "children": {
      "camera": {
        "type": "PerspectiveCamera",
        "props": {
          "position": { "x": 0, "y": 2, "z": 5 },
          "lookAt": { "x": 0, "y": 0, "z": 0 },
          "near": 0.1, "far": 100, "fov": 50
        }
      }
    }
  },
  "ui": {
    "type": "Container",
    "children": { "score": { "type": "Text", "props": { "text": "0" } } }
  }
}

В SceneConfig.render укажем { camera: 'world.camera' }. Игровые объекты добавим в world, интерфейс — в ui.

Верхний canvas · PixiПрозрачный интерфейс, проверяется первым
Нижний canvas · Three3D-мир, получает ввод без попадания в UI
Один цикл обновления обслуживает оба canvas.

SDK объединяет их в одном логическом layout, но сохраняет раздельные деревья отрисовки. Group принимает Three-детей, Container — Pixi-детей. Нельзя поместить Pixi-текст внутрь Three-группы. Камера двигает мир, а координаты интерфейса остаются двумерными.