TmmT_Terrain_Reader_Load_Proc
注意: 需要 Terrain Modeling Module 功能
摘要
回调:用于加载指定的地形源。
语法
<terrain_reader_load_proc_name> (terrain_type, source_path, coverage_limit, extra_param_names, extra_param_values, extra_params)
| 参数 | 类型 | 说明 |
|---|---|---|
terrain_type |
struct TmmT_Terrain_Type * |
感兴趣的地形处理器 |
source_path |
const char * |
地形源文件或目录的路径 |
coverage_limit |
const TmmT_Bounds * |
(可选)矩形边界,超出该边界的地形源数据应被忽略;若无则为 OPC_NIL |
extra_param_names |
const char ** |
指向额外参数名称列表的指针 |
extra_param_values |
const char ** |
指向额外参数值列表的指针 |
n_extra_params |
int |
额外参数的数量 |
返回值
struct TmmT_Terrain_Source *
指向包含所请求地形数据的地形源对象的指针。
头文件
tmm.h
详情
该回调应分配一个地形源对象,供后续涉及该地形源的调用使用,并从地形源文件向其加载数据。它应在每个加载步骤后调用 TmmT_Catalog_Prepare_Step_Notify_Proc tmm_load_step_notify()(除非 TmmT_Terrain_Reader_Num_Source_Steps_Proc 返回 -1,此时无需调用)。
TmmT_Terrain_Source 对象通过 coverage_proc 和 elevation_proc 提供覆盖与高程数据,并在数据源经 unload_proc 卸载时被销毁。
struct TmmT_Terrain_Source
{
/*** User modifiable fields ***/
/* Your load_proc is intended to fill in these fields. */
void * global_state_ptr; /* user-defined */
} TmmT_Terrain_Source;
“额外参数”类参数表示在地形规范 XML 文件的 <custom-settings> 段中为该地形源定义的任何特殊参数。
用途
用于加载指定地形源的回调。