SetAnalogControlState: Difference between revisions

Latest revision as of 21:06, 23 September 2021

This sets the analog control state of a control for the local player. To change the analog controls for a ped, please use setPedAnalogControlState.

Syntax

bool setAnalogControlState ( string control [, float state, bool forceOverrideNextFrame = false ] )

Required Arguments

control: The control that you want to set the state of. See control names for a list of possible controls.

Optional Arguments

state: A float between 0 and 1 indicating the amount the control is pressed. If no value is provided, the analog control is removed.

forceOverrideNextFrame: A bool indicating if the player input should force fully overriden for the next frame.

Returns

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

Example

This creates an /forwards command, which toggles your forwards control state between 0 and 1.

addCommandHandler( "forwards",
    function( )
        if ( getAnalogControlState( "forwards" ) == 0 ) then
            setAnalogControlState( "forwards", 1 )
        else
            setAnalogControlState( "forwards", 0 )
        end
    end
)

This script invertes left and right vehicle steering for the player.

addEventHandler("onClientPreRender", root,
    function()
        local right = getAnalogControlState("vehicle_right", true)
        local left = getAnalogControlState("vehicle_left", true)
        
        if right > left then
            setAnalogControlState("vehicle_left", right, true)
        else
            setAnalogControlState("vehicle_right", left, true)
        end
    end
)

@@ Line 1: / Line 1: @@
 __NOTOC__
 {{Client function}}
-This sets the analog control state of a control.
+This sets the analog control state of a control for the local player. To change the analog controls for a [[ped]], please use [[setPedAnalogControlState]].
 ==Syntax==
-<syntaxhighlight lang="lua"> bool setAnalogControlState ( string controlName [, float state] ) </syntaxhighlight>
+<syntaxhighlight lang="lua">bool setAnalogControlState ( string control [, float state, bool forceOverrideNextFrame = false ] ) </syntaxhighlight>
-===Required Arguement===
+===Required Arguments===
-* '''controlName''': the control name you wish to set the analog state of. Here's a list:
+*'''control:''' The control that you want to set the state of. See [[control names]] for a list of possible controls.
-**'''left'''
-**'''right'''
-**'''forwards'''
-**'''backwards'''
-**'''vehicle_left'''
-**'''vehicle_right'''
-**'''steer_forward'''
-**'''steer_back'''
-**'''accelerate'''
-**'''brake_reverse'''
-**'''special_control_left'''
-**'''special_control_right'''
-**'''special_control_up'''
-**'''special_control_down'''
 ===Optional Arguments===
-*'''state:''' A float between 0 and 1 indicating the amount the control is pressed. If no value is provided, the analog control is removed.
+*'''state:''' A [[float]] between 0 and 1 indicating the amount the control is pressed. If no value is provided, the analog control is removed.
+{{Added feature/item|1.5.9|1.5.8|20756|
+*'''forceOverrideNextFrame: ''' A [[bool]] indicating if the player input should force fully overriden for the next frame.
+}}
 ===Returns===
-Returns true, else false if invalid argument.
+Returns ''true'' if the control state was successfully set, ''false'' otherwise.
 ==Example==
-<section name="Client" class="client" show="true">
+This creates an ''/forwards'' command, which toggles your ''forwards'' control state between 0 and 1.
-/analog command starts to go forward control state if you are not, if you are going forward by control state then you will stop.
 <syntaxhighlight lang="lua">
-function analog()
+addCommandHandler( "forwards",
-if (getAnalogControlState("forwards") == 0) then
+    function( )
-setAnalogControlState ("forwards",1)
+        if ( getAnalogControlState( "forwards" ) == 0 ) then
-else
+            setAnalogControlState( "forwards", 1 )
-setAnalogControlState ("forwards",0)
+        else
-end
+            setAnalogControlState( "forwards", 0 )
-end
+        end
-addCommandHandler("analog",analog)
+    end
+)
+</syntaxhighlight>
+This script invertes left and right vehicle steering for the player.
+<syntaxhighlight lang="lua">
+addEventHandler("onClientPreRender", root,
+    function()
+        local right = getAnalogControlState("vehicle_right", true)
+        local left = getAnalogControlState("vehicle_left", true)
+        if right > left then
+            setAnalogControlState("vehicle_left", right, true)
+        else
+            setAnalogControlState("vehicle_right", left, true)
+        end
+    end
+)
 </syntaxhighlight>
-This example written by '''Samurai'''
-</section>
 ==See Also==
 {{Client input functions}}