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 | 颜色名称或十六进制颜色代码(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