SetPedAnalogControlState: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (OCD issue)
mNo edit summary
 
Line 11: Line 11:
*'''thePed:''' The ped you wish to set the control state of.
*'''thePed:''' The ped you wish to set the control state of.
*'''control:''' The control that you want to set the state of. See [[control names]] for a list of possible controls.
*'''control:''' The control that you want to set the state of. See [[control names]] for a list of possible controls.
*'''state:''' A float value representing a full analog push ( 1 ) or full release ( 0 ).
*'''state:''' A [[float]] between 0 and 1 indicating the amount the control is pressed.


===Returns===
===Returns===
Line 17: Line 17:


==Example==   
==Example==   
This example uses [[setPedAnalogControlState]] to very slowly accelerate a ped-controlled NRG-500.
This example uses setPedAnalogControlState to very slowly accelerate a ped-controlled NRG-500.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function createAnalogControlTest ()
function createAnalogControlTest( )
     local t_Pos = {getElementPosition(localPlayer)}
     local playerPosition = Vector3( getElementPosition( localPlayer ) )
   
     local theVehicle = createVehicle( 522, playerPosition )
     local veh = createVehicle (522, unpack(t_Pos))
     local thePed = createPed( 0, playerPosition )
     local ped = createPed (0, unpack(t_Pos))
 
     warpPedIntoVehicle (ped, veh)
     warpPedIntoVehicle( thePed, theVehicle )
   
 
     setPedAnalogControlState (ped, 'accelerate', 0.05)
     setPedAnalogControlState( thePed, "accelerate", 0.05 )
     setPedAnalogControlState (ped, 'vehicle_left', 1)
     setPedAnalogControlState( thePed, "vehicle_left", 1 )
end
end
addCommandHandler ('analogcontroltest', createAnalogControlTest)
addCommandHandler( "analogcontroltest", createAnalogControlTest )
</syntaxhighlight>
</syntaxhighlight>


Line 36: Line 36:


==See Also==
==See Also==
{{Ped functions}}
{{Client ped functions}}

Latest revision as of 00:54, 8 July 2018

Sets an analog state of a specified ped's control, as if they pressed or released it.

This function only works on peds, to change the analog control state for a player, please use setAnalogControlState.

Syntax

bool setPedAnalogControlState ( ped thePed, string control, float state ) 

Required Arguments

  • thePed: The ped you wish to set the control state of.
  • control: The control that you want to set the state of. See control names for a list of possible controls.
  • state: A float between 0 and 1 indicating the amount the control is pressed.

Returns

Returns true if the control state was successfully set, false otherwise.

Example

This example uses setPedAnalogControlState to very slowly accelerate a ped-controlled NRG-500.

function createAnalogControlTest( )
    local playerPosition = Vector3( getElementPosition( localPlayer ) )
    local theVehicle = createVehicle( 522, playerPosition )
    local thePed = createPed( 0, playerPosition )

    warpPedIntoVehicle( thePed, theVehicle )

    setPedAnalogControlState( thePed, "accelerate", 0.05 )
    setPedAnalogControlState( thePed, "vehicle_left", 1 )
end
addCommandHandler( "analogcontroltest", createAnalogControlTest )

Requirements

Minimum server version n/a
Minimum client version 1.3.0-9.04185

Note: Using this feature requires the resource to have the above minimum version declared in the meta.xml <min_mta_version> section. e.g. <min_mta_version client="1.3.0-9.04185" />

See Also