IG应用模板

Unigine IG使用内插快照（IS）解决IG与主机之间的数据包丢失的问题。它通过采取两个旧的但已知的位置并在它们之间插入对象来工作。通过缓冲接收到的位置和旋转以及它们代表的时间来实现。通常，我们将当前本地时间减去一些预定义的时间-插值周期（默认为 40 ms），然后进入缓冲区，找到之前和之后的两个索引在这段时间之后进行插值。

如果我们在寻找的时间内没有收到位置和旋转信息，则使用外推（猜测）。它也有时间限制-外推期（默认为 200 ms）。如果推断期已结束，但仍未收到任何数据包，则所有对象将冻结。

在大多数情况下，此方法为每个从属设备提供了非常准确的世界表示，因为通常只渲染远程对象的已知位置，在极少数情况下，系统会尝试推断（猜测）对象所在的位置。但是，这是有代价的，因为我们总是在当前时间之后渲染 40 毫秒（插值周期），以便新数据包有时间到达数据。

• IG插件API 部分提供了有关通过代码（C ++）管理IG的更多详细信息。
• 设置属性文章，为调整新实体的属性提供了更多详细信息。
• IG配置文章，提供有关设置IG的更多详细信息。
• 环境设置文章提供了有关配置天空和天气参数的更多详细信息。

连接器实际上是一个自定义的 C ++插件，用于在主机和IG之间传递消息。该插件读取包并调用 IG插件（在 include / plugins / UnigineIG.h 中列出）的相应方法。

下面列出的文件可用作您的自定义连接器的模板：

• 插件包含文件放入include/plugins文件夹：

  CUSTOMConnectorInterface.h

  源代码 (C++)

  #ifndef __CUSTOM_CONNECTOR_INTERFACE_H__
  #define __CUSTOM_CONNECTOR_INTERFACE_H__
  
  namespace IG
  {
  	namespace CUSTOM
  	{
  		class ConnectorInterface
  		{
  		public:
  			virtual ~ConnectorInterface() {}
  			
  			// client initialization
  			virtual int init(/*initialization parameters*/) = 0;
  			// client shutdown
  			virtual int shutdown() = 0;
  			
  			// other methods
  			// ...
  			
  			// callbacks
  			//virtual void setConnectCallback(Unigine::CallbackBase* func) = 0;
  			//virtual Unigine::CallbackBase* getConnectCallback() const = 0;
  			// ...
  		};
  	}
  }
  
  #endif /* __CUSTOM_CONNECTOR_INTERFACE_H__ */

• 要放入source/custom_connector文件夹的插件源文件：

  CUSTOMConnectorPlugin.cpp

  源代码 (C++)

  #include <UniginePlugin.h>
  
  #include "CUSTOMConnector.h"
  #include "CUSTOMConnectorInterpreter.h"
  
  using namespace Unigine;
  
  //////////////////////////////////////////////////////////////////////////
  // CUSTOMConnectorPlugin
  //////////////////////////////////////////////////////////////////////////
  
  class CUSTOMConnectorPlugin : public Plugin
  {
  public:
  	CUSTOMConnectorPlugin();
  	virtual ~CUSTOMConnectorPlugin();
  
  	const char *get_name() override;
  	void *get_data() override;
  
  	int init() override;
  	int shutdown() override;
  	void update() override;
  
  private:
  	IG::CUSTOM::Connector *connector;
  };
  
  CUSTOMConnectorPlugin::CUSTOMConnectorPlugin()
  	: connector(nullptr)
  {
  }
  
  CUSTOMConnectorPlugin::~CUSTOMConnectorPlugin()
  {
  	CUSTOMConnectorInterpreterShutdown();
  	delete connector;
  }
  
  const char *CUSTOMConnectorPlugin::get_name()
  {
  	return "CUSTOMConnector";
  }
  
  void *CUSTOMConnectorPlugin::get_data()
  {
  	return static_cast<IG::CUSTOM::ConnectorInterface *>(connector);
  }
  
  int CUSTOMConnectorPlugin::init()
  {
  	connector = new IG::CUSTOM::Connector();
  	connector->init();
  	CUSTOMConnectorInterpreterInit();
  	return 1;
  }
  
  int CUSTOMConnectorPlugin::shutdown()
  {
  	connector->shutdown();
  	return 1;
  }
  
  void CUSTOMConnectorPlugin::update()
  {
  	connector->update();
  }
  
  //////////////////////////////////////////////////////////////////////////
  // Plugin export
  //////////////////////////////////////////////////////////////////////////
  
  extern "C" UNIGINE_EXPORT void *CreatePlugin()
  {
  	return new CUSTOMConnectorPlugin();
  }
  
  extern "C" UNIGINE_EXPORT void ReleasePlugin(void *plugin)
  {
  	delete static_cast<CUSTOMConnectorPlugin *>(plugin);
  }

  CUSTOMConnector.h

  源代码 (C++)

  #ifndef __CUSTOM_CONNECTOR_H__
  #define __CUSTOM_CONNECTOR_H__
  
  #include <plugins/CUSTOMConnectorInterface.h>
  #include <plugins/UnigineIG.h>
  #include <UnigineInterface.h>
  #include <UnigineLogic.h>
  
  namespace IG
  {
  namespace CUSTOM
  {
  	class CUSTOMWorldLogic;
  
  	class Connector : public ConnectorInterface
  	{
  	public:
  		Connector();
  		virtual ~Connector() {}
  		// singleton
  		static Connector *get() 
  		{
  			if (connector == nullptr)
  				Log::fatal("%s:: CUSTOM connector is NULL\n", __FUNCTION__);
  			return connector;
  		};
  
  		// automatic initialization on plugin load
  		void init();		
  
  		// update/shutdown client
  		void update();
  		void shutdown();
  		
  		// methods to be called by the CUSTOMWorldLogic class at the corresponding stages of the execution sequence
  		void onWorldInit();
  		void onWorldShutdown();
  	private:
  		static Connector *connector;
  		IG::Manager *ig_manager = nullptr;
  		CUSTOMWorldLogic *world_logic;
  	};
  	
  	// WorldLogic class
  	class CUSTOMWorldLogic : public Unigine::WorldLogic
  	{
  	public:
  		CUSTOMWorldLogic() {}
  		virtual ~CUSTOMWorldLogic() {}
  
  		virtual UNIGINE_INLINE int init() override { Connector::get()->onWorldInit(); return 1; }
  		virtual UNIGINE_INLINE int shutdown() override { Connector::get()->onWorldShutdown(); return 1; }
  	};
  }
  }
  
  #endif /* __CUSTOM_CONNECTOR_H__ */

  CUSTOMConnector.cpp

  源代码 (C++)

  #include "CUSTOMConnector.h"
  #include <UnigineEngine.h>
  #include <UnigineNode.h>
  
  using namespace Unigine;
  using namespace Math;
  using namespace IG;
  using namespace CUSTOM;
  
  Connector::Connector() {
  	world_logic = new CUSTOMWorldLogic();
  	Engine::get()->addWorldLogic(world_logic);
  }
  
  void Connector::init()
  {
  	const auto host = "127.0.0.1";
  	const auto port = 3000;
  	
  	int ig_plugin_index = Engine::get()->findPlugin("IG");
  	if (ig_plugin_index == -1)
  	{
  		Log::error("IG::CUSTOM::Connector::init(): IG plugin isn't loaded\n");
  		return;
  	}
  	ig_manager = (IG::Manager*)Engine::get()->getPluginData(ig_plugin_index);
  	
  	// IG setup
  	ig_manager->setCoordinateSystem(IG::Manager::COORDINATE_SYSTEM::NED);
  	
  }
  
  void Connector::update()
  {
  	// read & write packets
  }
  
  void Connector::shutdown() 
  {
  	// shutdown client
  	shutdown();
  	
  	// clear static link
  	connector = nullptr;
  	
  	// ...
  }
  
  void Connector::onWorldInit() 
  {
  	// actions to be performed when a new world is loaded
  }
  
  void Connector::onWorldShutdown() 
  {
  	// actions to be performed when current world is closed
  }

  CUSTOMConnectorInterpreter.h

  源代码 (C++)

  #ifndef __CUSTOM_CONNECTOR_INTERPRETER_H__
  #define __CUSTOM_CONNECTOR_INTERPRETER_H__
  
  #include <UnigineBase.h>
  
  void CUSTOMConnectorInterpreterInit();
  void CUSTOMConnectorInterpreterShutdown();
  
  #endif /* __CUSTOM_CONNECTOR_INTERPRETER_H__ */

  CUSTOMConnectorInterpreter.cpp

  源代码 (C++)

  #include <UnigineEngine.h>
  #include <UnigineInterface.h>
  
  #include <plugins/CUSTOMConnectorInterface.h>
  #include "CUSTOMConnector.h"
  
  using namespace Unigine;
  using namespace IG;
  
  void CUSTOMConnectorInterpreterInit()
  {
  	int id = Interpreter::addGroup("CUSTOMConnectorInterpreter");
  
  	// defines
  	Interpreter::addExternDefine("HAS_CUSTOM_CONNECTOR", id);
  
  	// enums
  	// Interpreter::addExternVariable("CUSTOM_VERSION_10", MakeExternConstant<int>(CUSTOM_VERSION_10), id);
  
  	// functions
  	Connector *connector = Connector::get();
  	Interpreter::addExternLibrary("engine.custom", id);
  	//Interpreter::addExternFunction("engine.custom.init", MakeExternObjectFunction(connector, &Connector::init), id);
  	//Interpreter::addExternFunction("engine.custom.shutdown", MakeExternObjectFunction(connector, &Connector::shutdown), id);
  }
  
  void CUSTOMConnectorInterpreterShutdown()
  {
  	Interpreter::removeGroup("CUSTOMConnectorInterpreter");
  }

  CUSTOMConnectorWrapper.cpp

  源代码 (C++)

  //push ignore deprecated warnings
  #ifdef __GNUC__
  #pragma GCC diagnostic push
  #pragma GCC diagnostic ignored "-Wdeprecated-declarations"
  #elif defined(_MSC_VER)
  #pragma warning(push)
  #pragma warning(disable: 4996)
  #endif
  
  #include <UnigineEngine.h>
  #include <plugins/CUSTOMConnectorInterface.h>
  
  using namespace Unigine;
  
  extern "C" 
  {
  	//UNIGINE_EXPORT void CUSTOMConnector_method(CUSTOMConnector *self) { if (self) self->method(); }
  }
  
  //pop ignore deprecated warnings
  #ifdef __GNUC__
  #pragma GCC diagnostic pop
  #elif defined(_MSC_VER)
  #pragma warning(pop)
  #endif