F_CheckPos函數

註解
傳回指定位置是否已達到力覺動作限制物件中設定的觸發條件。

用途
F_CheckPos(Object [, Point1[, Point2]])

  • Object
    物件名稱
    物件指定為FMR(數值)或FMR(標籤)。

  • Point1
    顯示參考位置的端點資料、端點指定
    可忽略。

  • Point2
    顯示參考位置的端點資料、端點指定
    可忽略。

傳回數值

編號 常數 說明
0 False 未達到觸發條件
-1 True 已達到觸發條件

傳回指定位置是否已達到力覺動作限制物件中設定的觸發條件。

詳細說明
傳回指定位置是否已達到力覺動作限制物件中設定的觸發條件。使用本函數時,將以HoldTimeThresh為「0」來判定是否已達到觸發條件。
本函數的用途會依據TriggerMode屬性中指定的不同監控對象而異。
在TriggerMode指定FG_REL_COORD_SYS、FG_REL_TOOL、FG_REL_JOINT時
以Point1為基準,針對Point2的相對位置姿態或相對關節角度評估力覺動作限制的達成狀態。作為基準的Point1不可省略。省略時會發生錯誤。若省略Point2這個評估對象位置時,將以Point1為基準,針對目前位置(CurPos)相對位置姿態或相對關節角度評估力覺動作限制的達成狀態。

在TriggerMode指定FG_ABS_COORD_SYS、FG_REL_POINT、FG_ABS_JOINT時
將針對力覺動作限制物件中設定的座標系,評估Point1的位置姿態或關節角度的力覺動作限制達成狀態。不可指定Point2。指定時會發生錯誤。可省略作為評估對象的Point1。若省略Point1時,將針對力覺動作限制功能中設定的座標系,評估目前位置(CurPos)位置姿態或關節角度的力覺動作限制達成條件。

在TriggerMode指定FG_FRC_CORRECTION時
針對力控制功能的修正量,評估力覺動作限制的達成狀態。不需要Point1、Point2。指定時會發生錯誤。

使用範例
以下為顯示基礎座標系上機器人目前位置(CurPos)之Z坐標是否在指定範圍(-10~10)內的範例。若在指定範圍內,則顯示True(-1)。

Function F_CheckPosTest
  Print F_CheckPos(FMR1)
Fend

Function F_CheckPosTest
  FSet FMR1.TriggerMode, FG_ABS_COORD_SYS
    ' 設定為評價指定座標系中位置姿勢
  FSet FMR1.PosEnabled, False, False, True, False, False
    ' 僅啟用Z方向
  FSet FMR1.PosZ_Levels, -10, 10
    ' 將Z上下限閾值設定為-10~10mm
  FSet FMR1.PosZ_Polarity, FG_IN
    ' 將處於上下限閾值範圍內情況設定為達成條件
  FSet FMR1.RobotTool, FG_CURRENT_TOOL
    ' 設定於當前選定的工具為基準
  FSet FMR1.RobotLocal, 0
    ' 設定基本座標系為基準

  Print F_CheckPos(FMR1)
Fend

參考
TriggerMode, 力覺動作限制物件FMR#