Camera3D

类：3D场景相机

Glodon.Bimface.Camera.Camera3D

Methods

clearCameraAnimation()

清除相机动画，清除后可更改相机状态

enablePan(enabled)

设置禁用/启用平移

Parameters:

Name	Type	Description
enabled	Boolean	是否允许场景平移，默认为true

enablePitch(enabled)

设置禁用/启用俯仰

Parameters:

Name	Type	Description
enabled	Boolean	是否允许场景俯仰，默认为true

enableRotate(enabled)

设置禁用/启用旋转

Parameters:

Name	Type	Description
enabled	Boolean	是否允许场景旋转，默认为true

enableZoom(enabled)

设置禁用/启用缩放

Parameters:

Name	Type	Description
enabled	Boolean	是否允许场景缩放，默认为true

getCameraAnimation()

获取相机动画

getCurrentRange()

获取相机最大活动范围

Returns:

Type	Description
Number	相机最大活动范围参数

getObjectOffset()

获取场景浏览时camera距离构件可达到的最小距离，单位为mm

Returns:

Type	Description
Number	相机距离构件可达到的最小距离

getRotateSensitivity()

获取鼠标旋转的速度

Returns:

Type	Description
Number	鼠标旋转速度

getStatus()

获取当前相机位置信息，用于保存后恢复相机视点

Returns:

Type	Description
Object	相机位置信息

getZoomSpeed()

获取场景浏览时缩放的速度

Returns:

Type	Description
Number	相机缩放速度

lockAxis(axis, range)

锁定相机绕轴旋转范围

Parameters:

Name	Type	Description
axis	Glodon.Bimface.Viewer.AxisOption	暂支持Z轴，Glodon.Bimface.Viewer.AxisOption.Z
range	Array	相机沿轴转动时可变化的范围，如[Math.PI / 6, Math.PI / 3]，不填则为禁止绕该轴旋转

setCameraAnimation(option)

设置相机动画，可与路径动画绑定。绑定后不可更改相机状态。

Parameters:

Name	Type	Description
option	Object	相机动画参数
pathAnimation	Glodon.Bimface.Plugins.Animation.PathAnimation	相机待绑定的路径动画对象,必填
distance	Number	相机位置与路径动画的空间距离，默认为5000mm， 单位为mm
angle	Number	相机角度，单位为弧度，范围在[-π,π]，默认为0，即相机跟随在路径动画后方平视。当相机处于路径动画上方时，角度为负；相机处于路径动画下方时，角度为正。

setCameraType(cameraType, fov)

设置相机类型

Parameters:

Name	Type	Description
cameraType	String	相机类型，"OrthographicCamera" 正交相机，"PerspectiveCamera" 透视相机
fov	Number	相机视锥体垂直视角（即从下到上的观察角度），仅在透视相机中使用，取值范围为[10, 180]

setMaximalRange(far)

限制相机最大活动范围

Parameters:

Name	Type	Description
far	Number	相机与模型最远距离参数，范围(0, ∞)，默认值为2

setObjectOffset(offset)

场景浏览时camera距离构件可达到的最小距离，超过即穿过构件

Parameters:

Name	Type	Description
offset	Number	相机距离构件可达到的最小距离，默认500mm

setRotateSensitivity(ratio)

调整鼠标旋转的灵敏度

Parameters:

Name	Type	Description
ratio	Number	鼠标旋转速度

setStatus(camera, callback)

根据相机位置信息恢复视点

Parameters:

Name	Type	Description
camera	Object	相机状态，getCameraStatus()返回的对象
callback	Function	相机还原之后回调函数，可不写

setZoomSpeed(zoomSpeed)

场景浏览时缩放的速度定义，范围为[0,1]

Parameters:

Name	Type	Description
zoomSpeed	Number	相机缩放速度，PC端默认为0.5，移动端小场景默认为0.24，大场景为0.30

unlockAxis(axis)

取消相机绕轴旋转限制

Parameters:

Name	Type	Description
axis	Glodon.Bimface.Viewer.AxisOption	暂支持Z轴，Glodon.Bimface.Viewer.AxisOption.Z

zoomToBoundingBox(option, callback)

缩放至指定包围盒

Parameters:

Name	Type	Description
option	Object	缩放设置
boundingBox	Object	包围盒信息
margin	Number	包围盒缩放比例，默认值为0.5，margin > 0 模型缩小（包围盒变大），margin < 0 模型放大（包围盒变小）,margin最小取值不低于-1
duration	Number	动画持续时间，单位为毫秒， 默认值为1000
direction	Object	观察方向，相机看向包围盒中心点的方向，可不填。例{x:0,y:0,z:-1}表示俯视方向
callback	Function	缩放完成时的回调函数，可不填写