Getting the name of the current animation: getActionThread()

This is a little resource for Torque3D 1.1 final that returns the name of the currently playing action animation as set with %player.setActionThread(this_animation). As it is set with setActionThread I have called this function getActionThread.

So let's just start, it's only a few minutes work.

in player.cpp at the end of the file add the following:

const char* Player::getActionThread()
{
	return mDataBlock->actionList[mActionAnimation.action].name;
}

DefineEngineMethod(Player, getActionThread, const char*,(),,"Returns the currently playing animationsequence")
{
	return object->getActionThread();
}

Now in player.h find the following lines in the player class definition and add the marked line.

...
   virtual bool setArmThread(U32 action);
   virtual void setActionThread(U32 action,bool forward,bool hold = false,bool wait = false,bool fsp = false, bool forceSet = false);
   virtual void updateActionThread();
   virtual void pickBestMoveAction(U32 startAnim, U32 endAnim, U32 * action, bool * forward) const;
   virtual void pickActionAnimation();
   const char* getActionThread();// <=========== Add this line
...

That is all, so rebuild the engine and you're done.

In script you can use this to get the name of the currently playing action animation as follows:
[code]
%player.setActionThread("work");// assuming you have an animation sequence called work

now calling %player.getActionThread(); will return work.

It's a small resource, but I needed it, and maybe it is useful for some of you, hope you like it.