op_tbl_pat_gain_ext()
摘要
从天线方向图模型获取天线方向图增益值以及附加信息。
语法
op_tbl_pat_gain_ext (pattern, polar, azimuth, extra_data_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
pattern |
Pattern_Handle |
方向图 [该值是指向天线方向图表的指针,可通过 op_tbl_pattern_get() 获取。] |
polar |
double |
目标方向的 polar 角 [该值的单位为度,应在 0 到 180 范围内。] |
azimuth |
double |
目标方向的 azimuth 角 [该值的单位为度,应在 0 到 360 范围内。] |
extra_data_ptr |
void * |
传递给外部库的附加用户自定义数据(参见详情)。 |
返回类型
double
与指定方向角对应的天线方向图增益值。
详情
该 KP 与 op_tbl_pat_gain() 类似,区别在于额外的 extra_data_ptr 参数会在 _gain 调用中传递给外部库(如果存在)。这为管道阶段或进程模型提供了一种机制,使其能够在获取增益值的同时从库中获取额外信息,例如极化值。调用方和库必须完全了解该额外参数的格式,因为库会将 void * 转换为它认为应有的数据类型。
用途
提供一种机制,将特定的天线方向转换为该方向对应的增益值。如果使用了外部库,它还可以提供附加信息。
错误
- 程序中止:段违例。(由于无效的表 ID)
参考
- 使用 KP op_tbl_pat_gain() 从天线方向图模型获取天线方向图增益值
- 使用 KP op_tbl_mod_ber() 在调制格式模型表中查找误码率(BER)值
- 使用 KP op_tbl_pattern_get() 获取天线方向图表指针(或者,将 op_td_get_ptr() 应用于 OPC_TDA_RA_RX_PATTERN 或 OPC_TDA_RA_TX_PATTERN 传输数据属性,也可获取天线方向图表指针)
- 将 KP op_td_set_dbl() 应用于 OPC_TDA_RA_RX_GAIN 或 OPC_TDA_RA_TX_GAIN 传输数据属性,将计算得到的增益值存入数据包的传输数据