Site3dCamera Class
Класс камеры
Constructor
Item Index
Methods
Methods
setup
-
options
Метод настройки основных параметров камеры
Parameters:
-
optionsObjectПараметры камеры:
- 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:
-
posNumberПозиция
Returns:
Результат сравнения позиций
moveForward
-
step -
options
Метод перемещает камеру в направлении взгляда вдоль плоскости XZ, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
stepNumberШаг перемещения
-
optionsObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
moveForwardSilent
-
step -
options
Метод перемещает камеру в направлении взгляда вдоль плоскости XZ
Parameters:
-
stepNumberШаг перемещения
-
optionsObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
moveSideways
-
step -
options
Метод перемещает камеру боком, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
stepNumberШаг перемещения
-
optionsObjectПараметры:
- isControlTarget – истина, если нужно одновременно перемещать центр масштабирования и вращения (по умолчанию ложь)
moveSidewaysSilent
-
step -
options
Метод перемещает камеру боком
Parameters:
-
stepNumberШаг перемещения
-
optionsObjectПараметры:
- 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:
-
targetNumberНовая цель
-
optionsObjectДополнительные параметры:
- isRotate - истина, если перед перемещением необходимо повернуться в направлении к цели (по-умолчанию истина)
moveToTargetSilent
()
Метод перемещает камеру к новой цели с сохранением расстояния до прежней цели (смотрите описание параметров для метода moveToTargetSilent)
getDistance
-
pos
Метод возвращает расстояние камеры до цели
Parameters:
-
posNumberЦель (по-умолчанию точка наблюдения в сцене)
Returns:
Расстояние до цели
getDistanceToSphereBound
-
model
Метод возвращает расстояние до сферы вокруг модели
Parameters:
-
modelSite3dModelМодель
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:
-
stepXNumberУгол поворота вдоль оси X
-
stepYNumberУгол поворота вдоль оси Y
-
stepZNumberУгол поворота вдоль оси Z
rotateLocalSilent
()
Метод поворачивает камеру вдоль локальных осей координат (смотрите описание параметров для метода rotateLocal)
rotateWorld
-
stepX -
stepY -
stepZ
Метод поворачивает камеру вдоль глобальных осей координат, запоминает предыдущее состояние и вызывает событие отрисовки
Parameters:
-
stepXNumberУгол поворота вдоль оси X
-
stepYNumberУгол поворота вдоль оси Y
-
stepZNumberУгол поворота вдоль оси Z
rotateWorldSilent
()
Метод поворачивает камеру вдоль глобальных осей координат (смотрите описание параметров для метода rotateWorld)
setPrev
()
Метод подсчитывает предыдущее положение камеры
Properties
type
String
Свойство возвращает тип камеры
options
Object
Свойство возвращает настройки камеры
size
Number
Свойство возвращает размер камеры
prevPos
Number
Свойство возвращает предыдущую позицию камеры
prevRot
Number
Свойство возвращает предыдущее состояние поворота камеры
