allTurrets: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<br/>" to "<br>")
m (Some wiki formatting)
 
(47 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.34


|1.34|Game version=
|gr1= Turrets
____________________________________________________________________________________________


|Returns array of available turret paths from vehicle object.
|descr= Returns array of available turret paths from vehicle object.


{{Informative |
{{Feature|informative|
* to look up turrets from config, use [[BIS_fnc_allTurrets]]
* to look up turrets from config, use [[BIS_fnc_allTurrets]]
* to get config from turret path use [[BIS_fnc_turretConfig]]}} |DESCRIPTION=
* to get config from turret path, use [[BIS_fnc_turretConfig]]
____________________________________________________________________________________________
}}


| [[allTurrets]] vehicle |SYNTAX=
|s1= [[allTurrets]] vehicle


|p1= vehicle: [[Object]] |PARAMETER1=
|p1= vehicle: [[Object]]


| [[Array]] |RETURNVALUE=
|r1= [[Array]] of [[Array]]s format [[Turret Path]]
____________________________________________________________________________________________


|s2= [[allTurrets]] [vehicle, includeFFV] |SYNTAX2=
|s2= [[allTurrets]] [vehicle, includeFFV]
|p21= [vehicle, includeFFV]: [[Array]] | PARAMETER21=


|p22= vehicle: [[Object]] | PARAMETER22=
|p21= vehicle: [[Object]]


|p23= includeFFV: [[Boolean]] - [[true]] to include FFV (Firing From Vehicle) positions, [[false]] to exclude them |PARAMETER23=
|p22= includeFFV: [[Boolean]] - [[true]] to include FFV (Firing From Vehicle) positions, [[false]] to exclude them


|r2= [[Array]] |RETURNVALUE2=
|r2= [[Array]] of [[Array]]s format [[Turret Path]]
____________________________________________________________________________________________


|x1= <code>_turretPaths = [[allTurrets]] _mySlammerUP; {{cc|[<nowiki/>[0],[0,0]]}}
|x1= <sqf>
_turretPaths = [[allTurrets]] [_mySlammerUP, [[true]]]; {{cc|[<nowiki/>[0],[0,0]] <- Commander turret is also an FFV turret}}
_turretPaths = allTurrets _mySlammerUP; // [[0],[0,0]]
_turretPaths = [[allTurrets]] [_mySlammerUP, [[false]]]; {{cc|[<nowiki/>[0]]}}</code> |EXAMPLE1=
_turretPaths = allTurrets [_mySlammerUP, true]; // [[0],[0,0]] <- commander turret is also an FFV turret
_turretPaths = allTurrets [_mySlammerUP, false]; // [<nowiki/>[0]]
</sqf>


|x2 = Return FFV turrets only:
|x2= Return FFV turrets only:
<code>_FFVTurrets = [[allTurrets]] [tank, [[true]]] - [[allTurrets]] [tank, [[false]]]; </code> |EXAMPLE2=
<sqf>_FFVTurrets = allTurrets [tank, true] - allTurrets [tank, false];</sqf>


| [[moveInTurret]], [[enablePersonTurret]], [[assignedVehicleRole]], [[fullCrew]], [[turretUnit]], [[turretLocal]], [[turretOwner]], [[BIS_fnc_allTurrets]], [[BIS_fnc_turretConfig]] |SEEALSO=
|seealso= [[moveInTurret]] [[enablePersonTurret]] [[assignedVehicleRole]] [[fullCrew]] [[turretUnit]] [[turretLocal]] [[turretOwner]] [[BIS_fnc_allTurrets]] [[BIS_fnc_turretConfig]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= AgentRev
 
|timestamp= 20160413191300
</dl>
|text= The first syntax (vehicle only without boolean) will include commander turrets like in the example, and does not include actual FFV turrets like offroad back seats, as expected.<br>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on April 13, 2016 - 19:13 (UTC)</dd>
<dt class="note">[[User:AgentRevolution|AgentRev]]</dt>
<dd class="note">
The first syntax (vehicle only without boolean) will include commander turrets like in the example, and does not include actual FFV turrets like offroad back seats, as expected.<br>
<br>
Also, the driver turret [-1] is never included in the results, which can be solved as follows:
Also, the driver turret [-1] is never included in the results, which can be solved as follows:
<code>_paths = [<nowiki/>[-1]] + [[allTurrets]] _vehicle;</code>
<sqf>_paths = [[-1]] + allTurrets _vehicle;</sqf>
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 20:15, 7 April 2024

Hover & click on the images for description

Description

Description:
Returns array of available turret paths from vehicle object.
Groups:
Turrets

Syntax

Syntax:
allTurrets vehicle
Parameters:
vehicle: Object
Return Value:
Array of Arrays format Turret Path

Alternative Syntax

Syntax:
allTurrets [vehicle, includeFFV]
Parameters:
vehicle: Object
includeFFV: Boolean - true to include FFV (Firing From Vehicle) positions, false to exclude them
Return Value:
Array of Arrays format Turret Path

Examples

Example 1:
_turretPaths = allTurrets _mySlammerUP; // [[0],[0,0]] _turretPaths = allTurrets [_mySlammerUP, true]; // [[0],[0,0]] <- commander turret is also an FFV turret _turretPaths = allTurrets [_mySlammerUP, false]; // [[0]]
Example 2:
Return FFV turrets only:
_FFVTurrets = allTurrets [tank, true] - allTurrets [tank, false];

Additional Information

See also:
moveInTurret enablePersonTurret assignedVehicleRole fullCrew turretUnit turretLocal turretOwner BIS_fnc_allTurrets BIS_fnc_turretConfig

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
AgentRev - c
Posted on Apr 13, 2016 - 19:13 (UTC)
The first syntax (vehicle only without boolean) will include commander turrets like in the example, and does not include actual FFV turrets like offroad back seats, as expected.
Also, the driver turret [-1] is never included in the results, which can be solved as follows:
_paths = [[-1]] + allTurrets _vehicle;