Site3dCamera Class
Класс камеры
Constructor
Item Index
Methods
Methods
setup
-
options
Метод настройки основных параметров камеры
Parameters:
-
options
ObjectПараметры камеры:
- type – тип камеры (perspective или orthographic, по умолчанию perspective)
- angle – угол зрения (только для типа perspective, по умолчанию 50)
- near и far – пространство перед камерой (от и до, по умолчанию 0.1 и 1000)
- pos – позиция (по умолчанию [0, 0, 1])
- target – точка наблюдения (по умолчанию [0, 0, 0])
getPos
()
Number
Метод возвращает позицию камеры
Returns:
Позиция
pos
()
Метод изменяет позицию камеры, запоминает предыдущее состояние и вызывает событие отрисовки (передаются координаты в виде трех параметров или массив координат)
posSilent
()
Метод изменяет позицию камеры (смотрите описание параметров для метода pos)
isPos
-
pos
Метод возвращает истину, если переданная позиция совпадает с текущей
Parameters:
-
pos
NumberПозиция
Returns:
Результат сравнения позиций
moveForward
-
step
-
options
Метод перемещает камеру в направлении взгляда вдоль плоскости XZ, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
step
NumberШаг перемещения
-
options
ObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
moveForwardSilent
-
step
-
options
Метод перемещает камеру в направлении взгляда вдоль плоскости XZ
Parameters:
-
step
NumberШаг перемещения
-
options
ObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
moveSideways
-
step
-
options
Метод перемещает камеру боком, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
step
NumberШаг перемещения
-
options
ObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
moveSidewaysSilent
-
step
-
options
Метод перемещает камеру боком
Parameters:
-
step
NumberШаг перемещения
-
options
ObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
move
()
Метод перемещает камеру, запоминает предыдущее состояние и вызывает событие отрисовки. Варианты параметров:
- step – движение в направлении взгляда вдоль плоскости xz
- step, pos – движение в направлении точки pos
- stepX, stepY, stepZ, options – движение по трем осям, где options:
- isLocal – истина, если локальное перемещение (по умолчанию истина)
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
- minY – минимальная координата перемещения вдоль оси y (по умолчанию 0)
- maxY – максимальная координата перемещения вдоль оси y (по умолчанию 0)
- minTargetY – минимальная координата перемещения центра масштабирования и вращения вдоль оси y (по умолчанию 0)
- maxTargetY – максимальная координата перемещения центра масштабирования и вращения вдоль оси y (по умолчанию 0)
moveSilent
()
Метод перемещает камеру (смотрите описание параметров для метода move)
moveToTarget
-
target
-
options
Метод поворачивает камеру к новой цели с сохранением расстояния до прежней цели, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
target
NumberНовая цель
-
options
ObjectДополнительные параметры:
- isRotate - истина, если перед перемещением необходимо повернуться в направлении к цели (по-умолчанию истина)
moveToTargetSilent
()
Метод перемещает камеру к новой цели с сохранением расстояния до прежней цели (смотрите описание параметров для метода moveToTargetSilent)
getDistance
-
pos
Метод возвращает расстояние камеры до цели
Parameters:
-
pos
NumberЦель (по-умолчанию точка наблюдения в сцене)
Returns:
Расстояние до цели
getDistanceToSphereBound
-
model
Метод возвращает расстояние до сферы вокруг модели
Parameters:
-
model
Site3dModelМодель
Returns:
Результат
getRot
()
Number
Метод возвращает состояние поворота камеры
Returns:
Состояние поворота
rot
()
Метод устанавливает состояние поворота камеры, запоминает предыдущее состояние и вызывает событие отрисовки (передаются углы поворота в виде трех параметров или массив углов)
rotSilent
()
Метод устанавливает состояние поворота камеры (передаются углы поворота в виде трех параметров или массив углов)
rotate
()
Метод поворачивает камеру, запоминает предыдущее состояние и вызывает событие отрисовки. Варианты параметров:
- pos – поворот камеры в направлении позиции pos
- pos, angle – поворот камеры вокруг позиции на угол angle
- stepX, stepY, stepZ, options – поворот камеры по трем осям, где options:
- isLocal – истина, если оси локальные (по умолчанию истина)
rotateSilent
()
Метод поворачивает камеру (смотрите описание параметров для метода rotate)
rotateLocal
-
stepX
-
stepY
-
stepZ
Метод поворачивает камеру вдоль локальных осей координат, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
stepX
NumberУгол поворота вдоль оси X
-
stepY
NumberУгол поворота вдоль оси Y
-
stepZ
NumberУгол поворота вдоль оси Z
rotateLocalSilent
()
Метод поворачивает камеру вдоль локальных осей координат (смотрите описание параметров для метода rotateLocal)
rotateWorld
-
stepX
-
stepY
-
stepZ
Метод поворачивает камеру вдоль глобальных осей координат, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
stepX
NumberУгол поворота вдоль оси X
-
stepY
NumberУгол поворота вдоль оси Y
-
stepZ
NumberУгол поворота вдоль оси Z
rotateWorldSilent
()
Метод поворачивает камеру вдоль глобальных осей координат (смотрите описание параметров для метода rotateWorld)
setPrev
()
Метод подсчитывает предыдущее положение камеры
Properties
type
String
Свойство возвращает тип камеры
options
Object
Свойство возвращает настройки камеры
size
Number
Свойство возвращает размер камеры
prevPos
Number
Свойство возвращает предыдущую позицию камеры
prevRot
Number
Свойство возвращает предыдущее состояние поворота камеры