SetPedAnimation

2010-04-08T00:32:49Z

FedorS: emphasized that time is used in milliseconds

__NOTOC__
{{Server client function}}

Sets the current animation of a player or ped. Not specifying the type of animation will automatically cancel the current one.

==Syntax==
<syntaxhighlight lang="lua">
bool setPedAnimation ( ped thePed [, string block=nil, string anim=nil, int time=-1, bool loop=true, bool updatePosition=true, bool interruptable=true] )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' the player or ped you want to apply an animation to.

===Optional Arguments===
{{OptionalArg}}
*'''block:''' the [[Animations|animation]] block's name.
*'''anim:''' the name of the [[Animations|animation]] within the block.
*'''time:''' how long the animation will run for in milliseconds.
*'''loop:''' indicates whether or not the animation will loop.
*'''updatePosition:''' will change the actual coordinates of the ped according to the animation. Use this for e.g. walking animations.
*'''interruptable:''' if set to 'false' other tasks wont be able to interupt the animation.

===Returns===
Returns ''true'' if succesful, ''false'' otherwise.

==Example==

<section name="Server" class="server" show="true">
This example creates a ped, rotates him, and makes him walk:
<syntaxhighlight lang="lua">
function makePed()
ped1 = createPed(56, 1, 1, 4)
setPedRotation(ped1, 315)
setPedAnimation( ped1, "ped", "WOMAN_walknorm")
end
addCommandHandler("makemyped", makePed)
</syntaxhighlight>
</section>

==See Also==
{{Ped_functions}}

Multi Theft Auto: Wiki - User contributions [en]

SetPedAnimation