EngineRestoreAnimation: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 27: Line 27:
'''Example 1:''' This example restores all replaced animations within every block for the local player.
'''Example 1:''' This example restores all replaced animations within every block for the local player.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
engineRestoreAnimation ( localPlayer )
engineRestoreAnimation( localPlayer )
</syntaxhighlight>
</syntaxhighlight>


'''Example 2:''' This example restores all replaced animations only within "ped" block for the local player.
'''Example 2:''' This example restores all replaced animations only within "ped" block for the local player.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
engineRestoreAnimation ( localPlayer, "ped" )
engineRestoreAnimation( localPlayer, "ped" )
</syntaxhighlight>
</syntaxhighlight>


'''Example 3:''' This example restores "weapon_crouch" animation within "ped" block for the local player.
'''Example 3:''' This example restores "weapon_crouch" animation within "ped" block for the local player.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
engineRestoreAnimation ( localPLayer, "ped", "weapon_crouch" )
engineRestoreAnimation( localPLayer, "ped", "weapon_crouch" )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{Engine_functions}}
{{Engine_functions}}

Revision as of 09:37, 2 July 2018

This function restores internal (default) animations that were replaced using engineReplaceAnimation function. This function only affects a specific player or ped just like engineReplaceAnimation.

If only 1st parameter (ped) is provided to this function, all replaced animations are restored. If block name is also provided for 2nd parameter, then replaced animations within that block are restored. If 3rd parameter (animation name) is provided, then only that specific animation within that specific block is restored.

Syntax

bool engineRestoreAnimation ( ped thePed [, string InternalBlockName, string InternalAnimName ] )

Required Arguments

  • thePed: the player or ped you want to restore an animation(s) for.

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.

Returns

Returns true on success, false in case of failure.

Example

Example 1: This example restores all replaced animations within every block for the local player.

engineRestoreAnimation( localPlayer )

Example 2: This example restores all replaced animations only within "ped" block for the local player.

engineRestoreAnimation( localPlayer, "ped" )

Example 3: This example restores "weapon_crouch" animation within "ped" block for the local player.

engineRestoreAnimation( localPLayer, "ped", "weapon_crouch" )

See Also