SetPedFrozen: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(7 intermediate revisions by 6 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
{{Deprecated|setElementFrozen}}
This function freezes (or un-freezes) a pedestrian, meaning they cannot move, jump, aim, shoot, etcetera.
This function freezes (or un-freezes) a pedestrian, meaning they cannot move, jump, aim, shoot, etcetera.


Line 11: Line 14:
*'''thePed:''' The [[ped]] whose frozen state will be changed.
*'''thePed:''' The [[ped]] whose frozen state will be changed.
*'''frozen:''' A [[bool]] value as to whether the ped is frozen or not.
*'''frozen:''' A [[bool]] value as to whether the ped is frozen or not.
===Returns===
Returns ''true'' if the frozen state was set successfully, or ''false'' if invalid arguments were passed.


==Example==  
==Example==  
This example adds a 'togglefreeze' console command that lets players alternate their frozen state.
This example adds a 'togglefreeze' console command that lets players alternate their frozen state.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function toggleFreeze ( sourcePlayer, command )
function toggleFreeze ( sourcePlayer )
     local frozen = getPedFrozen ( sourcePlayer )
     local frozen = getPedFrozen ( sourcePlayer )
     setPedFrozen ( sourcePlayer, not frozen )
     setPedFrozen ( sourcePlayer, not frozen )
Line 23: Line 29:


==See Also==
==See Also==
{{Client_ped_functions}}
{{Ped functions}}
[[ru:setPedFrozen]]

Latest revision as of 20:18, 23 September 2016

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.

Please use setElementFrozen instead.


This function freezes (or un-freezes) a pedestrian, meaning they cannot move, jump, aim, shoot, etcetera.

Syntax

bool setPedFrozen ( ped thePed, bool frozen )

Required Arguments

  • thePed: The ped whose frozen state will be changed.
  • frozen: A bool value as to whether the ped is frozen or not.

Returns

Returns true if the frozen state was set successfully, or false if invalid arguments were passed.

Example

This example adds a 'togglefreeze' console command that lets players alternate their frozen state.

function toggleFreeze ( sourcePlayer )
    local frozen = getPedFrozen ( sourcePlayer )
    setPedFrozen ( sourcePlayer, not frozen )
end
addCommandHandler ( "togglefreeze", toggleFreeze )

See Also