zh/option-gl/partial/view-control.md

#${prefix|default(‘#’)} viewControl(Object)

viewControl用于鼠标的旋转，缩放等视角控制。

##${prefix|default(‘#’)} projection(string) = ${defaultProjection|default(‘perspective’)}

投影方式，默认为透视投影'perspective'，也支持设置为正交投影'orthographic'。

##${prefix|default(‘#’)} autoRotate(boolean) = ${defaultAutoRotate|default(false)}

是否开启视角绕物体的自动旋转查看。

##${prefix|default(‘#’)} autoRotateDirection(string) = ${defaultAutoRotateDirection|default(‘cw’)}

物体自转的方向。默认是 'cw' 也就是从上往下看是顺时针方向，也可以取 'ccw'，既从上往下看为逆时针方向。

##${prefix|default(‘#’)} autoRotateSpeed(number) = ${defaultAutoRotateSpeed|default(10)}

物体自转的速度。单位为角度 / 秒，默认为10 ，也就是36秒转一圈。

##${prefix|default(‘#’)} autoRotateAfterStill(number) = ${defaultAutoRotateAfterStill|default(3)}

在鼠标静止操作后恢复自动旋转的时间间隔。在开启 autoRotate 后有效。

##${prefix|default(‘#’)} damping(number) = ${defaultDamping|default(0.8)}

鼠标进行旋转，缩放等操作时的迟滞因子，在大于 0 的时候鼠标在停止操作后，视角仍会因为一定的惯性继续运动（旋转和缩放）。

##${prefix|default(‘#’)} rotateSensitivity(number|Array) = ${defaultRotateSensitivity|default(1)}

旋转操作的灵敏度，值越大越灵敏。支持使用数组分别设置横向和纵向的旋转灵敏度。

默认为${defaultRotateSensitivity | default(1)}。

设置为0后无法旋转。

// 无法旋转
rotateSensitivity: 0
// 只能横向旋转
rotateSensitivity: [1, 0]
// 只能纵向旋转
rotateSensitivity: [0, 1]

##${prefix|default(‘#’)} zoomSensitivity(number) = ${defaultZoomSensitivity|default(1)}

缩放操作的灵敏度，值越大越灵敏。默认为${defaultRotateSensitivity | default(1)}。

设置为0后无法缩放。

##${prefix|default(‘#’)} panSensitivity(number) = ${defaultPanSensitivity|default(1)}

平移操作的灵敏度，值越大越灵敏。支持使用数组分别设置横向和纵向的平移灵敏度

默认为${defaultRotateSensitivity | default(1)}。

设置为0后无法平移。

##${prefix|default(‘#’)} panMouseButton(string) = ${defaultPanMouseButton|default(‘left’)}

平移操作使用的鼠标按键，支持：

'left' 鼠标左键（默认）
'middle' 鼠标中键
'right' 鼠标右键

注意：如果设置为鼠标右键则会阻止默认的右键菜单。

##${prefix|default(‘#’)} rotateMouseButton(string) = ${defaultRotateMouseButton|default(‘middle’)}

旋转操作使用的鼠标按键，支持：

'left' 鼠标左键
'middle' 鼠标中键（默认）
'right' 鼠标右键

注意：如果设置为鼠标右键则会阻止默认的右键菜单。

##${prefix|default(‘#’)} distance(number) = ${defaultDistance|default(150)}

默认视角距离主体的距离，对于 globe 来说是距离地球表面的距离，对于 grid3D 和 geo3D 等其它组件来说是距离中心原点的距离。在 projection 为'perspective'的时候有效。

##${prefix|default(‘#’)} minDistance(number) = ${defaultMinDistance|default(40)}

视角通过鼠标控制能拉近到主体的最小距离。在 projection 为'perspective'的时候有效。

##${prefix|default(‘#’)} maxDistance(number) = ${defaultMaxDistance|default(400)}

视角通过鼠标控制能拉远到主体的最大距离。在 projection 为'perspective'的时候有效。

##${prefix|default(‘#’)} orthographicSize(number) = ${defaultDistance|default(150)}

正交投影的大小。在 projection 为'orthographic'的时候有效。

##${prefix|default(‘#’)} maxOrthographicSize(number) = ${defaultMinDistance|default(20)}

正交投影缩放的最大值。在 projection 为'orthographic'的时候有效。

##${prefix|default(‘#’)} minOrthographicSize(number) = ${defaultMaxDistance|default(400)}

正交投影缩放的最小值。在 projection 为'orthographic'的时候有效。

##${prefix|default(‘#’)} alpha(number) = ${defaultAlpha|default(0)}

视角绕 x 轴，即上下旋转的角度。配合 beta 可以控制视角的方向。

如下示意图：

##${prefix|default(‘#’)} beta(number) = ${defaultBeta|default(0)}

视角绕 y 轴，即左右旋转的角度。

##${prefix|default(‘#’)} center(Array) = ${defaultCenter}

视角中心点，旋转也会围绕这个中心点旋转，默认为[0,0,0]。

##${prefix|default(‘#’)} minAlpha(number) = ${defaultMinAlpha|default(-90)}

上下旋转的最小 alpha 值。即视角能旋转到达最上面的角度。

##${prefix|default(‘#’)} maxAlpha(number) = ${defaultMaxAlpha|default(90)}

上下旋转的最大 alpha 值。即视角能旋转到达最下面的角度。

##${prefix|default(‘#’)} minBeta(number) = ${defaultMinBeta|default(-Infinity)}

左右旋转的最小 beta 值。即视角能旋转到达最左的角度。

##${prefix|default(‘#’)} maxBeta(number) = ${defaultMaxBeta|default(Infinity)}

左右旋转的最大 beta 值。即视角能旋转到达最右的角度。

{{ use: partial-animation( prefix=“##”, defaultAnimationEasingUpdate=“cubicInOut”, defaultAnimationDurationUpdate=1000 ) }}