連結軸並開始凸輪運動。
命名空間：IntervalZero.KINGSTAR.Base.Api組合： IntervalZero.KINGSTAR.Base.Api (於 IntervalZero.KINGSTAR.Base.dll) 版本：4.4.0.0
語法
KsCommandStatus SetAxisCam(
int Master,
int Slave,
bool Permanent,
double MasterOffset,
double SlaveOffset,
double MasterScaling,
double SlaveScaling,
McCamStartMode StartMode,
double StartParameter,
McSource MasterValueSource,
int Cam,
McBufferMode BufferMode
)Function SetAxisCam(
Master As Integer,
Slave As Integer,
Permanent As Boolean,
MasterOffset As Double,
SlaveOffset As Double,
MasterScaling As Double,
SlaveScaling As Double,
StartMode As McCamStartMode,
StartParameter As Double,
MasterValueSource As McSource,
Cam As Integer,
BufferMode As McBufferMode
) As KsCommandStatus參數
Master [in]
型別：int
主軸的索引。索引以 0 為起始；別名將影響此參數。
Slave [in]
型別：int
從軸的索引。索引以 0 為起始；別名將影響此參數。從軸數量最多為 32。
Permanent [in]
型別：bool
決定馬達停用後是否保留凸輪狀態。
true：即使馬達停用仍保留凸輪狀態，例如當主軸啟用時從軸也會跟著啟用，而當主軸發生錯誤從軸也會發生錯誤。
false：馬達停用後不會保留凸輪狀態。
MasterOffset [in]
型別：double
凸輪表中主軸位置的偏移量。
SlaveOffset [in]
型別：double
凸輪表中從軸位置的偏移量。
MasterScaling [in]
型別：double
主軸設定檔因子（預設值 = 1.0），以從軸的角度來看，整個主軸設定檔會被乘以這個因子。
SlaveScaling [in]
型別：double
從軸設定檔因子（預設值 = 1.0），整個從軸設定檔會被乘以這個因子。
StartMode [in]
軸所使用的凸輪模式。
StartParameter [in]
型別：double
依照所選的起始斜坡而定，若為 camRampDistance，StartParameter 即為從軸移動的距離，單位為計數；若為 camRampTime，StartParameter 即為從軸移動的時間，單位為秒。該參數使用主軸的資訊來決定如何移動從軸，而距離取決於主軸移動的距離。
MasterValueSource [in]
型別：McSource
定義同步的來源。
- mcSetValue – 同步主軸設定值，建議使用此設定。
- mcActualValue – 同步主軸實際值，此設定可能不穩定。
- mcSecondEncoderValue – 軸的第二編碼器的實際值。
注意：尚未支援 mcSecondEncoderValue。
Cam [in]
型別：int
凸輪表的索引，連結到 SetCamTable 的輸出。
BufferMode [in]
型別：McBufferMode
定義如何融合兩方法的速度。
回傳值
回傳 KsCommandStatus 類別。
備註
- 這種方法未與 SetCamTable 合併，因為這種分離可以實現即時更改。
- 機械類比之於從軸偏移就好比在凸輪上焊了一層額外的恆定厚度，因此，從軸位置具有一個恆定的偏移量，若採用線性導向從動件，則該偏移量可表示主軸的軸偏移量。
- 欲分離從軸，請使用 ReleaseAxis。
- 當模數軸啟用時，SetAxisCam 將不受影響，該軸不會將凸輪表中的位置視為模數位置。例如，假設主軸與從軸同步運行，且兩者的模數值皆設定為 360。在凸輪表中，下一個 MasterPosition 和 SlavePosition 分別設定為 360 和 540。在此情況下，主軸將旋轉 1 圈，而從軸將旋轉 1.5 圈，以達到設定的位置。啟用模數軸後，建議使用者：
- 使用 SetAxisPositionOffset 重設位置，以防止顯示位置與內部位置不一致。例如，當模數值設為 360 時，使用者可能會看到位置為 0，而內部位置為 360000。
- 使用速度或距離 API 來移動主軸。
範例
N/A參見