op_ima_obj_pos_query_proc_set()
摘要
为一个不沿轨迹或矢量运动的移动站点设置一个用于返回其位置的回调。
语法
op_ima_obj_pos_query_proc_set (site_objid, callback, state_ptr, lat_long_unit)
| 参数 | 类型 | 说明 |
|---|---|---|
site_objid |
Objid |
关注站点的对象 ID(节点或子网) [站点对象 ID 可以从 Id 和 Topo 包中的多个 KP 获得: op_topo_parent()、op_topo_child()、op_id_from_userid() 和 op_id_from_name()。] |
callback |
SimT_Ima_Obj_Position_Query_Proc |
每当需要目标对象的位置时被调用的过程 |
state_ptr |
void* |
传递给回调过程的用户自定义数据 |
lat_long_unit |
OpT_Ima_Obj_Position_Unit_Type |
纬度和经度值所使用的单位类型(取表 68 “Object Position Unit Type Symbolic Constants”第 19 页中给出的值之一) [对于给定站点,这在仿真过程中不能改变。] |
返回类型
Compcode
发生错误时为 OPC_COMPCODE_FAILURE(参见错误一节);否则为 OPC_COMPCODE_SUCCESS。
示例
void straight_line_ascend (SimT_Objid site_id, void * state_ptr,
double prev_time, double prev_latitude, double prev_longitude,
double prev_altitude, double cur_time, double * lat_ptr,
double * long_ptr, double * alt_in_meters_ptr)
{
/* increase altitude 1 meter/second */
*alt_in_meters_ptr = prev_altitude + (cur_time-prev_time) * 1.0;
*lat_ptr = prev_latitude;
*long_ptr = prev_longitude;
}
[...]
op_ima_obj_pos_query_proc_set (mobile_node_id, straight_line_ascend,
OPC_NIL, OpC_Ima_Obj_Position_Unit_Kilometers);
详情
callback 是一个自定义过程,它根据所请求的时刻以及站点先前的位置和时间,为站点计算新的三维位置。回调的原型为:
typedef void
(*SimT_Ima_Obj_Position_Query_Proc)(SimT_Objid site_id,
void * state_ptr, double prev_time, double prev_latitude,
double prev_longitude, double prev_altitude_in_meters,
double request_time, double * lat_ptr, double * long_ptr,
double * alt_in_meters_ptr);
request_time 将是当前仿真时刻或某个未来时刻。纬度和经度以注册回调时 lat_long_unit 参数指定的单位给出(并且必须以该单位返回)。计算得到的位置应通过 lat_ptr、long_ptr 和 alt_in_meters_ptr 所指向的存储区域返回。
注意: 当仿真内核调用此回调时,传递给回调的先前时刻和位置值不一定对应于上一次调用。由于仿真内核仅在计算对象的当前位置时缓存返回的值,因此先前的值实际上对应于 request_time 为当时当前仿真时刻的那一次调用。
警告: 不要在回调内部使用 op_ima_obj_pos_get() 或 op_ima_obj_attr_get() 获取站点的当前位置,否则将导致无限循环。
将 callback 设置为 OPC_NIL 指针将使仿真内核停止调用回调(在这种情况下,内核将直接使用节点的当前位置)。
用途
通常,对于不沿轨迹或矢量运动的节点,仿真内核使用最后设置的位置。本 KP 为特定的移动站点(节点或子网)注册一个回调,使仿真内核能够在需要时获得精确的位置。
错误
- 可恢复错误:对象 ID(
<site_objid>)超出范围。 - 可恢复错误:对象 ID(
<site_objid>)指向受限对象。 - 可恢复错误:无法为对象(
<site_objid>)设置位置查询回调,因为它不是移动节点或子网(对象类型为<type_name>) - 可恢复错误:无法为对象(
<site_objid>)设置位置查询回调,因为它使用轨迹 - 可恢复错误:无法为对象(
<site_objid>)设置位置查询回调,因为单位参数无效(<lat_long_unit>)
参考
- 使用 KP op_ima_obj_pos_get() 可获取站点的全局位置相关属性。
- 使用 KP op_ima_obj_attr_get_dbl() 可获取站点的单个位置相关属性。