BIS fnc ambientFlyby: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " {{Function|Comments=" to "{{Function|Comments=")
m (Text replacement - "{{Feature | Informative | " to "{{Feature|informative|")
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.00


|1.00|Game version=
|gr1= Ambient
____________________________________________________________________________________________


| Spawns an air unit that moves from point A to point B, never engaging nor being engaged. It is set as captive and will despawn once it reaches its destination.{{Informative | Created vehicle is [[setCaptive|set captive]], making its side [[civilian]].}} |DESCRIPTION=
|descr= Spawns an air unit that moves from point A to point B, never engaging nor being engaged. It is set as captive and will despawn once it reaches its destination.
____________________________________________________________________________________________
{{Feature|informative|Created vehicle is [[setCaptive|set captive]], making its side [[civilian]].}}


| [startPos, endPos, altitude, speedMode, classname, side] call [[BIS_fnc_ambientFlyby]]; |SYNTAX=
|s1= [startPos, endPos, altitude, speedMode, classname, side] call [[BIS_fnc_ambientFlyby]]


|p1= startPos: [[PositionATL]] - start position of the air unit |Parameter1=
|p1= startPos: [[Position]] - start position of the air unit. The Z value does not matter and is replaced by ''altitude''


|p2= endPos: [[PositionAGL]] - end position where the air unit moves to and despawns |Parameter2=
|p2= endPos: [[Array]] format [[Position#PositionAGL|PositionAGL]] - end position where the air unit moves to and despawns (through [[addWaypoint]])


|p3= altitude: [[Number]] - (Optional, default 100) height at which air unit will spawn and fly above ground level |Parameter3=
|p3= altitude: [[Number]] - (Optional, default 100) height at which air unit will spawn and fly above ground level


|p4= speedMode: [[String]] - (Optional, default "NORMAL") [[speedMode|speed mode]] at which air unit travels. Possible values are "LIMITED", "NORMAL" and "FULL" |Parameter4=
|p4= speedMode: [[String]] - (Optional, default "NORMAL") [[speedMode|speed mode]] at which air unit travels. Possible values are "LIMITED", "NORMAL" and "FULL"


|p5= classname: [[String]] - (Optional, default "B_Heli_Light_01_F") vehicle classname defined in [[CfgVehicles]] |Parameter5=
|p5= classname: [[String]] - (Optional, default "B_Heli_Light_01_F") vehicle classname defined in [[CfgVehicles]]


|p6= side: [[Side]] - (Optional, default [[west]]) side to which the vehicle belongs |Parameter6=
|p6= side: [[Side]] - (Optional, default [[west]]) side to which the vehicle belongs


| [[Boolean]] - [[true]] if function executed successfully. |RETURNVALUE=
|r1= [[Boolean]] - [[true]] if function executed successfully.
____________________________________________________________________________________________


|x1= <code>{{cc|spawns a Littlebird that flies from position 200,200,50 to 250,250,75 at altitude 100 and normal speed}}
|x1= <sqf>
[<nowiki/>[200,200,50], [250,250,75]] [[call]] [[BIS_fnc_ambientFlyby]];</code> |Example1=
// spawns a Littlebird that flies from position 200,200,50 to 250,250,75 at altitude 100 and normal speed
[[200,200,50], [250,250,75]] call BIS_fnc_ambientFlyby;
</sqf>


|x2 = <code>[<nowiki/>[[getPosATL]] [[player]], [[getPosATL]] opforUnit, 400, "FULL", "B_Heli_Light_01_Armed_F", [[west]]] [[call]] [[BIS_fnc_ambientFlyby]];</code> |Example2=
|x2= <sqf>[getPosATL player, getPosATL opforUnit, 400, "FULL", "B_Heli_Light_01_Armed_F", west] call BIS_fnc_ambientFlyby;</sqf>
____________________________________________________________________________________________


| [[createVehicle]], [[BIS_fnc_spawnVehicle]] |SEEALSO=
|seealso= [[createVehicle]] [[BIS_fnc_spawnVehicle]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Function Group: Ambient|{{uc:ambientFlyby}}]]
[[Category:Functions|{{uc:ambientFlyby}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:ambientFlyby}}]]

Latest revision as of 21:42, 16 May 2024

Hover & click on the images for description

Description

Description:
Spawns an air unit that moves from point A to point B, never engaging nor being engaged. It is set as captive and will despawn once it reaches its destination.
Created vehicle is set captive, making its side civilian.
Execution:
call
Groups:
Ambient

Syntax

Syntax:
[startPos, endPos, altitude, speedMode, classname, side] call BIS_fnc_ambientFlyby
Parameters:
startPos: Position - start position of the air unit. The Z value does not matter and is replaced by altitude
endPos: Array format PositionAGL - end position where the air unit moves to and despawns (through addWaypoint)
altitude: Number - (Optional, default 100) height at which air unit will spawn and fly above ground level
speedMode: String - (Optional, default "NORMAL") speed mode at which air unit travels. Possible values are "LIMITED", "NORMAL" and "FULL"
classname: String - (Optional, default "B_Heli_Light_01_F") vehicle classname defined in CfgVehicles
side: Side - (Optional, default west) side to which the vehicle belongs
Return Value:
Boolean - true if function executed successfully.

Examples

Example 1:
// spawns a Littlebird that flies from position 200,200,50 to 250,250,75 at altitude 100 and normal speed [[200,200,50], [250,250,75]] call BIS_fnc_ambientFlyby;
Example 2:
[getPosATL player, getPosATL opforUnit, 400, "FULL", "B_Heli_Light_01_Armed_F", west] call BIS_fnc_ambientFlyby;

Additional Information

See also:
createVehicle BIS_fnc_spawnVehicle

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