Planara Three

Набор расширений и вспомогательных классов для работы с Three.js в проектах Planara.

Пакет содержит дополнительные элементы, которые используются ядром редактора: расширенные контролы, вспомогательные объекты сцены, гизмо осей и другие утилиты поверх Three.js.

Установка

Пакет ожидает, что three и @types/three уже установлены в проекте как peer dependencies.

npm install @planara/three three @types/three

или

yarn add @planara/three three @types/three

Если three уже установлен в проекте, достаточно установить только пакет расширений:

npm install @planara/three

Возможности

Пакет предоставляет:

• расширенные контролы камеры и трансформации объектов;

• вспомогательные объекты для отображения осей и элементов сцены;

• гизмо осей камеры;

• утилиты, используемые внутри 3D-редактора Planara;

• готовые примитивы для интеграции с @planara/core.

Использование

Пример подключения гизмо осей камеры:

import { CameraAxesGizmo } from '@planara/three';

const gizmo = new CameraAxesGizmo(renderer, camera, {
  size: 80,
  margin: 16,
  animationDuration: 300,
});

gizmo.render(width, height);

Гизмо можно временно скрывать:

gizmo.setVisible(false);

и снова отображать:

gizmo.setVisible(true);

Расширенные контролы

Пакет также предоставляет расширения стандартных контролов Three.js, используемые в редакторе.

import { OrbitWithState, ModelingTransformControls } from '@planara/three';

OrbitWithState используется для управления камерой и отслеживания состояния взаимодействия пользователя.

ModelingTransformControls используется для трансформации объектов сцены и интеграции с инструментами редактирования.