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