Unigine::NodeExtern Class

A custom user-defined node is created as follows:

1. Inherit a custom node class from NodeExternBase:
   Копировать Source code (C++)

   #include <UnigineNodes.h>
   
   using namespace Unigine;
   
   // inherit a custom class from NodeExternBase
   class MyNode : public NodeExternBase
   {
   };

2. Implement logic of the custom node and register the class via NodeExternBase::addClassID():
   Notice

   The custom node class isn't a node, as the NodeExternBase class isn't inherited from the Node class.
   Копировать Source code (C++)

   #include <UnigineNodes.h>
   #include <UnigineEngine.h>
   #include "AppSystemLogic.h"
   #include "AppWorldLogic.h"
   #include "AppEditorLogic.h"
   
   using namespace Unigine;
   
   // inherit a custom class from NodeExternBase
   class MyNode : public NodeExternBase
   {
   public:
   
   	// constructors
   	MyNode(){}
   	MyNode(void *node) : NodeExternBase(node){}
   	// destructor
   	virtual ~MyNode(){}
   
   	// unique class ID
   	virtual int getClassID() {return 1;}
   
   	// set world transformation of the node
   	void setWorldTransform(const UNIGINE_MAT4 &transform) {getNode()->setWorldTransform(transform);}
   
   	// other methods
   	// ...
   };
   
   int main(int argc,char *argv[]) {
   
   	// register the MyNode class
   	NodeExternBase::addClassID<MyNode>(1);
   
   	Unigine::EnginePtr engine(UNIGINE_VERSION,argc,argv);
   
   	AppSystemLogic system_logic;
   	AppWorldLogic world_logic;
   	AppEditorLogic editor_logic;
   
   	engine->main(&system_logic,&world_logic,&editor_logic);
   
   	return 0;
   }

   If required, the custom node class can be exported to UnigineScript.
3. Create a custom node in one of the following ways:
   Копировать Source code (C++)

   // create a MyNode pointer directly: a NodeExtern node will be created as well
   MyNode *my_node_0 = new MyNode();
   // obtain the NodeExtern node
   my_node_0->getNodeExtern();
   
   // create a NodeExtern instance by MyNode's class ID
   NodeExternPtr my_node_1 = NodeExtern::create(1);
   // obtain the MyNode pointer if required
   MyNode *my_node_2 = (MyNode*)my_node_1->getNodeExtern();

   If the class has been exported to UnigineScript, you can perform the same on the UnigineScript side:
   Копировать Source code (UnigineScript)

   // create a MyNode pointer directly: a NodeExtern node will be created as well
   MyNode my_node_0 = new MyNode();
   // obtain the NodeExtern node
   my_node_0.getNodeExtern();
   
   // create a NodeExtern instance by MyNode's class ID
   NodeExtern my_node_1 = new NodeExtern(1);
   // obtain MyNode if required
   MyNode my_node_2 = class_cast("MyNode", node.getNodeExtern());

• The NodeExternBase class for the complete usage example of the NodeExtern and NodeExternBase classes.
• A C++ API sample <UnigineSDK>/source/samples/Api/Nodes/NodeExtern