getPosASL: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (example)
m (Some wiki formatting)
 
(85 intermediate revisions by 18 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= ofpe
|version1= 1.00


|1.00|= Game version
|game2= arma1
____________________________________________________________________________________________
|version2= 1.00


| Returns the object position height above sea level. |= Description
|game3= arma2
____________________________________________________________________________________________
|version3= 1.00


| [[PositionASL]] <nowiki>=</nowiki> '''getPosASL''' obj |= Syntax
|game4= arma2oa
|version4= 1.50


|p1= obj [[Object]] |= Parameter 1
|game5= tkoh
|version5= 1.00


| [[Array]] |= Return value
|game6= arma3
____________________________________________________________________________________________
|version6= 0.50
 
|x1= <code>_AslPosn<nowiki>=</nowiki>getPosASL [[player]]</code> |= Example 1
|x2= <code>hint format["position above sea level: %1",(getPosASL player) select 2]</code> |= Example 2
____________________________________________________________________________________________


| |= See also
|game7= ofp
|version7= 1.99


|arg= global
|gr1= Positions
|descr= Returns the object position height above sea level.
|s1= [[getPosASL]] object
|p1= object: [[Object]]
|r1= [[Array]] format [[Position#PositionASL|PositionASL]]
|x1= <sqf>_aslPos = getPosASL player;</sqf>
|x2= <sqf>hint format ["position above sea level: %1", (getPosASL player) select 2];</sqf>
|seealso= [[getPosASLVisual]] [[setPosASL]] [[setPosASL2]] [[position]] [[getPos]] [[getPosATL]] [[getPosASLW]] [[visiblePosition]] [[visiblePositionASL]] [[getTerrainHeightASL]] [[setUnitFreefallHeight]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Dr Eyeball
<!-- Note Section BEGIN -->
|timestamp= 20070223073800
|text= <sqf inline>getPosASL _obj select 2;</sqf> 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 {{Link|link= http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?s=e587356595b907e91f96b8817d7f8a26;act=ST;f=71;t=57918|text= 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. {{Name|arma1|short}} Ver '''1.02'''.
}}


<dd class="notedate">Posted on 23 Feb, 2007</dd>
{{Note
<dt class="note">'''[[User:Dr_Eyeball|Dr_Eyeball]]'''</dt><dd class="note">
|user= SilentKiller
getPosASL obj select 2
|timestamp= 20140327191900
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 [http://www.flashpoint1985.com/cgi-bin/ikonboard311/ikonboard.cgi?s=e587356595b907e91f96b8817d7f8a26;act=ST;f=71;t=57918 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'''.
|text= According to [[Code_Optimisation#getPos.2A_and_setPos.2A|Code Optimisation]], this command is among the fastest (2x) and should be used (or [[getPosATL]] or, best performance-wise, [[getPosWorld]]) instead of [[getPos]]/[[position]].
</dd>
}}
<!-- Note Section END -->
</dl>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|GETPOSASL]]
[[Category:Scripting Commands OFP Elite |GETPOSASL]]
[[Category:Scripting Commands ArmA|GETPOSASL]]
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]

Latest revision as of 20:40, 7 April 2024

Hover & click on the images for description

Description

Description:
Returns the object position height above sea level.
Groups:
Positions

Syntax

Syntax:
getPosASL object
Parameters:
object: Object
Return Value:
Array format PositionASL

Examples

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

Additional Information

See also:
getPosASLVisual setPosASL setPosASL2 position getPos getPosATL getPosASLW visiblePosition visiblePositionASL getTerrainHeightASL setUnitFreefallHeight

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
Dr Eyeball - c
Posted on Feb 23, 2007 - 07:38 (UTC)
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 (dead link) 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.
SilentKiller - c
Posted on Mar 27, 2014 - 19:19 (UTC)
According to Code Optimisation, this command is among the fastest (2x) and should be used (or getPosATL or, best performance-wise, getPosWorld) instead of getPos/position.