getPos

From Bohemia Interactive Community
Revision as of 14:09, 31 August 2019 by Lou Montana (talk | contribs) (Text replacement - "|= Comments" to "|Comments=")
Jump to navigation Jump to search
Hover & click on the images for description

Description

Description:
Returns the object position in format PositionAGLS. Z value is height over the surface underneath.

Since Arma 3 v1.55.133361, an alternative syntax is added that allows to get position given distance and heading away from original object or position, the equivalent of BIS fnc relPos
Groups:
Uncategorised

Syntax

Syntax:
getPos object
Parameters:
object: Object or Location
Return Value:
Array - format PositionAGLS

Alternative Syntax

Syntax:
origin getPos [distance, heading]         (Since Arma 3 v1.55.133361)
Parameters:
origin: Object, Position2D or Position3D
[distance, heading]: Array
distance: Number - distance from position
heading: Number - in which compass direction
Return Value:
Array - format [x,y,z], where z is land surface in format PositionAGL

Examples

Example 1:
hintSilent str getPos player;
Example 2:
getPos vs. other methods (over sea) diag log getPos ship; // [2412.01, 6036.33, -0.839965] diag log getPosATL ship; // [2412.01, 6036.33, 19.4266] diag log getPosASL ship; // [2412.01, 6036.33, -0.920066] diag log getPosASLW ship; // [2412.01, 6036.33, -0.865981] diag log visiblePosition ship; // [2412.02, 6036.33, -0.837952] diag log visiblePositionASL ship; // [2412.02, 6036.33, -0.91798] diag log position ship; // [2412.01, 6036.33, -0.839965]
Example 3:
getPos vs. other methods (over land) diag log getPos car; // [2508.64, 5681.47, 0.0609589] diag log getPosATL car; // [2508.64, 5681.47, 0.0356369] diag log getPosASL car; // [2508.64, 5681.47, 71.718] diag log getPosASLW car; // [2508.64, 5681.47, 71.718] diag log visiblePosition car; // [2508.64, 5681.47, 0.0609512] diag log visiblePositionASL car; // [2508.64, 5681.47, 71.718] diag log position car; // [2508.64, 5681.47, 0.0609589]
Example 4:
Find position 100 metres and 45 degrees from player position:player getPos [100,45];

Additional Information

See also:
getPosVisualgetRelPossetPossetPosAGLSpositiongetPosATLgetPosASLgetPosASLWvisiblePositionvisiblePositionASLgetMarkerPos

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

Notes

Posted on 16 Feb, 2007
Dr_Eyeball
getPos obj select 2 might return the vertical position above ground level, but for a stacked object, it returns the vertical position above the object beneath it. The same problem exists for getPosASL. There was a discussion thread in the BIS forums which suggested the use of the command modelToWorld instead to get around this issue where an absolute vertical position is required. ArmA Ver 1.02.
Posted on 23 Nov, 2011
Tankbuster
You can use getPos and setPos on triggers.

Bottom Section