TmmT_Terrain_Reader_Init_Proc()
摘要
用于读取特定地形格式的代码库的入口点。
语法
tmm_terrain_handler (library_base_name)
| 参数 | 类型 | 说明 |
|---|---|---|
library_base_name |
const char * |
代码库源文件的名称,不含扩展名 |
返回值
TmmT_Terrain_Type *
指向新创建的、具有指定基础名称的 Terrain Handler(地形处理器)对象的指针。
头文件
tmm.h
示例
// Entry point for terrain reader
extern "C" {
DLLEXPORT TmmT_Terrain_Type *
tmm_terrain_handler (const char * library_base_name);
DLLEXPORT TmmT_Terrain_Type *
tmm_terrain_handler (const char * library_base_name)
{
FIN (tmm_terrain_handler);
TmmT_Terrain_Type * handler = new TmmT_Terrain_Type;
if (handler == VOSC_NIL)
{
Vos_Error_Print (VOSC_ERROR_RECOVER, “TMM”,
“Unable to allocate memory for terrain handler library: “,
library_base_name, VOSC_NIL);
FRET (VOSC_NIL);
}
handler->identifier = "<terrain_type_name>";
handler->is_file = 1;
hanlder->file_selections = “<file_suffix_string>”;
handler->load_proc = <load_proc>;
handler->num_source_steps_proc = <num_source_steps_proc>;
handler->coverage_proc = <coverage_proc>;
handler->elevation_proc = <elevation_proc>;
handler->resolution_proc = <resolution_proc>;
handler->elevation_profile_fill_proc = <elevation_profile_fill_proc>;
handler->unload_proc = <unload_proc>;
handler->exit_proc = <exit_proc>;
FRET (handler);
}
}
详情
该函数是用于访问自定义地形格式的函数库的入口点。它应为该地形格式分配一个新的 TmmT_Terrain_Type 对象,填充各个字段,并返回该对象。该对象的结构为
struct TmmT_Terrain_Type
{
TmmT_Terrain_Reader_Load_Proc load_proc;
TmmT_Terrain_Reader_Unload_Proc unload_proc;
TmmT_Terrain_Reader_Coverage_Proc coverage_proc;
TmmT_Terrain_Reader_Elevation_Proc elevation_proc;
TmmT_Terrain_Reader_Resolution_Proc resolution_proc;
TmmT_Terrain_Reader_Elevation_Profile_Fill_Proc elevation_profile_fill_proc;
TmmT_Terrain_Reader_Num_Source_Steps_Proc num_source_steps_proc;
TmmT_Terrain_Reader_Exit_Proc exit_proc;
const char * identifier;
int is_file;
const char * file_selections;
void * global_state_ptr;
} TmmT_Terrain_Type;
填充该对象的字段时,请注意:
- 只需定义预期会用到的过程。不需要的过程可以设置为
OPC_NIL。 identifier是在 GUI 菜单及内部用于表示该地形类型的字符串。例如:“OpenFlight”。is_file是一个布尔值,指示在浏览该类型地形数据时让用户选择单个文件还是文件目录。单个文件时设为 TRUE。file_selections是由分号分隔的描述名称与文件扩展名列表,对应受支持的地形数据源。仅当is_file为 TRUE 时使用。例如:“OpenFlight files (.flt);All files (.*)”。global_state_ptr指向可选的用户自定义状态信息。
用途
作为读取特定地形格式的代码库入口点的回调。