SetPedAnimationSpeed: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 2: Line 2:
{{Server client function}}
{{Server client function}}
{{New feature/item|3.0156|1.5.5|14219|
{{New feature/item|3.0156|1.5.5|14219|
Sets the current animation speed of a player or ped.
Sets the speed of a currently running animation for a particular player or ped.
}}
}}


Line 9: Line 9:
bool setPedAnimationSpeed ( ped thePed [, string anim = "", float speed = 1.0 ] )
bool setPedAnimationSpeed ( ped thePed [, string anim = "", float speed = 1.0 ] )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[ped]]:setAnimationProgress}}
{{OOP||[[ped]]:setAnimationSpeed}}


===Required Arguments===
===Required Arguments===
Line 16: Line 16:
===Optional Arguments===
===Optional Arguments===
*'''anim:''' the animation name it will affect.
*'''anim:''' the animation name it will affect.
*'''speed:''' a [[float]] containing the speed between 0.0–1.0 you want to apply to the animation.
*'''speed:''' a [[float]] containing the speed between 0.0–1.0 you want to apply to the animation. ''This limitation may be adjusted in the future, so do not provide speeds outside this boundary.'' {{New feature/item|3.0158|1.5.7|20395|The limit is now 0.0 to 10.0.}} {{Warning|Setting '''speed''' higher than '''1''' can cause issues with some animations.}}


===Returns===
===Returns===
Line 22: Line 22:


==Example==
==Example==
{{Example}}
<section name="Server" class="server" show="true">
In this example we give the animation of dancing to the player and after 5 seconds it becomes 0.2s slower.
<syntaxhighlight lang="lua">
addCommandHandler('dance',
  function( player, cmd )
      setPedAnimation( player, 'DANCING', 'DAN_Down_A', -1 )
      setTimer(function(plr)
          if isElement(plr) then setPedAnimationSpeed( plr, 'DAN_Down_A', 0.2 ) end
      end,5000,1,player)
  end
)
</syntaxhighlight>
</section>


==See Also==
==See Also==
{{Ped_functions}}
{{Ped_functions}}

Latest revision as of 06:55, 17 December 2023

Sets the speed of a currently running animation for a particular player or ped.

Syntax

bool setPedAnimationSpeed ( ped thePed [, string anim = "", float speed = 1.0 ] )

OOP Syntax Help! I don't understand this!

Method: ped:setAnimationSpeed(...)


Required Arguments

  • thePed: the player or ped you want to change animation speed of.

Optional Arguments

  • anim: the animation name it will affect.
  • speed: a float containing the speed between 0.0–1.0 you want to apply to the animation. This limitation may be adjusted in the future, so do not provide speeds outside this boundary. The limit is now 0.0 to 10.0.
[[|link=|]] Warning: Setting speed higher than 1 can cause issues with some animations.

Returns

Returns true if successful, false otherwise.

Example

Click to collapse [-]
Server

In this example we give the animation of dancing to the player and after 5 seconds it becomes 0.2s slower.

addCommandHandler('dance',
  function( player, cmd )
      setPedAnimation( player, 'DANCING', 'DAN_Down_A', -1 )
      setTimer(function(plr)
          if isElement(plr) then setPedAnimationSpeed( plr, 'DAN_Down_A', 0.2 ) end
      end,5000,1,player)
   end
)

See Also