Method StartAnimation

Code/CryEngine/CryEntitySystem/ScriptBind_Entity.cpp:2770–2891

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

   @see CEntity::StartAnimation
 */
int CScriptBind_Entity::StartAnimation(IFunctionHandler* pH)
{
	GET_ENTITY;

	//SCRIPT_CHECK_PARAMETERS(2);
	const char* animname;
	int pos, layer = 0;

	bool bLooping = false;
	bool bRecursive(false);
	bool partial(false);
	bool bForceSingleFrame(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, "CScriptBind_Entity::StartAnimation, animation name not specified, in Entity %s", 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);
				if (pH->GetParamCount() > 5)
				{
					pH->GetParam(6, bLooping);

					if (pH->GetParamCount() > 6)
					{
						pH->GetParam(7, bRecursive);

						if (pH->GetParamCount() > 7)
						{
							pH->GetParam(8, partial);

							if (pH->GetParamCount() > 8)
								pH->GetParam(9, bForceSingleFrame);
						}
					}
				}
			}
		}
	}

	ICharacterInstance* pCharacter = pEntity->GetCharacter(pos);
	// no character no animation
	if (!pCharacter)
		return pH->EndFunction(false);