Difference between revisions of "getPosASL"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (template:command argument fix)
Line 9: Line 9:
| Returns the object position height above sea level. |= Description
| Returns the object position height above sea level. |DESCRIPTION=
| [[Array]] <nowiki>=</nowiki> '''getPosASL''' object |= Syntax
| [[Array]] <nowiki>=</nowiki> '''getPosASL''' object |SYNTAX=
|p1= object: [[Object]] |= Parameter 1
|p1= object: [[Object]] |PARAMETER1=
| [[Array]] - format [[PositionASL]] |= Return value
| [[Array]] - format [[PositionASL]] |RETURNVALUE=
|x1= <code>_AslPos = [[getPosASL]] [[player]];</code> |= Example 1
|x1= <code>_AslPos = [[getPosASL]] [[player]];</code> |EXAMPLE1=
|x2= <code>[[hint]] [[format]] ["position above sea level: %1", ([[getPosASL]] [[player]]) [[select]] 2];</code> |= Example 2
|x2= <code>[[hint]] [[format]] ["position above sea level: %1", ([[getPosASL]] [[player]]) [[select]] 2];</code> |EXAMPLE2=
| [[getPosASLVisual]], [[setPosASL]], [[setPosASL2]], [[position]], [[getPos]], [[getPosATL]], [[getPosASLW]], [[visiblePosition]], [[visiblePositionASL]], [[getTerrainHeightASL]] |= See also
| [[getPosASLVisual]], [[setPosASL]], [[setPosASL2]], [[position]], [[getPos]], [[getPosATL]], [[getPosASLW]], [[visiblePosition]], [[visiblePositionASL]], [[getTerrainHeightASL]] |SEEALSO=

Revision as of 15:40, 7 April 2019

Introduced with Armed Assault version 1.001.00Arguments of this scripting command don't have to be local to the client the command is executed on
Hover & click on the images for descriptions


Returns the object position height above sea level.


Array = getPosASL object
object: Object
Return Value:
Array - format PositionASL


Example 1:
_AslPos = getPosASL player;
Example 2:
hint format ["position above sea level: %1", (getPosASL player) select 2];

Additional Information

See also:


Only post proven facts here. Report bugs on the Feedback Tracker and discuss on the Arma Discord or on the Forums.


Posted on 23 Feb, 2007
getPosASL _obj select 2; might sometimes return the vertical position above sea level, but over land for stacked objects, it returns the vertical position above the object beneath it or at least affected by this offset. The same problem exists for getPos. 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 27 Mar, 2014
According to Code Optimisation, this function is the fastest (2x) and should be used instead of getPos, getPosATL and position. Conversion keep this speed ratio and is structured like: ASLtoATL getPosASL Object;

Bottom Section

Posted on June 1, 2018 - 09:36 (UTC)
Further to Florians post, getPosASL is indeed faster than position and getpos, but is no faster that getposATL