position: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<h3 style="display:none">Bottom Section</h3> " to "")
mNo edit summary
 
(33 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


| ofp
|game1= ofp
|version1=


|1.5
|game2= arma1
|version2= 1.00
 
|game3= arma2
|version3= 1.00
 
|game4= arma2oa
|version4= 1.50
 
|game5= tkoh
|version5= 1.00
 
|game6= arma3
|version6= 0.50


|gr1= Positions
|gr1= Positions


| Returns position of an object (alias of [[getPos]]) or location (alias of [[locationPosition]]).
|descr= Returns position of an object (alias of [[getPos]]) or location (alias of [[locationPosition]]).
 
{{Feature|important|Do '''not''' use this command to get an object's position in 3D. See [[getPos]] for an explanation and alternatives.}}
| [[position]] object
|s1= [[position]] object


|p1= object: [[Object]]
|p1= object: [[Object]]


| [[Array]] - format [[PositionAGLS]]
|r1= [[Array]] format [[Position#PositionAGLS|PositionAGLS]]


|s2= [[position]] location
|s2= [[position]] location


|p21= location: [[Location]] |PARAMETER21=
|p21= location: [[Location]]


|r2= [[Array]] - format [x,y,z], where z is <tt>-1 * [[getTerrainHeightASL]]</tt> at the location
|r2= [[Array]] format [[Position#PositionAGL|PositionAGL]] - see [[locationPosition]]
 
{{Feature|important|This position is the location's position '''regardless of [[attachObject]] usage''' - see {{Link|#Example 3}}.}}
|x1= <code>[[private]] _pos = [[position]] [[player]];</code>


|x2= <code>_myLocationHomePos = [[position]] myLocation;</code>
|x1= <sqf>private _pos = position player;</sqf>


| [[getPos]], [[getPosATL]], [[getPosASL]], [[getPosASLW]], [[visiblePosition]], [[getPosVisual]], [[visiblePositionASL]], [[locationPosition]]
|x2= <sqf>_myLocationHomePos = position myLocation;</sqf>
}}


<h3 style="display:none">Notes</h3>
|x3= <sqf>
<dl class="command_description">
private _location = createLocation ["b_inf", [1000, 1000], 1, 1];
</dl>
_location attachObject player;
locationPosition _location; // [1916.03,5711.98,12.208]
getPos _location; // [1916.03,5711.98,12.208]
position _location; // [1000,1000,0]
</sqf>


[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
|seealso= [[getPos]] [[getPosATL]] [[getPosASL]] [[getPosASLW]] [[visiblePosition]] [[getPosVisual]] [[visiblePositionASL]] [[locationPosition]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}

Latest revision as of 21:32, 28 September 2023

Hover & click on the images for description

Description

Description:
Returns position of an object (alias of getPos) or location (alias of locationPosition).
Do not use this command to get an object's position in 3D. See getPos for an explanation and alternatives.
Groups:
Positions

Syntax

Syntax:
position object
Parameters:
object: Object
Return Value:
Array format PositionAGLS

Alternative Syntax

Syntax:
position location
Parameters:
location: Location
Return Value:
Array format PositionAGL - see locationPosition
This position is the location's position regardless of attachObject usage - see Example 3.

Examples

Example 1:
private _pos = position player;
Example 2:
_myLocationHomePos = position myLocation;
Example 3:
private _location = createLocation ["b_inf", [1000, 1000], 1, 1]; _location attachObject player; locationPosition _location; // [1916.03,5711.98,12.208] getPos _location; // [1916.03,5711.98,12.208] position _location; // [1000,1000,0]

Additional Information

See also:
getPos getPosATL getPosASL getPosASLW visiblePosition getPosVisual visiblePositionASL locationPosition

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