旋钮模块

角度单位为度。旋钮内部保存的是累计绝对角度(开启物理限位时按限位夹紧,可能超过 360);归一化角度把它折算到一圈内(0..360)。
操作说明
- 旋转:鼠标右键按住并且围绕旋钮拖动
- 配置模块:手持扳手对准模块右键 或者 蹲下+右键 可以打开模块配置界面,配置模块 ID、tooltip等属性
- 拆卸模块:手持扳手蹲下右键 可以拆卸模块
- 卡位:在配置界面中可以开启卡位功能,吸附到 设定角度 的 倍数角度 上
- 显示档位:在配置界面中可以开启显示档位功能,显示当前旋钮的 角度 / 设定的卡位角度
- 物理限位:在配置界面中可以开启物理限位功能,旋钮旋转到设定角度时会被夹紧,无法继续旋转
- 显示百分比:在配置界面中可以开启显示百分比功能,显示当前旋钮的 角度 / 设定的最大旋转角度 × 100
获取模块实例:
knob.getAngle()
返回当前角度(数字,0..360)。
knob.setAngle(angle)
设置角度(数字,度)。自动归一化到 0..360;开启卡位(detent)时会吸附到最近档位。
knob.getNormalizedAngle()
返回归一化角度(数字,度,0..360):绝对角度折算到一圈内。
knob.getAbsoluteAngle()
返回累计绝对角度(数字,度)。开启超过 360° 的物理限位时可能大于 360;未开启物理限位时反向旋转可能为负数。
knob.getRelativeDetent()
返回相对档位(整数):归一化角度 / 设定的卡位角度(四舍五入)。未开启卡位(自由旋转)时返回 0。
knob.getAbsoluteDetent()
返回绝对档位(整数):绝对角度 / 设定的卡位角度(四舍五入)。未开启卡位(自由旋转)时返回 0。
knob.getRelativePercent()
返回相对百分比(数字,0..100):归一化角度 / 设定的最大旋转角度 × 100。
knob.getAbsolutePercent()
返回绝对百分比(数字):绝对角度 / 设定的最大旋转角度 × 100。未开启物理限位时旋钮可转出设定范围,返回值可能超过 100 或为负数。