BIS fnc ambientFlyby: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \| *(\[[^ ]+\] (call|spawn) ('''|\[\[)BI(N|S)_fnc_[a-zA-Z0-9_]+('''|\]\]));? \| *p1 *=" to " |s1=$1 |p1=")
m (Text replacement - "{{Feature | Informative | " to "{{Feature|informative|")
 
(10 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=function
{{RV|type=function


| arma3
|game1= arma3
 
|version1= 1.00
|1.00


|gr1= Ambient
|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.{{Feature | Informative | Created vehicle is [[setCaptive|set captive]], making its side [[civilian]].}}
|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]].}}


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


|p1= startPos: [[PositionATL]] - start position of the air unit
|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
|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
|p3= altitude: [[Number]] - (Optional, default 100) height at which air unit will spawn and fly above ground level
Line 23: Line 23:
|p6= side: [[Side]] - (Optional, default [[west]]) side to which the vehicle belongs
|p6= side: [[Side]] - (Optional, default [[west]]) side to which the vehicle belongs


|r1=[[Boolean]] - [[true]] if function executed successfully.
|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>
// 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>
|x2= <sqf>[getPosATL player, getPosATL opforUnit, 400, "FULL", "B_Heli_Light_01_Armed_F", west] call BIS_fnc_ambientFlyby;</sqf>


|seealso= [[createVehicle]], [[BIS_fnc_spawnVehicle]]
|seealso= [[createVehicle]] [[BIS_fnc_spawnVehicle]]
}}
}}

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