API Docs for: 1.0.0
Show:

Site3d Class

Defined in: base\site3d.js:11
Module: Site3d

Класс сцены

Constructor

Site3d

(
  • canvasId
  • options
)

Defined in base\site3d.js:11

Parameters:

  • canvasId String

    Идентификатор тега canvas

  • options Object

    Параметры сцены:

    • load(info) – функция обработки процесса загрузки сцены, которая в качестве аргумента возвращает объект со следующими свойствами:
    • countModel – число добавленных для загрузки моделей
    • countModelLoaded – число загруженных моделей
    • isPreloadCompleted – истина, если завершена предварительная загрузка сцены (данный этап помечается методом preload)
    • quality – качество рендера от 1 до 100 (по умолчанию 100)

Item Index

Methods

Methods

load

(
  • url
  • onLoad
  • onProgress
  • onError
)

Load 3ds file from url.

Parameters:

  • url type

    URL for the file.

  • onLoad Function

    onLoad callback, receives group Object3D as argument.

  • onProgress Function

    onProgress callback.

  • onError Function

    onError callback.

parse

(
  • arraybuffer
  • path
)
Group

Parse arraybuffer data and load 3ds file.

Parameters:

  • arraybuffer ArrayBuffer

    Arraybuffer data to be loaded.

  • path String

    Path for external resources.

Returns:

Group:

Group loaded from 3ds file.

readFile

(
  • arraybuffer
  • path
)

Decode file content to read 3ds data.

Parameters:

  • arraybuffer ArrayBuffer

    Arraybuffer data to be loaded.

  • path String

    Path for external resources.

readMeshData

(
  • chunk
  • path
)

Read mesh data chunk.

Parameters:

  • chunk Chunk

    to read mesh from

  • path String

    Path for external resources.

readNamedObject

(
  • chunk
)

Read named object chunk.

Parameters:

  • chunk Chunk

    Chunk in use.

readMaterialEntry

(
  • chunk
  • path
)

Read material data chunk and add it to the material list.

Parameters:

  • chunk Chunk

    Chunk in use.

  • path String

    Path for external resources.

readMesh

(
  • chunk
)
Mesh

Read mesh data chunk.

Parameters:

  • chunk Chunk

    Chunk in use.

Returns:

Mesh:

The parsed mesh.

readFaceArray

(
  • chunk
  • mesh
)

Read face array data chunk.

Parameters:

  • chunk Chunk

    Chunk in use.

  • mesh Mesh

    Mesh to be filled with the data read.

readMap

(
  • chunk
  • path
)
Texture

Read texture map data chunk.

Parameters:

  • chunk Chunk

    Chunk in use.

  • path String

    Path for external resources.

Returns:

Texture:

Texture read from this data chunk.

readMaterialGroup

(
  • chunk
)
Object

Read material group data chunk.

Parameters:

  • chunk Chunk

    Chunk in use.

Returns:

Object:

Object with name and index of the object.

readColor

(
  • chunk
)
Color

Read a color value.

Parameters:

  • chunk Chunk

    Chunk.

Returns:

Color:

Color value read..

readPercentage

(
  • chunk
)
Number

Read percentage value.

Parameters:

  • chunk Chunk

    Chunk to read data from.

Returns:

Number:

Data read from the dataview.

debugMessage

(
  • message
)

Print debug message to the console.

Is controlled by a flag to show or hide debug messages.

Parameters:

  • message Object

    Debug message to print to the console.

readChunk

() Chunk | null

read a sub cchunk.

Returns:

Chunk | null:

next sub chunk

idToString

() String

return the ID of this chunk as Hex

Returns:

String:

hex-string of id

readByte

() Number

Read byte value.

Returns:

Number:

Data read from the dataview.

readFloat

() Number

Read 32 bit float value.

Returns:

Number:

Data read from the dataview.

readInt

() Number

Read 32 bit signed integer value.

Returns:

Number:

Data read from the dataview.

readShort

() Number

Read 16 bit signed integer value.

Returns:

Number:

Data read from the dataview.

readDWord

() Number

Read 64 bit unsigned integer value.

Returns:

Number:

Data read from the dataview.

readWord

() Number

Read 32 bit unsigned integer value.

Returns:

Number:

Data read from the dataview.

readString

() String

Read NULL terminated ASCII string value from chunk-pos.

Returns:

String:

Data read from the dataview.

getVector

(
  • array
)
Vector3 static

Defined in base\site3d.js:525

Метод преобразует массив из трех чисел в объект Vector3

Parameters:

  • array Number[]

    Массив из трех чисел

Returns:

Vector3:

Объект Vector3

getArrayVector

(
  • vector
)
Number[] static

Defined in base\site3d.js:537

Метод преобразует тройку чисел в виде объекта со свойствами x, y, z в массив из трех чисел

Parameters:

  • vector Object

    Тройка чисел в виде объекта

Returns:

Number[]:

Массив из трех чисел

normalizeRad

(
  • angle
)
Number static

Defined in base\site3d.js:549

Метод возвращает значение угла в радинах между -2PI и 2PI

Parameters:

  • angle Number

    Угол в радианах

Returns:

Number:

Результат

normalizeDeg

(
  • angle
)
Number static

Defined in base\site3d.js:561

Метод возвращает значение угла в градусах между -360 и 360

Parameters:

  • angle Number

    Угол в градусах

Returns:

Number:

Результат

toRad

(
  • angle
)
Number static

Defined in base\site3d.js:573

Метод переводит градусы в радианы

Parameters:

  • angle Number

    Угол в градусах

Returns:

Number:

Угол в радинах

toDeg

(
  • angle
)
Number static

Defined in base\site3d.js:585

Метод переводит радианы в градусы

Parameters:

  • angle Number

    Угол в радинах

Returns:

Number:

Угол в градусах

getFloat

(
  • value
  • fraction
)
Number | number static

Defined in base\site3d.js:597

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

Parameters:

  • value Number | string | number

    Входное значение (может быть числом или строкой)

  • fraction Number

    Число знаков после запятой (по умолчанию Site3d.fraction)

Returns:

Number | number:

Округленное значение с дробной частью

getFloatArray

(
  • array
  • fraction
)
Array static

Defined in base\site3d.js:610

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

Parameters:

  • array Array

    Входной массив

  • fraction Number

    Число знаков после запятой (по умолчанию Site3d.fraction)

Returns:

Array:

Массив с округленными значениями

isPointsEqual

(
  • point1
  • point2
  • error
)
Boolean static

Defined in base\site3d.js:623

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

Parameters:

  • point1 Number[]

    Массив координат точки

  • point2 Number[]

    Массив координат точки

  • error Number

    Точность сравнения (по умолчанию 0.01)

Returns:

Boolean:

Результат сравнения

isPosEqual

(
  • pos1
  • pos2
  • error
)
Boolean static

Defined in base\site3d.js:637

Метод возвращает истину, если позиции совпадают

Parameters:

  • pos1 Number[]

    Массив координат позиции

  • pos2 Number[]

    Массив координат позиции

  • error Number

    Точность сравнения (по умолчанию 0.01)

Returns:

Boolean:

Результат сравнения

sum

() Number[] static

Defined in base\site3d.js:651

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

Returns:

Number[]:

Результат сложения

diff

(
  • pos1
  • pos2
  • fraction
)
Number[] static

Defined in base\site3d.js:669

Метод возвращает разницу в координатах двух позиций

Parameters:

  • pos1 Number[]

    Первая позиция

  • pos2 Number[]

    Вторая позиция

  • fraction Number

    Число знаков после запятой (по умолчанию Site3d.fraction)

Returns:

Number[]:

Разность

getDistance

(
  • pos1
  • pos2
)
Number static

Defined in base\site3d.js:683

Метод возвращает расстояние между двумя позициями

Parameters:

  • pos1 Number[]

    Первая позиция

  • pos2 Number[]

    Вторая позиция

Returns:

Number:

Расстояние

mousePos

(
  • e
)
Number[] static

Defined in base\site3d.js:696

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

Parameters:

  • e Object

    Объект результата события

Returns:

Number[]:

Координаты указателя

fingerDistance

(
  • p1
  • p2
)
Number static

Defined in base\site3d.js:708

Метод возвращает расстояние между двумя касаниями тача

Parameters:

  • p1 Object

    Объект результата события для первого касания

  • p2 Object

    Объект результата события для второго касания

Returns:

Number:

Расстояние

getModelsCenter

(
  • models
)
Number[] static

Defined in base\site3d.js:751

Метод возвращает центр параллелепипеда, ограничивающего массив моделей

Parameters:

Returns:

Number[]:

Массив координат центра

getModelsBoundSize

(
  • models
)
Number[] static

Defined in base\site3d.js:763

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

Parameters:

Returns:

Number[]:

Размеры

getModelsInfo

(
  • models
  • include
)
Object static

Defined in base\site3d.js:775

Метод возвращает информацию об общем параллелепипеде моделей

Parameters:

  • models Site3dModel[]

    Массив моделей

  • include String[]

    Массив возвращаемых значений

Returns:

Object:

Результат

blobToBase64

(
  • blob
)
Promise static async

Defined in base\site3d.js:802

Метод возвращает Base64 версию Blob объекта

Parameters:

  • blob Blob

    Blob объект

Returns:

Promise:

Результат в виде строки

clear

() static

Defined in base\site3d.js:836

Метод очистки сцены

preload

()

Defined in base\site3d.js:851

Метод отметки момента окончания предварительной загрузки сцены

getElapsedTime

() Number

Defined in base\site3d.js:861

Метод возвращает время существования сцены

Returns:

Number:

Время в миллисекундах

background

(
  • value
)

Defined in base\site3d.js:873

Метод установки цвета фона

Parameters:

  • value String | null

    Цвет в HEX-формате или путь до изображения в формате jpg или png

setEffectsActivity

()

Defined in base\site3d.js:894

Метод установки активности эффектов сцены

effects

(
  • options
)

Defined in base\site3d.js:911

Метод установки эффектов сцены

Parameters:

  • options Object

    Параметры эффектов:

    • brightness – яркость от 0 до 10 (по умолчанию 5)
    • contrast – контраст от 0 до 10 (по умолчанию 5)

setModelOutline

(
  • model
  • options
)

Defined in base\site3d.js:971

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

Parameters:

  • model Site3dModel

    Модель

  • options Object

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

showModelOutline

(
  • model
)

Defined in base\site3d.js:997

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

Parameters:

hideModelOutline

(
  • model
)

Defined in base\site3d.js:1014

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

Parameters:

updateOutlines

()

Defined in base\site3d.js:1031

Метод обновляет свечения вокруг моделей

clearOutlines

()

Defined in base\site3d.js:1108

Метод удаляет свечения вокруг моделей

updateWatermark

(
  • value
)
async

Defined in base\site3d.js:1118

Метод обновляет водяной знак

Parameters:

  • value Object

    Параметры

enableEnvironment

(
  • options
)

Defined in base\site3d.js:1162

Метод включения окружения

Parameters:

  • options String

    Параметры окружения:

    • fill – путь до файла панорамной текстуры в формате HDR или одно и предустановленных значений: «grey» (по умолчанию), «sunset»
    • tone – степень наложения текстуры на объекты от 0 до 1 (по умолчанию, 0.5)
    • isBackground – истина, если нужно отобразить текстуру в качестве фона сцены (по умолчанию false)

disableEnvironment

()

Defined in base\site3d.js:1204

Метод отключения окружения

fog

(
  • options
)

Defined in base\site3d.js:1218

Метод установки тумана

Parameters:

  • options String

    Параметры тумана:

    • color – цвет
    • near и far – параметры густоты тумана в зависимости от расстояния

cameraSetup

(
  • options
)

Defined in base\site3d.js:1232

Метод настройки основных параметров камеры

Parameters:

  • options Object

    Параметры камеры:

    • angle – угол зрения (по умолчанию 50)
    • near и far – пространство перед камерой (от и до, по умолчанию 0.1 и 100)
    • pos – позиция (по умолчанию [0, 0, 1])
    • target – точка наблюдения (по умолчанию [0, 0, 0])

cameraRotateWorld

(
  • stepX
  • stepY
  • stepZ
)

Defined in base\site3d.js:1246

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

Parameters:

  • stepX Number

    Угол поворота вдоль оси X

  • stepY Number

    Угол поворота вдоль оси Y

  • stepZ Number

    Угол поворота вдоль оси Z

cameraSetPrev

()

Defined in base\site3d.js:1258

Метод подсчитывает предыдущее положение камеры

line

(
  • name
  • posList
  • fill
  • load
)
Site3dLine

Defined in base\site3d.js:1269

Метод добавляет линию

Parameters:

  • name String

    Имя модели

  • posList Array

    Двумерный массив точек линии

  • fill Object

    Наполнение (по умолчанию белый цвет)

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dLine:

Объект модели

sprite

(
  • name
  • path
  • load
)
Site3dSprite

Defined in base\site3d.js:1283

Метод добавляет спрайт

Parameters:

  • name String

    Имя модели

  • path String

    Путь до изображения спрайта

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dSprite:

Объект модели

triangle

(
  • name
  • pos1
  • pos2
  • pos3
  • fill
  • load
)
Site3dTriangle

Defined in base\site3d.js:1296

Метод добавляет треугольник

Parameters:

  • name String

    Имя модели

  • pos1 Number[]

    Позиция первой точки

  • pos2 Number[]

    Позиция второй точки

  • pos3 Number[]

    Позиция третей точки

  • fill Object

    Наполнение (по умолчанию белый цвет)

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dTriangle:

Объект модели

plane

(
  • name
  • width
  • height
  • fill
  • load
)
Site3dPlane

Defined in base\site3d.js:1312

Метод добавляет плоскость

Parameters:

  • name String

    Имя модели

  • width Number

    Ширина

  • height Number

    Высота

  • fill Object

    Наполнение (по умолчанию белый цвет)

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dPlane:

Объект модели

circle

(
  • name
  • radius
  • detail
  • fill
  • load
)
Site3dCircle

Defined in base\site3d.js:1327

Метод добавляет круг

Parameters:

  • name String

    Имя модели

  • radius Number

    Радиус

  • detail Number

    Число сегментов (по умолчанию 16)

  • fill Object

    Наполнение (по умолчанию белый цвет)

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dCircle:

Объект модели

cube

(
  • name
  • size
  • fill
  • load
)
Site3dCube

Defined in base\site3d.js:1342

Метод добавляет параллелепипед

Parameters:

  • name String

    Имя модели

  • size Number[]

    Размеры

  • fill Object

    Наполнение

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dCube:

Объект модели

sphere

(
  • name
  • radius
  • detail
  • fill
  • load
)
Site3dSphere

Defined in base\site3d.js:1356

Метод добавляет сферу

Parameters:

  • name String

    Имя модели

  • radius Number

    Радиус

  • detail Number

    Число сегментов

  • fill Object

    Наполнение

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dSphere:

Объект модели

hemisphere

(
  • name
  • radius
  • detail
  • fill
  • load
)
Site3dHemisphere

Defined in base\site3d.js:1371

Метод добавляет полусферу

Parameters:

  • name String

    Имя модели

  • radius Number

    Радиус

  • detail Number

    Число сегментов

  • fill Object

    Наполнение

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dHemisphere:

Объект модели

octahedron

(
  • name
  • radius
  • detail
  • fill
  • load
)
Site3dOctahedron

Defined in base\site3d.js:1386

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

Parameters:

  • name String

    Имя модели

  • radius Number

    Радиус

  • detail Number

    Число сегментов

  • fill Object

    Наполнение

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dOctahedron:

Объект модели

shape

(
  • name
  • points
  • fill
  • options
  • load
)
Site3dShape

Defined in base\site3d.js:1401

Метод добавляет произвольную форму путем экструдирования плоской формы

Parameters:

  • name String

    Имя модели

  • points Array

    Массив точек

  • fill Object

    Наполнение

  • options Object

    Параметры:

    • depth - глубина экструдирования (по-умолчанию 1)
    • steps - число шагов экструдирования (по-умолчанию 1)
    • bevelEnabled - истина, если края скошены (по-умолчанию false)
  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dShape:

Объект модели

importModel

(
  • name
  • path
  • options
)
Site3dImportModel

Defined in base\site3d.js:1419

Метод добавляет модель в формате GLTF

Parameters:

  • name String

    Имя модели

  • path String

    Путь до файла модели

  • options Object

    Параметры

Returns:

Site3dImportModel:

Объект модели в качестве результата промиса

importModelAsync

(
  • name
  • path
  • options
)
Site3dImportModel async

Defined in base\site3d.js:1432

Метод добавляет модель в формате GLTF асинхронно

Parameters:

  • name String

    Имя модели

  • path String

    Путь до файла модели

  • options Object

    Параметры

Returns:

Site3dImportModel:

Объект модели в качестве результата промиса

modelClipping

(
  • name
  • model
  • options
  • load
)
Site3dModelClipping

Defined in base\site3d.js:1472

Метод добавляет модель среза

Parameters:

  • name String

    Имя модели

  • model Site3dModel

    Модель, у которой будет сделан срез

  • options Object

    Дополнительные опции

  • load Function

    Функцию информирования об окончании процесса загрузки (в качестве аргумента передается объект модели)

Returns:

Site3dModelClipping:

Объект модели

isModel

(
  • name
)
Boolean

Defined in base\site3d.js:1486

Метод возвращает истину, если в сцене есть модель

Parameters:

  • name String

    Имя модели

Returns:

Boolean:

Результат

model

(
  • name
)
Site3dModel

Defined in base\site3d.js:1497

Метод возвращает модель

Parameters:

  • name String

    Имя модели

Returns:

Site3dModel:

Объект модели

removeModel

(
  • name
)

Defined in base\site3d.js:1508

Метод удаляет модель

Parameters:

  • name String

    Имя модели

removeModelSilent

(
  • name
)

Defined in base\site3d.js:1522

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

Parameters:

  • name String

    Имя модели

addFill

(
  • name
  • fill
  • load
)
async

Defined in base\site3d.js:1538

Метод добавляет поименованное наполнение

Parameters:

  • name String

    Имя наполнения

  • fill Object

    Наполнение

  • load Function

    Функцию информирования об окончании процесса создания наполнения

ambientLight

(
  • name
  • options
)
Site3dAmbientLight

Defined in base\site3d.js:1557

Метод добавляет общий свет

Parameters:

  • name String

    Имя источника освещения

  • options Object

    Параметры освещения:

    • color – цвет в HEX-формате (по умолчанию белый)
    • power – мощность (по умолчанию 1)

Returns:

Site3dAmbientLight:

Объект источника освещения

directionalLight

(
  • name
  • options
)
Site3dDirectionalLight

Defined in base\site3d.js:1578

Метод добавляет направленный свет

Parameters:

  • name String

    Имя источника освещения

  • options Object

    Параметры освещения:

    • color – цвет в HEX-формате (по умолчанию белый)
    • power – мощность (по умолчанию 1)
    • pos – позиция источника (по умолчанию [1, 1, 1])
    • target – позиция направления (по умолчанию [0, 0, 0])

Returns:

Site3dDirectionalLight:

Объект источника освещения

spotLight

(
  • name
  • options
)
Site3dSpotLight

Defined in base\site3d.js:1602

Метод добавляет конусный свет

Parameters:

  • name String

    Имя источника освещения

  • options Object

    Параметры освещения:

    • color – цвет в HEX-формате (по умолчанию белый)
    • power – мощность (по умолчанию 1)
    • pos – позиция источника (по умолчанию [1, 1, 1])
    • target – позиция направления (по умолчанию [0, 0, 0])
    • angle – угол конуса (по умолчанию 45)
    • blur – сглаженность светового пятна (по умолчанию 0.5)

Returns:

Site3dSpotLight:

Объект источника освещения

light

(
  • name
)
Site3dLight

Defined in base\site3d.js:1620

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

Parameters:

  • name String

    Имя источника освещения

Returns:

Site3dLight:

Объект источника освещения

enableControls

(
  • options
)

Defined in base\site3d.js:1633

Метод включает управление сценой

Parameters:

  • options Object

    Параметры:

    • move – перемещение вдоль глобальных осей:
    • isEnabled – истина, если перемещение включено (по умолчанию включено, если передать параметр move)
    • events – массив строк органов управления (возможные значения: «mouse_left» – левая кнопка мыши, «mouse_right» – правая кнопка мыши, «touch_move» – перемещение пальцем (по умолчанию: [«mouse_left», «touch_move»]))
    • isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию истина)
    • minY – минимальная координата перемещения вдоль оси y (по умолчанию 0)
    • maxY – максимальная координата перемещения вдоль оси y (по умолчанию 0)
    • minTargetY – минимальная координата перемещения центра масштабирования и вращения вдоль оси y (по умолчанию 0)
    • maxTargetY – максимальная координата перемещения центра масштабирования и вращения вдоль оси y (по умолчанию 0)
    • axes – оси вращения (y (по умолчанию: «y»))
    • speed – скорость (по умолчанию: 1)
    • scale – масштабирование колесом прокрутки или жестом:
    • isEnabled – истина, если масштабирование включено (по умолчанию включено, если передать параметр scale)
    • min – минимальное расстояние до центра масштабирования (по умолчанию: 1)
    • max – максимальное расстояние до центра масштабирования (по умолчанию: 10)
    • speed – скорость (по умолчанию: 1)
    • rotate – вращение:
    • isEnabled – истина, если вращение включено (по умолчанию включено, если передать параметр rotate)
    • events – массив строк органов управления (возможные значения: «mouse_left» – левая кнопка мыши, «mouse_right» – правая кнопка мыши, «touch_move» – перемещение пальцем (по умолчанию: [«mouse_left», «touch_move»]))
    • min – минимальный угол поворота (по умолчанию 0)
    • max – максимальный угол поворота (по умолчанию 90)
    • axes – оси вращения (x, y или x и y одновременно (по умолчанию: «xy»))
    • speed – скорость (по умолчанию: 1)
    • target – центр масштабирования и вращения (по умолчанию [0, 0, 0]), если передать false, то масштабирование будет без учета минимального и максимального значений, а вращение будет на месте

disableControls

()

Defined in base\site3d.js:1702

Метод выключает управление сценой

setControlsTargetSilent

(
  • target
)
Boolean

Defined in base\site3d.js:1734

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

Parameters:

Returns:

Boolean:

Истина, если произошло изменение

moveControlsTarget

(
  • steps
)

Defined in base\site3d.js:1751

Метод устанавливает центр масштабирования и вращения

Parameters:

  • steps Number[]

    Шаги изменений в координатах

moveControlsTargetSilent

(
  • steps
)

Defined in base\site3d.js:1764

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

Parameters:

  • steps Number[]

    Шаги изменений в координатах

rotateAroundTarget

(
  • angle
  • options
)

Defined in base\site3d.js:1807

Метод поворачивает камеру вокруг центра масштабирования и вращения

Parameters:

  • angle Number

    Угол поворота

  • options Object

    Параметры

intersectModel

(
  • model
  • fromModels
  • options
)
Object | null

Defined in base\site3d.js:1836

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

Parameters:

  • model Site3dModel

    Модель (по-умолчанию null - пересечение будет искаться со всеми моделями)

  • fromModels Array

    Массив моделей, среди которых искать пересечения (по-умолчанию null - пересечение будет искаться по всей сцене)

  • options Object

    Параметры:

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

Returns:

Object | null:

Объект результата или null при отсутствии пересечения:

  • model - модель, с которой нашлось пересечение
  • pos - позиция пересечения

event

(
  • name
  • call
  • options
)

Defined in base\site3d.js:1961

Метод подписывает на события сцены

Parameters:

  • name String

    Имя события

  • call Function

    Функция обработки события

  • options Object

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

removeEvent

(
  • name
  • call
)

Defined in base\site3d.js:1984

Метод удаляет подписку на событие сцены

Parameters:

  • name String

    Имя события

  • call Function

    Функция обработки события

callEvent

(
  • name
  • options
)

Defined in base\site3d.js:1995

Метод вызывает событие Site3d

Parameters:

  • name String

    Кодовое обозначение события

  • options Object

    Дополнительные параметры (добавляются в параметр события в качестве свойства info)

startCallEvents

()

Defined in base\site3d.js:2024

Метод запускает генерацию событий сцены

startCallEvents

()

Defined in base\site3d.js:2033

Метод останавливает генерацию событий сцены

addEventListener

(
  • name
  • handler
)

Defined in base\site3d.js:2042

Метод добавляет обработчик события Site3d

Parameters:

  • name String

    Кодовое обозначение события

  • handler Function

    Обработчик события

removeEventListener

(
  • name
  • handler
)

Defined in base\site3d.js:2054

Метод удаляет обработчик события Site3d

Parameters:

  • name String

    Кодовое обозначение события

  • handler Function

    Обработчик события

setEvents

(
  • domElement
)

Defined in base\site3d.js:2066

Метод устанавливает обработчики событий Site3d для HTML-элемента

Parameters:

setPostRenderPrev

()

Defined in base\site3d.js:2140

Метод устанавливает предыдущее значение isPostRender

startLastRender

()

Defined in base\site3d.js:2227

Метод запускает последний запускаемый рендер сцены

stopLastRender

()

Defined in base\site3d.js:2236

Метод останавливает последний запускаемый рендер сцены

render

()

Defined in base\site3d.js:2245

Метод отрисовки сцены (для автоматического рендера можно использовать один из дочерних классов site3dRender)

setRenderSize

(
  • size
)

Defined in base\site3d.js:2285

Метод изменяет размер рендера

Parameters:

  • size Number[]

    Размер рендера

resize

()

Defined in base\site3d.js:2323

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

getScreenshotAsBlob

(
  • options
)
Blob async

Defined in base\site3d.js:2394

Метод делает скриншот сцены и возвращает его в формате Blob

Parameters:

  • options Object

    Параметры скриншота:

    • canvas - с какого холста делать скриншот (по умолчанию текущий холст)
    • size - размеры скриншота (по умолчанию [1920, 1080])

Returns:

Blob:

Скриншот

downloadScreenshot

(
  • fileName
  • options
)
async

Defined in base\site3d.js:2496

Метод делает скриншот сцены и вызывает его загрузку в браузере

Parameters:

  • fileName String

    Имя сохраняемого файла

  • options Object

    Параметры скриншота:

    • size - размеры скриншота (по умолчанию [1920, 1080])

hideByClick

(
  • elem
  • hide
  • except
)

Defined in base\site3d.js:2531

Метод добавляет к элементу DOM событие его скрытия при клике вне области элемента

Parameters:

  • elem HTMLElement | string

    Элемент DOM или его идентификатор

  • hide Function

    Функция, срабатываемая при событии клика вне элемента

  • except HTMLElement

    Элемент DOM в виде исключения

removeHideByClick

(
  • elem
)

Defined in base\site3d.js:2552

Метод удаляет у элемента DOM событие его скрытия при клике вне области элемента

Parameters:

  • elem HTMLElement | string

    Элемент DOM или его идентификатор

updateHideByClickContainer

(
  • container
)

Defined in base\site3d.js:2577

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

Parameters:

getMinViewDistance

(
  • size
  • options
)
Number

Defined in base\site3d.js:2593

Метод возвращает минимальное расстояние приближения к параллелепипеду от её центра

Parameters:

  • size Number[]

    Размер параллелепипеда

  • options Object

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

Returns:

Number:

Расстояние

getViewDistance

(
  • size
  • distance
  • options
)
Number

Defined in base\site3d.js:2612

Метод возвращает расстояние приближения к параллелепипеду от её центра

Parameters:

  • size Number[]

    Размер параллелепипеда

  • distance Number | string

    Дистанция от границ модели (число или процент от минимального расстояния)

  • options Object

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

Returns:

Number:

Расстояние

loseContext

()

Defined in base\site3d.js:2642

Метод вызывает потерю контекста WebGL

Properties

controlsTarget

Number[]

Defined in base\site3d.js:1711

Свойство возвращает центр масштабирования и вращения

controlsTarget

Unknown

Defined in base\site3d.js:1721

Свойство устанавливает центр масштабирования и вращения

Sub-properties:

controlsPrevTarget

Number[]

Defined in base\site3d.js:1787

Свойство возвращает предыдущий центр масштабирования и вращения

controlsTargetDistance

Number

Defined in base\site3d.js:1797

Свойство возвращает расстояние камеры до центра масштабирования и вращения

canvas

HTMLCanvasElement

Defined in base\site3d.js:2083

Свойство возвращает холст сцены

options

Object

Defined in base\site3d.js:2093

Свойство возвращает настройки сцены

webglVersion

String

Defined in base\site3d.js:2103

Свойство возвращает версию WebGL

isPostRender

Boolean

Defined in base\site3d.js:2113

Свойство возвращает истину, если во время отрисовки сцены применяется дополнительная обработка

isPostRender

Unknown

Defined in base\site3d.js:2123

Свойство устанавливает применение дополнительной обработки во время отрисовки сцены

lastRender

Site3dRender

Defined in base\site3d.js:2154

Свойство возвращает последний запущенный рендер сцены

shadows

Boolean

Defined in base\site3d.js:2164

Свойство возвращает истину, если в сцене включены тени

shadows

Unknown

Defined in base\site3d.js:2174

Свойство включает и отключает тени у всех источников

info

Object

Defined in base\site3d.js:2185

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

models

Map

Defined in base\site3d.js:2197

Свойство возвращает список моделей в сцене

camera

Site3dCamera

Defined in base\site3d.js:2207

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

maxAnisotropy

Number

Defined in base\site3d.js:2217

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

quality

Number

Defined in base\site3d.js:2343

Свойство возвращает качество рендера от 1 до 100

quality

Unknown

Defined in base\site3d.js:2353

Свойство устанавливает качество рендера

Sub-properties:

  • value Number

    Качество рендера от 1 до 100

alpha

Boolean

Defined in base\site3d.js:2369

Свойство возвращает включение прозрачности

alpha

Unknown

Defined in base\site3d.js:2379

Свойство устанавливает включение прозрачности

Sub-properties:

  • value Boolean

    Включение прозрачности

isCursorPointer

Boolean

Defined in base\site3d.js:2510

Свойство возвращает показ и скрытие курсора при наведении указателя

isCursorPointer

Unknown

Defined in base\site3d.js:2520

Свойство устанавливает показ и скрытие курсора при наведении указателя

Sub-properties:

hideByClickDone

Boolean

Defined in base\site3d.js:2567

Свойство возвращает истину, если произошло закрытие DOM элементов по клику вне их области