比較バージョン

バージョン 古いバージョン 2 新しいバージョン 3
による変更

Alan Stanzione

Alan Stanzione

保存しました

キー

  • この行は追加されました。
  • この行は削除されました。
  • 書式設定が変更されました。
In this section we creates a new behaviour module. This module is a simple follow target module.


Writing the behaviour module

First thing to do is create a class and hinerit from the base BehaviourModule class. With a constructor a desctructor and a static creator function used by atoms to create an isntance of this module.


コード ブロック
languagecpp
class FollowTargetModule: public Atoms::BehaviourModule
{
	public:

		FollowTargetModule()
		{}

		virtual ~FollowTargetModule()
		{}

		static Atoms::BehaviourModule* creator(const std::string& parameter);
};

Atoms::BehaviourModule* creator(const std::string& parameter)
{
	return new FollowTargetModule();
}


Lets add some attributes to our node. In this case we need only a target position. The attributes of the modules are stored inside a MapMetadata object, and you can add new attribute using the addAttribute function. So lets add this attribute inside the constructor.


コード ブロック
languagecpp
FollowTargetModule()
{
	AtomsCore::Vector3Metadata targetPosition(AtomsCore::Vector3(0.0,0.0,0.0));
	// The last argumet specify if this attribute can be override per agent
	addAttribute("targetPosition", &targerPosition, true);
}


Now we need to compute the new agent direction at each frame before the agent pose is computed, so we need to override the initFrame function.

You can override other function linke the endFrame or initSimulation or agentsCreated but in this case we need only the initFrame



コード ブロック
languagecpp
void initFrame(const std::vector<Atoms::Agent*>& agents, Atoms::AgentGroup* agentGroup = nullptr)
{
}

In the init frame we need to get our targetPosition value and iterate over each agent to get the position and set the new direction


コード ブロック
languagecpp
void initFrame(const std::vector<Atoms::Agent*>& agents, Atoms::AgentGroup* agentGroup = nullptr)
{
	// Get the target position from the moduel attribute
	AtomsCore::MapMetadata& attributeMap = attributes();
	AtomsCore::Vector3& targetPosition = attributeMap.getTypedEntry<AtomsCore::Vector3Metadata>("targetPosition")->get();

	// iterate over each agent
	for(Atoms::Agent* agent: agents)
	{
		if (!agent)
			continue;
		//get the agent position
		AtomsPtr<AtomsCore::Vector3Metadata> positionPtr = agent->metadata().getTypedEntry<AtomsCore::Vector3Metadata>("position")->get();
		AtomsPtr<AtomsCore::Vector3Metadata> directionPtr = agent->metadata().getTypedEntry<AtomsCore::Vector3Metadata>("direction")->get();
		if(!positionPtr || !directionPtr )
			continue;

		// compute the new direction
		directionPtr->set((targetPosition - positionPtr->get()).normalized()); 
	}
}


We created the target position attribute as overraidable per agent but we didn't put the code to handle it. So let's add now. When you override an attribute, Atoms creates an entry using the agent group id inside the mapmetadata saved as AttributeName_override.



コード ブロック
languagecpp
void initFrame(const std::vector<Atoms::Agent*>& agents, Atoms::AgentGroup* agentGroup = nullptr)
{
	// Get the target position from the moduel attribute
	AtomsCore::MapMetadata& attributeMap = attributes();
	AtomsCore::Vector3& targetPosition = attributeMap.getTypedEntry<AtomsCore::Vector3Metadata>("targetPosition")->get();

	//get the override map metadata
	AtomsPtr<AtomsCore::MapMetadata> targetPosition = attributeMap.getTypedEntry<AtomsCore::MapMetadata>("targetPosition_override");

	// iterate over each agent
	for(Atoms::Agent* agent: agents)
	{
		if (!agent)
			continue;
		//get the agent position
		AtomsPtr<AtomsCore::Vector3Metadata> positionPtr = agent->metadata().getTypedEntry<AtomsCore::Vector3Metadata>("position")->get();
		AtomsPtr<AtomsCore::Vector3Metadata> directionPtr = agent->metadata().getTypedEntry<AtomsCore::Vector3Metadata>("direction")->get();
		if(!positionPtr || !directionPtr )
			continue;

		// compute the new direction
		directionPtr->set((targetPosition - positionPtr->get()).normalized()); 
	}
}


Register the behaviour module

Compile the behaviour module

Use the behaviour module