SimGet
用於取得模擬器各種物件的屬性設定值。
格式
SimGet Object.Property, Var
SimGet Robot.Hand.Propoerty, Var
參數
- Object
- 表示用於讀取屬性值的物件名稱之字串變數
- Robot
- 表示有安裝夾具(以「Hand」指定)的機器人名稱之字串變數
- Hand
- 表示用於讀取屬性值的夾具名稱之字串變數
- Property
- 用於讀取數值的屬性名稱。屬性詳如後述。
- Var
- 表示傳回值的變數
說明
此命令用於取得模擬器各種物件的屬性設定值。
可透過指定如下所示的屬性,取得物件的設定值。
屬性 | 說明 | 單位 | 資料類型 | 傳回值 |
---|---|---|---|---|
PositionX | 取得X坐標位置 | 公釐(mm) | Double | |
PositionY | 取得Y坐標位置 | 公釐(mm) | Double | |
PositionZ | 取得Z坐標位置 | 公釐(mm) | Double | |
RotationX | 取得X軸旋轉角度 | 度(degree) | Double | |
RotationY | 取得Y軸旋轉角度 | 度(degree) | Double | |
RotationZ | 取得Z軸旋轉角度 | 度(degree) | Double | |
CollisionCheck | 取得碰撞檢測的啟用/停用 | - | Boolean | True或False |
CollisionCheckSelf | 取得機器人自我碰撞檢測的啟用/停用 | - | Boolean | True或False |
Visible | 取得顯示/隱藏的狀態 | - | Boolean | True或False |
Type | 用於取得物件類型 | - | Integer | Layout: 0 Part: 1 Mounted Device: 3 |
HalfSizeX | 取得BOX物件的X方向的長度 | 公釐(mm) | Double | |
HalfSizeY | 取得BOX物件的Y方向的長度 | 公釐(mm) | Double | |
HalfSizeZ | 取得BOX物件的Z方向的長度 | 公釐(mm) | Double | |
HalfSizeHeight | 取得Plane物件的長度 | 公釐(mm) | Double | |
HalfSizeWidth | 取得Plane物件的寬度 | 公釐(mm) | Double | |
PlaneType | 取得Plane物件的類型 | - | Integer | Horizontal: 0 Vertical: 1 |
Radius | 取得Sphere物件或Cylinder物件的半徑 | 公釐(mm) | Double | |
Height | 取得Cylinder物件的高度 | 公釐(mm) | Double | |
Name | 取得物件名稱 | String | ||
Color | 取得物件展現的顔色 | String | 顔色名稱或者16進位顔色代碼(ARGB) |
可透過下表所示的組合取得屬性。
屬性 | 物件 | |||||||
---|---|---|---|---|---|---|---|---|
Robot | Hand | Box | Sphere | Cylinder | Plane | CAD | Camera | |
PositionX | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
PositionY | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
PositionZ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
RotationX | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
RotationY | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
RotationZ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
CollisionCheck | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
CollisionCheckSelf | ○ | - | - | - | - | - | - | - |
Visible | - | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
Type | - | - | ○ | ○ | ○ | ○ | ○ | - |
HalfSizeX | - | - | ○ | - | - | - | - | - |
HalfSizeY | - | - | ○ | - | - | - | - | - |
HalfSizeZ | - | - | ○ | - | - | - | - | - |
HalfSizeHeight | - | - | - | - | - | ○ | - | - |
HalfSizeWidth | - | - | - | - | - | ○ | - | - |
PlaneType | - | - | - | - | - | ○ | - | - |
Radius | - | - | - | ○ | ○ | - | - | - |
Height | - | - | - | - | ○ | - | - | - |
Name | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
Color | - | - | ○ | ○ | ○ | ○ | - | - |
參照
SimSet
SimGet範例
'取得SBox_1物件的X坐標值
Double boxPosX
SimGet SBox_1.PositionX, boxPosX
'取得SBox_1物件的顯示/隱藏狀態
Boolean boxVisible
SimGet SBox_1.Visible, boxVisible
'取得SBox_1物件的類型
Integer boxType
SimGet SBox_1.Type, boxType