SetAxisMotionProfileOverride

设定整个轴的超控值与所有执行在该轴的函式，此超控参数作为计算运动的指令速度、加速度和加加速度的一个因子。

语法

KsError SetAxisMotionProfileOverride(
     int Index,
     double VelocityFactor,
     double AccelerationFactor,
     double JerkFactor
);

参数

Index：轴的索引。索引以零为起点；别名将影响此参数。

VelocityFactor：速度的新超控因子。

AccelerationFactor：加速度或减速度的新超控因子。

JerkFactor：加加速度的新超控因子。

回传值

如果此函式执行成功，会回传 errNoError，否则会传回错误码。如需更多有关错误码的资讯，请参阅 KsError 清单。

备注

1. 此函式在不改变初始值的情况下改变速度与加速度，并在发送此函式后立即生效。当轴在运动状态下使用此函式，则当前的运动将会改变，为避免非预期的结果，建议在停止 (Standstill) 状态使用。
2. 输入 AccelerationFactor 作用于正负加速度（减速度）。
3. 使函式设定因子，此超控因子在设定新超控前皆有效。
4. 超控因子的预设值为 1.0。
5. 超控因子值可为 0.0 至 1.0 之间，值 > 1.0 为特定供应商之值、不可 < 0.0，而值 0.0 不允许设定在AccelerationFactor 与 JerkFactor。
6. 设置于 VelocityFactor 的 0.0 值能将轴在不走至停止模式状态下停止。
7. 超控不会作用于从轴（处于同步运动状态的轴）。
8. 此函式不影响轴的状态图。
9. VelocityFactor 可随时更改并直接作用于进行中的运动。
10. 在 "离散运动" 中减少 AccelerationFactor 和／或 JerkFactor 可造成速度超量－可能导致损坏。

范例

KsError nRet = SetAxisMotionProfileOverride(0, 1.1, 1.0, 1.0);

使用需求

参见

SetAxisMotionProfile