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 指向可选的用户自定义状态信息。

用途

作为读取特定地形格式的代码库入口点的回调。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com