Multi Theft Auto: Wiki - User contributions [en]

SetPedDoingGangDriveby

2021-03-26T22:43:29Z

LosFaul: /* Example */

{{Server client function}}
__NOTOC__
This function sets the driveby state of a ped.

==Syntax==
<syntaxhighlight lang="lua">
bool setPedDoingGangDriveby ( ped thePed, bool state )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' The [[ped]] element whose state is to be changed.
*'''state:''' A [[boolean]] value representing the drive-by state, ''true'' meaning enabled and ''false'' disabled.

===Returns===
Returns ''true'' if the driveby state could be changed, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example turns on driveby mode when the local player types ''driveby'' in the console.
<syntaxhighlight lang="lua">function setDoingDriveby()
-- we check if local player isn't currently doing a gang driveby
if not isPedDoingGangDriveby(localPlayer) then
-- if he got driveby mode off, turn it on
setPedWeaponSlot(localPlayer, 4)
setPedDoingGangDriveby(localPlayer, true)
else
-- otherwise, turn it off
setPedWeaponSlot(localPlayer, 0)
setPedDoingGangDriveby(localPlayer, false)
end
end
addCommandHandler("driveby", setDoingDriveby)</syntaxhighlight>
</section>

==See Also==
{{Ped functions}}
[[ru:setPedDoingGangDriveby]]

SetPedDoingGangDriveby

2021-03-26T22:42:17Z

LosFaul: /* Example */

{{Server client function}}
__NOTOC__
This function sets the driveby state of a ped.

==Syntax==
<syntaxhighlight lang="lua">
bool setPedDoingGangDriveby ( ped thePed, bool state )
</syntaxhighlight>

===Required Arguments===
*'''thePed:''' The [[ped]] element whose state is to be changed.
*'''state:''' A [[boolean]] value representing the drive-by state, ''true'' meaning enabled and ''false'' disabled.

===Returns===
Returns ''true'' if the driveby state could be changed, ''false'' otherwise.

==Example==
<section name="Client" class="client" show="true">
This example turns on driveby mode when the local player types ''driveby'' in the console.
<syntaxhighlight lang="lua">function setDoingDriveby()
-- we check if local player isn't currently doing a gang driveby
if not isPedDoingGangDriveby(localPlayer) then
-- if he got driveby mode off, turn it on
setPedWeaponSlot(localPlayer, 4 )
setPedDoingGangDriveby(localPlayer, true)
else
-- otherwise, turn it off
setPedWeaponSlot(localPlayer, 0)
setPedDoingGangDriveby(localPlayer, false)
end
end
addCommandHandler("driveby", setDoingDriveby)</syntaxhighlight>
</section>

==See Also==
{{Ped functions}}
[[ru:setPedDoingGangDriveby]]

GetVehicleWheelFrictionState

2021-03-11T18:22:40Z

LosFaul: /* Returns */

{{Client function}}
__NOTOC__
{{New feature/item|3.0160|1.5.8|20726|This function returns the current wheel friction state of the [[vehicle]].}}

==Syntax==
<syntaxhighlight lang="lua">
int getVehicleWheelFrictionState ( vehicle theVehicle, int wheel )
</syntaxhighlight>

{{OOP||[[vehicle]]:getWheelFrictionState}}

===Required Arguments===
*'''theVehicle:''' The [[vehicle]] that you wish to get the wheel friction state.
*'''wheel:''' The wheel you want to check. (0: front left, 1: rear left, 2: front right, 3: rear right)

===Returns===
Returns a [[int]] indicating the wheel friction state. This value can be:

* '''0:''' Normal friction
* '''1:''' Slip with acceleration (only for driving wheels)
* '''2:''' Slip without acceleration
* '''3:''' Locked wheel (on brake or handbrake).

==Example==
<section name="Client" class="client" show="true">
This example will show the friction state of each wheel of the player's current vehicle.

<syntaxhighlight lang="lua">
addEventHandler('onClientRender', root, function()
local veh = getPedOccupiedVehicle(localPlayer)

if (not veh) then
return false
end

dxDrawRectangle(0, 0, 300, 140, tocolor(0, 0, 0, 150))
dxDrawText('FRICTION FRONT LEFT = ' .. getVehicleWheelFrictionState(veh, 0), 8, 10, 290, 40, tocolor(255, 255, 255), 1.5)
dxDrawText('FRICTION FRONT RIGHT = ' .. getVehicleWheelFrictionState(veh, 2), 8, 40, 290, 70, tocolor(255, 255, 255), 1.5)
dxDrawText('FRICTION REAR LEFT = ' .. getVehicleWheelFrictionState(veh, 1), 8, 70, 290, 100, tocolor(255, 255, 255), 1.5)
dxDrawText('FRICTION REAR RIGHT = ' .. getVehicleWheelFrictionState(veh, 3), 8, 100, 290, 130, tocolor(255, 255, 255), 1.5)

end)</syntaxhighlight>
</section>

==See Also==
{{Client vehicle functions}}

SetAnalogControlState

2020-12-13T18:02:37Z

LosFaul: /* Example */

__NOTOC__
{{Client function}}
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 control [, float state, bool forceOverrideNextFrame = false ] ) </syntaxhighlight>
===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.
<noinclude>{{New feature/item|3.0300|1.5.8|20756|
*'''forceOverrideNextFrame: ''' A [[bool]] indicating if the player input should force fully overriden for the next frame.
}}</noinclude>

===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.
<syntaxhighlight lang="lua">
addCommandHandler( "forwards",
function( )
if ( getAnalogControlState( "forwards" ) == 0 ) then
setAnalogControlState( "forwards", 1 )
else
setAnalogControlState( "forwards", 0 )
end
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>

==See Also==
{{Client input functions}}

SetAnalogControlState

2020-12-13T17:59:13Z

LosFaul: /* Syntax */

GetPedAnalogControlState

2020-11-21T11:57:11Z

LosFaul: /* Optional Arguments */

__NOTOC__
{{Client function}}
{{Needs_Example}}
This function retrieves the analog control state of a ped, as set by [[setPedAnalogControlState]].

==Syntax==
<syntaxhighlight lang="lua">float getPedAnalogControlState ( ped thePed, string controlName [, bool rawValue ] )</syntaxhighlight>

===Required Arguments===
*'''thePed:''' The ped you wish to retrieve the control state of.
*'''controlName:''' The control. See [[control names]] for a list of possible controls.

===Optional Arguments===
{{New feature/item|3.0160|1.5.7|20383|
*'''rawValue:''' A bool indicating if it should return the raw player input value (will always return script value for non-player peds).
}}

===Returns===
Returns a float between 0 ( full release ) and 1 ( full push ) indicating the amount the control is pushed.

<section name="Client-side example" class="client" show="true">
<syntaxhighlight lang="lua">
x, y, z = getElementPosition(localPlayer)
rotX, rotY, rotZ = getElementRotation(localPlayer)
CJ = createPed(0, x, y, z)
CJ2 = createPed(0, x, y, z)
copcar = createVehicle(597, x, y+5, z+2)
copcar2 = createVehicle(597, x+2, y+10, z+4)
warpPedIntoVehicle(CJ2, copcar2, 0)
warpPedIntoVehicle(CJ, copcar, 0)

function onGetCJAnalogControlState()
setPedAnalogControlState(CJ, "accelerate", 0.90)
if getPedAnalogControlState(CJ, "accelerate", 0.90) then
setPedAnalogControlState(CJ2, "brake_reverse", 0.90)
end
end
addEventHandler("onClientRender", getRootElement(), onGetCJAnalogControlState)
</syntaxhighlight>
</section>
<br /><br />

* This example was created by '''Hydra'''.

==Requirements==
{{Requirements|n/a|1.3.0-9.04185|}}

==See Also==
{{Ped functions}}

[[hu:getPedAnalogControlState]]

GetAnalogControlState

2020-11-21T11:56:23Z

LosFaul: /* Optional Arguments */

__NOTOC__
{{Client function}}
This retrieves the analog control state of a control. This is useful for detecting sensitive controls, such as those used on a joypad.

To get the analog control state for a [[ped]], please use [[getPedAnalogControlState]].

==Syntax==
<syntaxhighlight lang="lua">float getAnalogControlState ( string control [, bool rawValue ] )</syntaxhighlight>

===Required Arguments===
*'''control:''' The control that you want to get the state of. See [[control names]] for a list of possible controls.

===Optional Arguments===
{{New feature/item|3.0157|1.5.7|20383|
*'''rawValue:''' A bool indicating if it should return the raw player input value.
}}

===Returns===
Returns a [[float]] between 0 and 1 indicating the amount the control is pressed.

==Example==
This creates an ''/forwards'' command, which toggles your ''forwards'' control state between 0 and 1.
<syntaxhighlight lang="lua">
addCommandHandler( "forwards",
function( )
if ( getAnalogControlState( "forwards" ) == 0 ) then
setAnalogControlState( "forwards", 1 )
else
setAnalogControlState( "forwards", 0 )
end
end
)
</syntaxhighlight>

==See Also==
{{Client input functions}}