allTurrets: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|seealso= *\[\[([^ ]+)\]\], \[\[([^ ]+)\]\]" to "|seealso= $1 $2")
m (Some wiki formatting)
 
(18 intermediate revisions by the same user not shown)
Line 6: Line 6:
|gr1= Turrets
|gr1= Turrets


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


{{Feature|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]]
* to get config from turret path, use [[BIS_fnc_turretConfig]]
}}
}}


Line 17: Line 17:
|p1= vehicle: [[Object]]
|p1= vehicle: [[Object]]


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


|s2= [[allTurrets]] [vehicle, includeFFV]
|s2= [[allTurrets]] [vehicle, includeFFV]
Line 25: Line 25:
|p22= includeFFV: [[Boolean]] - [[true]] to include FFV (Firing From Vehicle) positions, [[false]] to exclude them
|p22= includeFFV: [[Boolean]] - [[true]] to include FFV (Firing From Vehicle) positions, [[false]] to exclude them


|r2= [[Array]]
|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>
_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>
<sqf>_FFVTurrets = allTurrets [tank, true] - allTurrets [tank, false];</sqf>


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


{{Note
{{Note
|user= AgentRevolution
|user= AgentRev
|timestamp= 20160413191300
|timestamp= 20160413191300
|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>
|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>
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>
}}
}}

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;