op_ima_obj_pos_set_geocentric()
摘要
在地心坐标系中设置移动站点的位置。
语法
op_ima_obj_pos_set_geocentric (objid, x, y, z)
| 参数 | 类型 | 说明 |
|---|---|---|
objid |
Objid |
目标移动站点的对象 ID(节点或子网) [站点对象 ID 可以从 Id 和 Topo 包中的多个 KP 获得: op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
x |
double |
为站点设置的笛卡尔 X 坐标 |
y |
double |
为站点设置的笛卡尔 Y 坐标 |
z |
double |
为站点设置的笛卡尔 Z 坐标 |
返回类型
Compcode
发生错误时为 OPC_COMPCODE_FAILURE(参见错误一节);否则为 OPC_COMPCODE_SUCCESS。
示例
obj_type = op_id_to_type (mob_site_id);
if (obj_type == OPC_OBJTYPE_NODE_MOB || obj_type == OPC_OBJTYPE_SUBNET_MOB)
{
op_ima_obj_pos_set_geocentric (mob_site_id, new_x, new_y, new_z);
}
详情
本 KP 设置的站点位置以地心笛卡尔坐标系 {X / Y / Z} 表示。该坐标系中三个坐标的单位均为米。关于该坐标系的说明见“Geocentric Coordinate System“第 317 页。
由 objid 指定的移动站点不得使用其他位置指定方式,例如:
- 轨迹
- 查询过程(由 op_ima_obj_pos_query_proc_set() 设置)
- 随机移动
用途
本函数提供了一种通过在地心坐标系中指定坐标来设置移动节点或子网位置的方法。
错误
- 可恢复错误:对象 ID(
<objid>)超出范围。 - 可恢复错误:对象 ID(
<objid>)指向受限对象。 - 可恢复错误:无法为对象(
<objid>)设置地心位置;它不是移动节点或子网(对象类型为<obj_type>)。 - 可恢复错误:无法为对象(
<objid>)设置地心位置;它使用轨迹。 - 可恢复错误:无法为对象(
<objid>)设置地心位置;其位置由查询回调定义。