control元素官方说明文档

<control>

更新于2016.8.2 krpano 1.19 pr5
鼠标与键盘的控制设定。

注意 – 如果krpano viewer无法在viewer上使用鼠标滚轮(例如是滚动网页而不是对全景进行缩放),这时应该检查mwheel嵌入设置。


<control usercontrol=”all”
mouse=”drag”
touch=”drag”
dragrelative=”true”
draginertia=”0.1″
dragfriction=”0.9″
drag_oldmode=”false”
movetorelative=”true”
movetoaccelerate=”1.0″
movetospeed=”10.0″
movetofriction=”0.8″
movetoyfriction=”1.0″
keybaccelerate=”0.5″
keybspeed=”10.0″
keybfriction=”0.9″
keybinvert=”false”
keybfovchange=”0.75″
mousefovchange=”1.0″
fovspeed=”3.0″
fovfriction=”0.9″
zoomtocursor=”false”
zoomoutcursor=”true”
touchzoom=”true”
keycodesleft=”37″
keycodesright=”39″
keycodesup=”38″
keycodesdown=”40″
keycodesin=””
keycodesout=””
keydownrepeat=”true”
bouncinglimits=”false”
/>
属性名 变量全名 类型 默认值
usercontrol control.usercontrol String all
用户控制全景的模式:

  • all – 全部控制 – 鼠标、触屏以及键盘
  • mouse – 只能鼠标和触屏控制(无键盘)
  • keyb – 只能键盘控制(无鼠标和触屏)
  • off – 没有用户交互
属性名 变量全名 类型 默认值
touch
mouse
control.mouse
control.touch
String
String
drag
drag
设置鼠标和触屏设备控制的模式。可用的设置:

  • drag = 拖拽并沿着2D轴移动全景
  • drag3d = 自由轴的的3D拖拽模式 (仅Flash使用)
  • moveto = 点击并移动设定一个运动的矢量
属性名 变量全名 类型 默认值
dragrelative control.dragrelative Boolean true
  • true – (默认下)当启用时,将在拖拽控制的输入和全景浏览运动之间产生一种“相对”的投影关系。这使得加速度减少,但在更大的视场和使用鱼眼变形时给予了更佳的控制感。
  • false – 当屏蔽时,将在拖拽控制的输入和全景浏览运动之间产生一种“绝对”的投影关系,也就是说,从A点拖拽到B点时。浏览将严格遵循运动规律。

在较小的视场(例如放大),两种模式表现接近。

属性名 变量全名 类型 默认值
draginertia control.draginertia Number 1.0
拖拽控制的惯性。数字越大,则释放控制时浏览旋转的动量越小。
属性名 变量全名 类型 默认值
dragfriction control.dragfriction Number 0.9
拖拽控制模式的浏览旋转动量的摩擦力。数值越小,运动则越快停止。
属性名 变量全名(仅HTML5) 类型 默认值
drag_oldmode control.drag_oldmode Boolean false
在1.19中,拖拽控制的行为有轻微的改变。因为这样的改变,速度和动量也有一点不同。启用该设置,则使用旧模式。
属性名 变量全名 类型 默认值
movetorelative control.movetorelative Boolean true
  • true – (默认下)当启用时,将在移动控制的输入和全景浏览运动之间产生一种“相对”的投影关系。这使得加速度减少,但在更大的视场和使用鱼眼变形时给予了更佳的控制感。
  • false – 当屏蔽时,将在移动控制的输入和全景浏览运动之间产生一种“绝对”的投影关系。

在较小的视场(例如放大),两种模式表现接近。

属性名 变量全名 类型 默认值
movetoaccelerate control.movetoaccelerate Number 1.0
移动控制模式的移动加速度。数值越大,全景越快开始旋转。
属性名 变量全名 类型 默认值
movetospeed control.movetospeed Number 10.0
移动控制模式的最大旋转速度。
属性名 变量全名 类型 默认值
movetofriction control.movetofriction Number 0.8
移动控制模式的摩擦力。数值越小,运动越快停止
属性名 变量全名 类型 默认值
movetoyfriction control.movetoyfriction Number 1.0
对移动控制模式的垂直运动附加的摩擦力。数值低于1.0时,可使得垂直运动的响应不那么灵敏。
属性名 变量全名 类型 默认值
keybaccelerate control.keybaccelerate Number 0.5
键盘/按钮控制移动的加速度。
属性名 变量全名 类型 默认值
keybspeed control.keybspeed Number 10.0
键盘/按钮控制移动的最大移动速度。
属性名 变量全名 类型 默认值
keybfriction control.keybfriction Number 0.9
键盘/按钮控制移动的移动摩擦力。
属性名 变量全名 类型 默认值
keybfovchange control.keybfovchange Number 0.75
键盘/按钮缩放变化,以度数为单位(缩放灵敏度)。
属性名 变量全名 类型 默认值
keybinvert control.keybinvert Boolean false
反转键盘/按钮上下移动的功能。
属性名 变量全名 类型 默认值
mousefovchange control.mousefovchange Number 1.0
鼠标滚轮缩放变化,以度数为单位(相当于鼠标缩放灵敏度)。
属性名 变量全名 类型 默认值
fovspeed control.fovspeed Number 3.0
视角变化/缩放的最大速度。
属性名 变量全名 类型 默认值
fovfriction control.fovfriction Number 0.9
视角变化/缩放的摩擦力。
属性名 变量全名 类型 默认值
zoomtocursor control.zoomtocursor Boolean false
当启用鼠标滚轮缩放时,全景会缩放至鼠标指针的位置。
属性名 变量全名 类型 默认值
zoomoutcursor control.zoomoutcursor Boolean true
zoomtocursor和本设定启用时,用鼠标滚轮放大全景将会远离鼠标指针的位置。否则全景将会缩放远离屏幕中央。
属性名 变量全名 (仅HTML5使用 ) 类型 默认值
touchzoom control.touchzoom Boolean true
启用或关闭2指缩放手势。
属性名 变量全名 类型 默认值
keycodesleft control.keycodesleft String “37”
向左的键码,默认为37。
属性名 变量全名 类型 默认值
keycodesright control.keycodesright String “39”
向右的键码,默认为39。
属性名 变量全名 类型 默认值
keycodesup control.keycodesup String “38”
向上的键码,默认为38。
属性名 变量全名 类型 默认值
keycodesdown control.keycodesdown String “40”
向下的键码,默认为40。
属性名 变量全名 类型 默认值
keycodesin control.keycodesin String
放大的键码。

例子:允许通过Shift键、A键以及加号键进行放大。

keycodesin=”16,65,107″
属性名 变量全名 类型 默认值
keycodesout control.keycodesout String
缩小的键码。

例子:允许通过Ctrl键、Y/Z键以及减号键进行放大。

keycodesout=”17,89,90,109″
属性名 变量全名 类型 默认值
keydownrepeat control.keydownrepeat Boolean true
当某个键持续按下时,启用或屏蔽onkeydown事件的自动重复。自动重复的延迟和重复间隔取决于系统的键盘设置。
属性名 变量全名 (仅HTML5使用 ) 类型 默认值
bouncinglimits control.bouncinglimits Boolean false
当达到横摇或缩放限制时弹回(仅拖拽控制)。
ico-example 示例

使用拖拽模式:

<control mouse=”drag” touch=”drag” />


鼠标使用移动控制,触屏使用拖拽控制:

<control mouse=“moveto” touch=“drag” />


向鼠标指针缩放:

<control zoomtocursor=”true” />


允许通过键盘缩放:

<control keycodesin=”16,65,107″ keycodesout=”17,89,90,109″ />

在 “control元素官方说明文档” 上有 1 条评论

发表评论