API Docs for: 1.0.0
Show:

Site3dThree Class

Defined in: base\site3d_dev.js:1
Module: Site3d

Класс операций над объектами three.js

Constructor

Site3dThree

(
  • scene
)

Parameters:

  • scene Scene

    Объект сцены

Methods

getCameraFrustum

() Frustum

Метод возвращает область видимости камеры

Returns:

Frustum:

Результат

getCameraTarget

(
  • distance
)
Vector3

Метод возвращает точку, удаленную на определенное расстояние от камеры

Parameters:

  • distance Number

    Дистанция

Returns:

Vector3:

Результат

getVectorProjectionOnSegment

(
  • vector
  • segment
)
Vector3

Метод возвращает проекцию точки на прямую, образованную отрезком

Parameters:

  • vector Vector3

    Проецируемая точка

  • segment Vector3

    Отрезок

Returns:

Vector3:

Спроецированная точка

getObject3dParents

(
  • object3d
)
Object3D

Метод возвращает массив родительских объектов для данного объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Object3D:

Массив объектов three.js

getObject3dLastParent

(
  • object3d
)
Object3D

Метод возвращает последний родительский объект для данного объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Object3D:

Объект three.js

getObject3dBox

(
  • object3d
)
Box3

Метод возвращает Box3 объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Box3:

Результат

getObject3dSize

(
  • object3d
)
Number[]

Метод возвращает размеры объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Number[]:

Массив размеров по трем осям

getObject3dRelativeVector

(
  • object3d
  • vector
)
Vector3

Метод возвращает вектор, смещенный относительно центра объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • vector Vector3

    Смещение

Returns:

Vector3:

Результат

isVectorInCamera

(
  • vector3
)
Boolean

Метод возвращает истину, если вектор находится в пределах видимости камеры

Parameters:

  • vector3 Vector3

    Вектор three.js

Returns:

Boolean:

Результат

getVectorScreenInfo

(
  • vector
  • options
)
Object

Метод возвращает объект с информацией о проекции вектора на камеру

Parameters:

  • vector Vector3

    Вектор three.js

  • options Object

    Дополнительные параметры

Returns:

Object:

Результат

getBoxVectors

(
  • box3
)
Vector3

Метод возвращает массив векторов бокса

Parameters:

  • box3 Box3

    Бокс three.js

Returns:

Vector3:

Результат

getBoxMinDistance

(
  • vectors
  • vectorFrom
)
Object

Метод возвращает минимальное расстояние от точки до Box3

Parameters:

  • vectors Vector3

    Массив векторов бокса

  • vectorFrom Vector3

    Объект Vector3

Returns:

Object:

Результат {vector, distance}

isBoxInCamera

(
  • box
)
Boolean

Метод возвращает истину, если бокс находится в пределах видимости камеры

Parameters:

  • box Box3

    Бокс three.js

Returns:

Boolean:

Результат

isBoxVectorsInCamera

(
  • vectors
)
Boolean

Метод возвращает истину, если бокс находится в пределах видимости камеры

Parameters:

  • vectors Vector3

    Векторы боксов three.js

Returns:

Boolean:

Результат

getObject3dScreenInfo

(
  • object3d
)
Object

Метод возвращает информацию об объекте three.js по отношению к экрану

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Object:

Результат в формате {size, square, distance}

getObject3dScreenSize

(
  • object3d
)
Number[]

Метод возвращает размеры объекта three.js на экране в пикселях

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Number[]:

Массив размеров (ширина и высота)

getObject3dScreenSquare

(
  • object3d
)
Number

Метод возвращает площадь объекта three.js на экране в пикселях

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Number:

Результат

correctObject3dByScreenSize

(
  • object3d
  • options
)
Object

Метод скрывает меши объекта three.js, которые занимают слишком мало места на экране

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

Returns:

Object:

Результат

disableObject3dCorrectionByScreenSize

(
  • object3d
)

Метод отключает скрытие мешей объекта three.js, которые занимают слишком мало места на экране

Parameters:

  • object3d Object3D

    Объект three.js

getObject3dVolume

(
  • object3d
)
Number

Метод возвращает объем параллелепипеда объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Number:

Результат

getObject3dWorldCenter

(
  • object3d
)
Vector3

Метод возвращает глобальную позицию объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Vector3:

Центр

getObject3dLocalCenter

(
  • object3d
)
Vector3

Метод возвращает локальную позицию объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Vector3:

Центр

getObject3dWorldInfo

(
  • object3d
)
Object

Метод возвращает мировую информацию об объекте three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Object:

Результат

object3dCenter

(
  • object3d
)

Метод изменяет позицию объекта так, чтобы он появился в нулевых координатах

Parameters:

  • object3d Object3D

    Объект three.js

object3dAsOtherGlobal

(
  • object3dResult
  • object3dSource
  • options
)

Метод устанавливает позицию, масштаб и вращение объекта как у другого объекта глобально

Parameters:

  • object3dResult Object3D

    Текущий объект three.js

  • object3dSource Object3D

    Другой объект three.js

  • options Object

    Дополнительные параметры

getObject3dMeshes

(
  • object3d
  • options
)
Mesh

Метод возвращает массив мешей объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры:

    • exceptions - массив имен мешей для исключения

Returns:

Mesh:

Массив мешей

object3dClone

(
  • object3d
)
Object3D

Метод клонирует объект three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Object3D:

Новый объект

object3dGeometriesMerge

(
  • object3d
)
BufferGeometry

Метод возвращает геометрию объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

BufferGeometry:

Новая геометрия

isCanObject3dToBoundCenter

(
  • object3d
)
Boolean

Метод возвращает истину, если возможно устанавливать позицию объекта three.js в его геометрическом центре

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Boolean:

Результат

object3dToBoundCenter

(
  • object3d
  • options
)

Метод устанавливает позицию объекта three.js в его геометрическом центре

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

setObject3dColor

(
  • object3d
  • color
  • options
)

Метод устанавливает цвет объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • color String

    Цвет в HEX-формате

  • options Object

    Дополнительные параметры

getObject3dSameMeshes

(
  • object3d
  • options
)
Promise async

Метод возвращает одинаковые меши объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры:

    • sameIdParam - Название параметра, по которому можно быстро определять одинаковые меши
    • exceptions - массив имен мешей для исключения

Returns:

Promise:

Массив мешей

getObject3dOptimizeParamValue

(
  • object3d
  • param
)
String

Метод возвращает значение параметра оптимизации объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • param String

    Имя параметра

Returns:

String:

Значение параметра

setObject3dOptimizeParamValue

(
  • object3d
  • param
  • value
)

Метод устанавливает значение параметра оптимизации объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • param String

    Имя параметра

  • value String

    Значение параметра

getObject3dOptimizeParam

(
  • object3d
  • param
)
String

Метод возвращает параметр оптимизации объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • param String

    Имя параметра

Returns:

String:

Параметр

object3dOptimizePrepare

(
  • object3d
  • options
)
async

Метод подготавливает объект three.js для оптимизации

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры:

    • sameIdParam - Название параметра в имени меша, по которому можно быстро определять одинаковые меши

object3dOptimize

(
  • object3d
  • options
)
Object async

Метод оптимизирует объект three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры:

    • sameIdParam - Название параметра в имени меша, по которому можно быстро определять одинаковые меши

Returns:

Object:

Информация об оптимизации

getObject3dClipping

(
  • object3d
  • options
)

Метод возвращает объект среза объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

updateObject3dClipping

(
  • object3d
)

Метод обновляет объект среза объекта three.js

Parameters:

  • object3d Object3D

    Объект среза

getGroupMeshes

(
  • group
)
Mesh

Метод возвращает массив мешей определенной группы

Parameters:

  • group Group

    Группа

Returns:

Mesh:

Массив мешей

getChildGroupByName

(
  • parentGroup
  • childGroupName
)
Group

Метод возвращает группу по имени внутри другой группы

Parameters:

  • parentGroup Group

    Родительская группа

  • childGroupName String

    Имя подгруппы

Returns:

Group:

Группа

meshInitParams

(
  • mesh
)

Метод инициализирует начальные параметры меша

Parameters:

  • mesh Mesh

    Клонируемый еши

getMeshMaterials

(
  • mesh
)
Material

Метод возвращает материалы меша

Parameters:

  • mesh Mesh

    Меш

Returns:

Material:

Материалы

setMeshColor

(
  • mesh
  • color
  • options
)

Метод устанавливает цвет меша

Parameters:

  • mesh Mesh | InstancedMesh

    Меш

  • color String

    Цвет в HEX-формате

  • options Object

    Дополнительные параметры

meshClone

(
  • mesh
)
Mesh

Метод возвращает полную копию мешу

Parameters:

  • mesh Mesh

    Клонируемый меш

Returns:

Mesh:

Новый меш

meshesMerge

(
  • meshes
  • options
)
Mesh

Метод возвращает меш из соединения других мешей

Parameters:

  • meshes Mesh

    Массив мешей

  • options Object

    Дополнительные параметры

Returns:

Mesh:

Меш

meshSimplify

(
  • mesh
  • percent
)

Метод упрощает геометрию меша

Parameters:

  • mesh Mesh

    Меш

  • percent Number

    Процент оставшейся геометрии

meshToBoundCenter

(
  • mesh
  • options
)
Vector3

Метод устанавливает позицию меша в его геометрическом центре

Parameters:

  • mesh Mesh

    Меш

  • options Object

    Дополнительные параметры

Returns:

Vector3:

Новая позиция меша

meshAsTriangle

(
  • mesh
  • triangleGeometry
)

Метод устанавливает меш как треугольник

Parameters:

  • mesh Mesh

    Меш

  • triangleGeometry BufferGeometry

    Геометрия треугольника

compareMeshes

(
  • meshes
  • options
)
Boolean

Метод возвращает истину, если меши одинаковы

Parameters:

  • meshes Mesh

    Меши

  • options Object

    Дополнительные параметры

Returns:

Boolean:

Результат

geometriesMerge

(
  • geometries
  • useGroups
)
BufferGeometry

Метод возвращает геометрию из соединения других геометрий

Parameters:

  • geometries BufferGeometry

    Соединяющиеся геометрии

  • useGroups Boolean

    Использовать ли группы

Returns:

BufferGeometry:

Новая геометрия

geometriesAttributesMerge

(
  • attributes
)
BufferAttribute

Метод возвращает атрибут геометрии из соединения других атрибутов

Parameters:

  • attributes BufferAttribute

    Соединяющиеся атрибуты

Returns:

BufferAttribute:

Новый атрибут

geometrySimplify

(
  • geometry
  • percent
)
BufferGeometry

Метод возвращает упрощенную геометрию

Parameters:

  • geometry BufferGeometry

    Геометрия

  • percent Number

    Процент оставшейся геометрии

Returns:

BufferGeometry:

Упрощенная геометрия

getTriangleGeometry

(
  • v1
  • v2
  • v3
)
BufferGeometry

Метод возвращает геометрию треугольника

Parameters:

  • v1 Vector3

    Вершина 1

  • v2 Vector3

    Вершина 2

  • v3 Vector3

    Вершина 3

Returns:

BufferGeometry:

Геометрия

getTriangleMesh

(
  • v1
  • v2
  • v3
  • material
)
Mesh

Метод возвращает меш треугольника

Parameters:

  • v1 Vector3

    Вершина 1

  • v2 Vector3

    Вершина 2

  • v3 Vector3

    Вершина 3

  • material Material

    Материал

Returns:

Mesh:

Меш

getTriangleNormal

(
  • geometry
)
Vector3

Метод возвращает нормаль треугольника

Parameters:

  • geometry BufferGeometry

    Геометрия

Returns:

Vector3:

Нормаль

getTriangleVertices

(
  • geometry
)
Vector3

Метод возвращает вершины треугольника

Parameters:

  • geometry BufferGeometry

    Геометрия

Returns:

Vector3:

Вершины

getTriangleCenter

(
  • geometry
)
Vector3

Метод возвращает центр треугольника

Parameters:

  • geometry BufferGeometry

    Геометрия

Returns:

Vector3:

Центр

getQuaternionBetweenTriangles

(
  • geometry1
  • geometry2
)
Quaternion

Метод возвращает поворот треугольника относительно другого треугольника

Parameters:

  • geometry1 BufferGeometry

    Геометрия первого треугольника

  • geometry2 BufferGeometry

    Геометрия второго треугольника

Returns:

Quaternion:

Поворот

getPlaneFromPoints

(
  • width
  • height
  • v1
  • v2
  • v3
  • material
)
Mesh

Метод возвращает плоскость на основе трех точек

Parameters:

  • width Number

    Ширина

  • height Number

    Высота

  • v1 Vector3

    Вершина 1

  • v2 Vector3

    Вершина 2

  • v3 Vector3

    Вершина 3

  • material Material

    Материал

Returns:

Mesh:

Меш

getPointProjection

(
  • point
  • objects
)
Vector3 | undefined

Метод возвращает проекцию точки на объекты three.js

Parameters:

  • point Vector3

    Точка

  • objects Object3D

    Массив объектов three.js

Returns:

Vector3 | undefined:

Точка

exportToBlob

(
  • object3d
  • format
  • options
)
Blob | null async

Метод экспортирует объект three.js в различные форматы (GLTF, USDZ)

Parameters:

  • object3d Object3D

    Объект three.js

  • format String

    Формат модели для экспорта

  • options Object

    Дополнительные параметры

Returns:

Blob | null:

Результат

addBoxHelper

(
  • object3d
  • options
)
BoxHelper

Метод добавляет BoxHelper на сцену и возвращает его

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

Returns:

BoxHelper:

Объект BoxHelper

getBoundBox

(
  • object3d
  • options
)
Mesh

Метод возвращает меш по границам объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

Returns:

Mesh:

Меш

addBoundBox

(
  • object3d
  • options
)
Mesh

Метод добавляет меш по границам объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

Returns:

Mesh:

Меш

updateTexture

(
  • texture
  • options
)
Texture | CanvasTexture

Метод обновляет текстуру и при необходимости создает текстуру на основе холста

Parameters:

  • texture Texture | CanvasTexture

    Текстура

  • options Object

    Дополнительные параметры

Returns:

Texture | CanvasTexture:

Результат

disposeMaterial

(
  • material
)

Метод уничтожения материала

Parameters:

  • material Material

    Материал

disposeObject3d

(
  • object3d
)

Метод уничтожения объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

setOptions

(
  • optionsCur
  • options
)
Object

Метод обновляет параметры по умолчанию переданными значениями и возвращает полученный результат

Parameters:

  • optionsCur Object

    Параметры по умолчанию

  • options Object

    Дополнительные параметры

Returns:

Object:

Результат

getObject3dMeshes

(
  • object3d
  • options
)
Mesh

Метод возвращает массив мешей объекта three.js

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры:

    • exceptions - массив имен мешей для исключения

Returns:

Mesh:

Массив мешей

object3dToBoundCenter

(
  • object3d
  • options
)

Метод устанавливает позицию объекта three.js в его геометрическом центре

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

    Дополнительные параметры

meshInitParams

(
  • mesh
)

Метод инициализирует начальные параметры меша

Parameters:

  • mesh Mesh

    Клонируемый еши

meshToBoundCenter

(
  • mesh
  • options
)
Vector3

Метод устанавливает позицию меша в его геометрическом центре

Parameters:

  • mesh Mesh

    Меш

  • options Object

    Дополнительные параметры

Returns:

Vector3:

Новая позиция меша

Properties

simplifyModifier

Object

Свойство возвращает объект SimplifyModifier