BIS fnc position: Difference between revisions

Latest revision as of 00:24, 2 February 2024

1.00

0.50

Hover & click on the images for description

Description

Description:: Returns PositionAGL, unless passed argument is Array, then the same array is returned. When position is Object and alternative position is stored in "BIS_fnc_position_forced" variable on this object, the stored position is used rather than actual object position. This function is a pretty safe way to get the position of an entity.
Execution:: call
Groups:: Positions

Syntax

Syntax:

argument call BIS_fnc_position

Parameters:

argument - could be one of:

Array - Position in format [x, y] or [x, y ,z]
Object - Object
Group - Group, group leader position is used
Location - Location
String - Marker or variable name containing object

ⓘ

To get the position of an Eden Entity use _entity get3DENAttribute "Position" select 0;.

Return Value:

Array - position in format [x, y] or [x, y ,z]

Examples

Example 1:: private _pos = player call BIS_fnc_position;

Additional Information

See also:: Position

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

@@ Line 1: / Line 1: @@
+{{RV|type=function
-{{Function|Comments=
+|game1= tkoh
-____________________________________________________________________________________________
+|version1= 1.00
-| tkoh |Game name=
+|game2= arma3
+|version2= 0.50
-|1.00|Game version=
+|gr1= Positions
-____________________________________________________________________________________________
-|Returns [[PositionAGL]], unless passed argument is [[Array]], then the same array is returned. When position is [[Object]] and alternative position is stored in <tt>"BIS_fnc_position_forced"</tt> variable on this object, the stored position is used rather than actual object position. |DESCRIPTION=
+|descr= Returns [[Position#PositionAGL|PositionAGL]], unless passed argument is [[Array]], then the same array is returned. When position is [[Object]] and alternative position is stored in {{hl|"BIS_fnc_position_forced"}} variable on this object, the stored position is used rather than actual object position. This function is a pretty safe way to get the position of an entity.
-____________________________________________________________________________________________
-| argument call [[BIS_fnc_position]]|SYNTAX=
+|s1= argument call [[BIS_fnc_position]]
 |p1= argument - could be one of:
-<span>
+* [[Array]] - Position in format {{hl|[x, y]}} or {{hl|[x, y ,z]}}
-* [[Array]] - position in format [x,y] or [x,y,z]
+* [[Object]] - Object
-* [[Object]] - object
+* [[Group]] - Group, group leader position is used
-* [[Group]] - group, group leader position is used
+* [[Location]] - Location
-* [[Location]] - location
+* [[String]] - Marker or variable name containing object
-* [[String]] - marker or variable name containing object
+{{Feature|informative|To get the position of an [[Eden Entity]] use <sqf inline>_entity get3DENAttribute "Position" select 0;</sqf>.}}
-</span>|PARAMETER1=
-| [[Array]] - position in format [x,y] or [x,y,z]|RETURNVALUE=
+|r1= [[Array]] - position in format {{hl|[x, y]}} or {{hl|[x, y ,z]}}
-____________________________________________________________________________________________
-|x1= <code>_pos = [[player]] [[call]] [[BIS_fnc_position]];</code> |=
+|x1= <sqf>private _pos = player call BIS_fnc_position;</sqf>
-____________________________________________________________________________________________
-|[[Position]] |SEEALSO=
+|seealso= [[Position]]
 }}
-<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: Misc|{{uc:position}}]]
-[[Category:Functions|{{uc:position}}]]
-[[Category:{{Name|tkoh}}: Functions|{{uc:position}}]]
-[[Category:{{Name|arma3}}: Functions|{{uc:position}}]]