Method StartAnimation

CrySystem/ScriptObjectEntity.cpp:1352–1424

! Starts an animation of a character @param pos Number of the character slot @param animname Name of the aniamtion from the .cal file @see CScriptObjectEntity::LoadCharacter @see CEntity::StartAnimation */

	@see CEntity::StartAnimation
*/
int CScriptObjectEntity::StartAnimation(IFunctionHandler *pH)
{
	
	//CHECK_PARAMETERS(2);
	const char *animname;
	int pos, layer=0;
	bool bLooping = false;
	bool bLoopSpecified = false;
	float fBlendTime = 0.15f;
	float fAniSpeed = 1.0f;
	pH->GetParam(1,pos);
	if (!pH->GetParam(2,animname))
	{
		m_pISystem->Warning( VALIDATOR_MODULE_SYSTEM,VALIDATOR_WARNING,0,
			0,"CScriptObjectEntity::StartAnimation, animation name not specified, in Entity %s",m_pEntity->GetName() );
		return pH->EndFunction(false);
	}

	if (pH->GetParamCount() > 2)
	{
	  pH->GetParam(3,layer);
		if (pH->GetParamCount() > 3)
		{
			pH->GetParam(4,fBlendTime);
			if (pH->GetParamCount() > 4)
			{
				pH->GetParam(5,fAniSpeed);
				m_pEntity->SetAnimationSpeed( fAniSpeed );
				if (pH->GetParamCount() > 5)
				{
					bLoopSpecified = true;
					pH->GetParam(6,bLooping);
				}
			}
		}
	}

	// no character no animation
	if (!m_pEntity->GetCharInterface() || !m_pEntity->GetCharInterface()->GetCharacter(pos))
		return pH->EndFunction(false);

	
	if (bLoopSpecified)
	{
		ICryCharInstance *pCharacter = m_pEntity->GetCharInterface()->GetCharacter(pos);
		if (pCharacter)
		{
			ICryAnimationSet *animSet = pCharacter->GetModel()->GetAnimationSet();
			if (animSet)
			{
				int animId = animSet->Find(animname);
				if (animId >= 0)
					animSet->SetLoop( animId,bLooping );
			}
		}
	}

	if (string(animname) == string("NULL"))