SetPedAnimation: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Issue fixed, removed from table.)
 
(24 intermediate revisions by 12 users not shown)
Line 2: Line 2:
{{Server client function}}
{{Server client function}}


Sets the current animation of a player or ped. Not specifying the type of animation will automatically cancel the current one.
Sets the current [[Animations|animation]] of a [[player]] or [[ped]]. Not specifying the type of animation will automatically cancel the current one.
{{Warning|It is possible that an animation will be cancelled if you use setElementFrozen on the ped, but this does not happen all the time.}}


==Syntax==
==Syntax==
<syntaxhighlight lang="lua">
<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, bool freezeLastFrame=true, int blendTime=250] )
bool setPedAnimation ( ped thePed [, string block = nil, string anim = nil, int time = -1, bool loop = true, bool updatePosition = true,
                      bool interruptable = true, bool freezeLastFrame = true, int blendTime = 250, bool retainPedState = false ] )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[ped]]:setAnimation||getPedAnimation}}
{{OOP||[[ped]]:setAnimation||getPedAnimation}}


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


===Optional Arguments===
===Optional Arguments===
Line 23: Line 25:
*'''freezeLastFrame:''' if set to ''true'' after animation the last frame will be frozen, otherwise the animation will end and controls will return.
*'''freezeLastFrame:''' if set to ''true'' after animation the last frame will be frozen, otherwise the animation will end and controls will return.
*'''blendTime:''' how long the animation will mixed with the previous one in milliseconds.
*'''blendTime:''' how long the animation will mixed with the previous one in milliseconds.
{{New items|3.0157|1.5.7|
*'''retainPedState:''' will restore the task which was playing before calling this function. Useful for restoring the crouch task after animation ends. This may be extended in the future to support other states/tasks.
|16632}}


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


==Example1==  
==Examples==


<section name="Server" class="server" show="true">
<section name="Server" class="server" show="true">
Line 33: Line 38:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function makePed()
function makePed()
  ped1 = createPed(56, 1, 1, 4)
local thePed = createPed(56, 1, 1, 4, 315)
  setPedRotation(ped1, 315)
setPedAnimation(thePed, "ped", "WOMAN_walknorm")
  setPedAnimation( ped1, "ped", "WOMAN_walknorm")
end
end
addCommandHandler("makemyped", makePed)
addCommandHandler("makemyped", makePed)
Line 41: Line 45:
</section>
</section>


 
<section name="Server" class="server" show="true">
==Example2==
This example makes the player sit down and stand up using the command /sit.
This example makes the player dance when he uses command /dance and stop when he uses the same command:
 
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
local playerSitState = {}


addEventHandler("onClientPreRender",root,
function toggleSit(thePlayer)
  function ()
local playerSitting = playerSitState[thePlayer]
    daBlock, daAnim = getPedAnimation(getLocalPlayer())
    setElementData(root,"blockz",daBlock)
    setElementData(root,"animz",daAnim)
  end )


if (not playerSitting) then
setPedAnimation(thePlayer, "ped", "seat_down", -1, false, false, false, false)
playerSitState[thePlayer] = true -- store the player state in the table


</syntaxhighlight>
return true
</section>
end


setPedAnimation(thePlayer) -- if you use again this command then your character stand up
playerSitState[thePlayer] = nil -- remove player sit state from table
end
addCommandHandler("sit", toggleSit)


<section name="Server" class="server" show="true">
function onPlayerQuitClearSitState()
<syntaxhighlight lang="lua">
playerSitState[source] = nil -- clear state at player quit, to prevent memory leak
function dance (source)
end
daBlockz = getElementData(root,"blockz")
addEventHandler("onPlayerQuit", root, onPlayerQuitClearSitState)
daAnimz = getElementData(root,"animz")
if daBlockz == "dancing" and daAnimz == "dnce_m_b" then
setPedAnimation(source,false)
else
setPedAnimation ( source, "DANCING", "dnce_m_b")
end
end
addCommandHandler("dance",dance)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>


==Changelog==
{{ChangelogHeader}}
{{ChangelogItem|1.5.7-9.16632|Added retainPedState argument}}


==Example3==  
==Issues==
 
{{Issues|
<section name="Server" class="server" show="true">
{{Issue|1110|retainPedState in setPedAnimation() does not work when latency reduction is set to 1}}
This example makes the player sit down and remain seated.
{{Issue|953|setPedAnimation() "interrupt" and "time" has no effect in certain situations}}
<syntaxhighlight lang="lua">
{{Issue|467|Ped animations don't sync for new players}}
local animValue = false
{{Issue|463|setPedAnimation() does not work when a ped is attached and floating in air}}
 
{{Issue|1173|setPedAnimation() removes player jetpack}}
function sitDown (thePlayer)
{{Issue|884|setPedAnimation() messes up collisions of peds inside vehicles}}
  if animValue == false then
}}
setPedAnimation(thePlayer, "ped", "seat_down", -1, false, false, false, true)
animValue = true
  else
-- If you use again this command then your character stand up
animValue = false
setPedAnimation(thePlayer, nil, nil)
  end
end
addCommandHandler("sit", sitDown)
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Ped_functions}}
{{Ped_functions}}
[[ru:setPedAnimation]]
[[ru:setPedAnimation]]
[[HU:setPedAnimation]]

Latest revision as of 06:07, 14 July 2024

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

[[|link=|]] Warning: It is possible that an animation will be cancelled if you use setElementFrozen on the ped, but this does not happen all the time.

Syntax

bool setPedAnimation ( ped thePed [, string block = nil, string anim = nil, int time = -1, bool loop = true, bool updatePosition = true,
                       bool interruptable = true, bool freezeLastFrame = true, int blendTime = 250, bool retainPedState = false ] )

OOP Syntax Help! I don't understand this!

Method: ped:setAnimation(...)
Counterpart: getPedAnimation


Required Arguments

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • block: the animation block's name.
  • anim: the name of the 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. Setting this to 'false' also gives this function more power to override other animations that are running. For example, squatting after a jump can be terminated.
  • freezeLastFrame: if set to true after animation the last frame will be frozen, otherwise the animation will end and controls will return.
  • blendTime: how long the animation will mixed with the previous one in milliseconds.
  • retainPedState: will restore the task which was playing before calling this function. Useful for restoring the crouch task after animation ends. This may be extended in the future to support other states/tasks.

Returns

Returns true if succesful, false otherwise.

Examples

Click to collapse [-]
Server

This example creates a ped, rotates him, and makes him walk: 

function makePed()
	local thePed = createPed(56, 1, 1, 4, 315)
	setPedAnimation(thePed, "ped", "WOMAN_walknorm")
end
addCommandHandler("makemyped", makePed)
Click to collapse [-]
Server

This example makes the player sit down and stand up using the command /sit. 

local playerSitState = {}

function toggleSit(thePlayer)
	local playerSitting = playerSitState[thePlayer]

	if (not playerSitting) then
		setPedAnimation(thePlayer, "ped", "seat_down", -1, false, false, false, false)
		playerSitState[thePlayer] = true -- store the player state in the table

		return true
	end

	setPedAnimation(thePlayer) -- if you use again this command then your character stand up
	playerSitState[thePlayer] = nil -- remove player sit state from table
end
addCommandHandler("sit", toggleSit)

function onPlayerQuitClearSitState()
	playerSitState[source] = nil -- clear state at player quit, to prevent memory leak
end
addEventHandler("onPlayerQuit", root, onPlayerQuitClearSitState)

Changelog

Version Description
1.5.7-9.16632 Added retainPedState argument

Issues

Issue ID Description
#1110 retainPedState in setPedAnimation() does not work when latency reduction is set to 1
#953 setPedAnimation() "interrupt" and "time" has no effect in certain situations
#467 Ped animations don't sync for new players
#463 setPedAnimation() does not work when a ped is attached and floating in air
#1173 setPedAnimation() removes player jetpack
#884 setPedAnimation() messes up collisions of peds inside vehicles

See Also

Retrieved from "https://wiki.multitheftauto.com/wiki/SetPedAnimation?oldid=79882"