getPos

1.00

Hover & click on the images for descriptions

Description

Description:

Returns object or location position. If the argument is the object, the return value is 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

Syntax

Syntax:

getPos object

Parameters:

object: Object

Return Value:

Array - format PositionAGLS

Alternative Syntax

Syntax:

getPos location

Parameters:

location: Location

Return Value:

Array - format [x,y,z], where z is -1 * getTerrainHeightASL at the location

Alternative Syntax 2

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

i

Only post proven facts here. Report bugs on the feedback tracker. Use the Talk page or the Forums for discussions.

Add New Note | How To

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.