getPosASL: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]OFP[ _]Elite *(\|.*)?\]\]" to "{{GameCategory|ofpe|Scripting Commands}}")
mNo edit summary
(42 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


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


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


|game2= ofp |Game2 name=
|game3= arma2
|version3= 1.00


|version2= 1.99 |Game2 version=
|game4= arma2oa
|version4= 1.50


|arg= global |Multiplayer Arguments=
|game5= tkoh
|version5= 1.00


|gr1= Positions |GROUP1=
|game6= arma3
____________________________________________________________________________________________
|version6= 0.50


| Returns the object position height above sea level. |DESCRIPTION=
|game7= ofp
____________________________________________________________________________________________
|version7= 1.99


| [[Array]] <nowiki>=</nowiki> '''getPosASL''' object |SYNTAX=
|arg= global


|p1= object: [[Object]] |PARAMETER1=
|gr1= Positions


| [[Array]] - format [[PositionASL]] |RETURNVALUE=
|descr= Returns the object position height above sea level.
____________________________________________________________________________________________
 
|x1= <code>_AslPos = [[getPosASL]] [[player]];</code> |EXAMPLE1=


|x2= <code>[[hint]] [[format]] ["position above sea level: %1", ([[getPosASL]] [[player]]) [[select]] 2];</code> |EXAMPLE2=
|s1= [[getPosASL]] object
____________________________________________________________________________________________


| [[getPosASLVisual]], [[setPosASL]], [[setPosASL2]], [[position]], [[getPos]], [[getPosATL]], [[getPosASLW]], [[visiblePosition]], [[visiblePositionASL]], [[getTerrainHeightASL]] |SEEALSO=
|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>
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->


<dd class="notedate">Posted on 23 Feb, 2007
<dt><dt>
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]
<dd class="notedate">Posted on 23 Feb, 2007</dd>
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]</dt>
<dd class="note">
<dd class="note">
<code>[[getPosASL]] _obj [[select]] 2;</code>  
<sqf>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 [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'''.
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. ArmA Ver '''1.02'''.
</dd>


<dd class="notedate">Posted on 27 Mar, 2014
<dt><dt>
<dt class="note">[[User:Floriangeyer|Floriangeyer]]
<dd class="notedate">Posted on 27 Mar, 2014</dd>
<dt class="note">[[User:Floriangeyer|Floriangeyer]]</dt>
<dd class="note">
<dd class="note">
According to [[Code Optimisation]], this function is the fastest (2x) and should be used instead of [[getPos]], [[getPosATL]] and [[position]].
According to [[Code_Optimisation#getPos.2A_and_setPos.2A|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: <code>[[ASLtoATL]] [[getPosASL]] [[Object]];</code>
Conversion keep this speed ratio and is structured like: <sqf>ASLToATL getPosASL Object;</sqf>
</dd>


<!-- Note Section END -->
<dt></dt>
</dl>
<dd class="notedate">Posted on 2018-06-01 - 09:36 (UTC)</dd>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
{{GameCategory|ofpe|Scripting Commands}}
{{GameCategory|arma1|Scripting Commands}}
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on June 1, 2018 - 09:36 (UTC)</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dd class="note">
<dd class="note">
Further to Florians post, getPosASL is indeed faster than position and getpos, but is no faster that getposATL
Further to Florian's post, getPosASL is indeed faster than position and getpos, but is no faster that getposATL
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 22:29, 28 September 2023

ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50Logo A0.png1.99
GAGlobal
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
Posted on 23 Feb, 2007
Dr_Eyeball
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.
Posted on 27 Mar, 2014
Floriangeyer
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;
Posted on 2018-06-01 - 09:36 (UTC)
Tankbuster
Further to Florian's post, getPosASL is indeed faster than position and getpos, but is no faster that getposATL
Retrieved from "https://community.bistudio.com/wiki?title=getPosASL&oldid=347611"