API Docs for:
Show:

Site3dThree Class

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

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

Constructor

Site3dThree

(
  • options
)

Parameters:

  • options Object

    Параметры

Item Index

Methods

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
  • options
)
Box3

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

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

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

    • isOnlyVisible - учитывать только видимые части модели

Returns:

Box3:

Результат

getObject3dSize

(
  • object3d
  • options
)
Number

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

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

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

    • isOnlyVisible - учитывать только видимые части модели

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:

Результат

getVectorsScreenInfo

(
  • vectors
  • options
)
Object

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

Parameters:

  • vectors 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:

Результат

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:

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

object3dCheckNormals

(
  • object3d
)

Метод создает нормали у объекта three.js, где их нет

Parameters:

  • object3d Object3D

    Объект three.js

object3dRemoveMaterialArray

(
  • object3d
)

Метод заменяет массив материалов у мешей объекта three.js на первый материал в массиве

Parameters:

  • object3d Object3D

    Объект three.js

object3dMeshesByMaterials

(
  • object3d
)

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

Parameters:

  • object3d Object3D

    Объект three.js

isCanObject3dTransform

(
  • object3d
)
Boolean

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

Parameters:

  • object3d Object3D

    Объект three.js

Returns:

Boolean:

Результат

object3dToLocalCenter

(
  • object3d
  • options
)

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

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

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

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:

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

object3dConnectInside

(
  • object3d
  • options
)

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

Parameters:

  • object3d Object3D

    Объект three.js

  • options Object

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

    • axis - Ось, вдоль которой происходит соединение (по умолчанию Y)

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:

Центр

deepCloneMaterial

(
  • material
)
Material

Метод клонирует полностью материал

Parameters:

  • material Material

    Материал

Returns:

Material:

Новый материал

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:

Результат

createTextTexture

(
  • 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

OS

String

Свойство возвращает операционную систему

isMobile

Boolean

Свойство возвращает истину, если это мобильное устройство

isWebView

Boolean

Свойство возвращает истину, если используется WebView