Difference between revisions of "getPos"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "[[Category:Scripting Commands ArmA|" to "[[Category:Scripting Commands Armed Assault|")
m (Some wiki formatting)
Line 9: Line 9:
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| 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]]|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.<br>
 +
The alternative syntax gets the position given distance and heading away from provided object or position - the equivalent of [[BIS_fnc_relPos]]. |DESCRIPTION=
 
____________________________________________________________________________________________
 
____________________________________________________________________________________________
  
| '''getPos''' object |SYNTAX=
+
| [[getPos]] object |SYNTAX=
 +
 
 
|p1 = object: [[Object]]|PARAMETER1=
 
|p1 = object: [[Object]]|PARAMETER1=
 +
 
| [[Array]] - format [[PositionAGLS]] |RETURNVALUE=
 
| [[Array]] - format [[PositionAGLS]] |RETURNVALUE=
 +
____________________________________________________________________________________________
  
| s2= '''getPos''' location |SYNTAX2=
+
|s2= [[getPos]] location |SYNTAX2=
  
 
|p21= location: [[Location]] |PARAMETER21=
 
|p21= location: [[Location]] |PARAMETER21=
  
| r2= [[Array]] - format [x,y,z], where z is <tt>-1 * [[getTerrainHeightASL]]</tt> at the location |RETURNVALUE2=
+
|r2= [[Array]] - format [x,y,z], where z is <tt>-1 * [[getTerrainHeightASL]]</tt> at the location |RETURNVALUE2=
 +
____________________________________________________________________________________________
 +
 
 +
|s3= origin [[getPos]] [distance, heading] {{since|arma3|1.55.133361|y}} |SYNTAX3=
 +
 
 +
|p41= origin: [[Object]], [[Position2D]] or [[Position3D]] |PARAMETER41=
 +
 
 +
|p42=  distance: [[Number]] - distance from position |PARAMETER43=
  
| s3= origin '''getPos''' [distance, heading] &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (''Since Arma 3 v1.55.133361'') |SYNTAX3=
+
|p43=  heading: [[Number]] - in which compass direction |PARAMETER44=
|p41 = origin: [[Object]], [[Position2D]] or [[Position3D]]|PARAMETER41=
 
|p42 =  [distance, heading]: [[Array]]|PARAMETER42=
 
|p43 =  distance: [[Number]] - distance from position|PARAMETER43=
 
|p44 =  heading: [[Number]] - in which compass direction |PARAMETER44=
 
  
 
| r3= [[Array]] - format [x,y,z], where z is land surface in format [[PositionAGL]] |RETURNVALUE3=
 
| r3= [[Array]] - format [x,y,z], where z is land surface in format [[PositionAGL]] |RETURNVALUE3=
Line 33: Line 40:
  
 
|x2 = [[getPos]] vs. other methods (over sea)
 
|x2 = [[getPos]] vs. other methods (over sea)
<code>[[diag_log]] [[getPos]] ship;           // [2412.01, 6036.33, -0.839965]
+
<code>[[diag_log]] [[getPos]] ship; // [2412.01, 6036.33, -0.839965]
[[diag_log]] [[getPosATL]] ship;         // [2412.01, 6036.33, 19.4266]
+
[[diag_log]] [[getPosATL]] ship; // [2412.01, 6036.33, 19.4266]
[[diag_log]] [[getPosASL]] ship;         // [2412.01, 6036.33, -0.920066]
+
[[diag_log]] [[getPosASL]] ship; // [2412.01, 6036.33, -0.920066]
[[diag_log]] [[getPosASLW]] ship;         // [2412.01, 6036.33, -0.865981]
+
[[diag_log]] [[getPosASLW]] ship; // [2412.01, 6036.33, -0.865981]
[[diag_log]] [[visiblePosition]] ship;   // [2412.02, 6036.33, -0.837952]
+
[[diag_log]] [[visiblePosition]] ship; // [2412.02, 6036.33, -0.837952]
[[diag_log]] [[visiblePositionASL]] ship; // [2412.02, 6036.33, -0.91798]
+
[[diag_log]] [[visiblePositionASL]] ship; // [2412.02, 6036.33, -0.91798]
[[diag_log]] [[position]] ship;           // [2412.01, 6036.33, -0.839965]</code> |EXAMPLE2=  
+
[[diag_log]] [[position]] ship; // [2412.01, 6036.33, -0.839965]</code> |EXAMPLE2=  
  
 
|x3 = [[getPos]] vs. other methods (over land)
 
|x3 = [[getPos]] vs. other methods (over land)
<code>[[diag_log]] [[getPos]] car;             // [2508.64, 5681.47, 0.0609589]
+
<code>[[diag_log]] [[getPos]] car; // [2508.64, 5681.47, 0.0609589]
[[diag_log]] [[getPosATL]] car;           // [2508.64, 5681.47, 0.0356369]
+
[[diag_log]] [[getPosATL]] car; // [2508.64, 5681.47, 0.0356369]
[[diag_log]] [[getPosASL]] car;           // [2508.64, 5681.47, 71.718]
+
[[diag_log]] [[getPosASL]] car; // [2508.64, 5681.47, 71.718]
[[diag_log]] [[getPosASLW]] 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]] [[visiblePosition]] car; // [2508.64, 5681.47, 0.0609512]
[[diag_log]] [[visiblePositionASL]] car; // [2508.64, 5681.47, 71.718]
+
[[diag_log]] [[visiblePositionASL]] car; // [2508.64, 5681.47, 71.718]
[[diag_log]] [[position]] car;           // [2508.64, 5681.47, 0.0609589]</code> |EXAMPLE3=
+
[[diag_log]] [[position]] car; // [2508.64, 5681.47, 0.0609589]</code> |EXAMPLE3=
 
 
|x4 = Find position 100 metres and 45 degrees from player position:<code>[[player]] [[getPos]] [100,45];</code> |EXAMPLE4=
 
  
| [[getPosVisual]], [[getRelPos]], [[setPos]], [[Position#setPosAGLS|setPosAGLS]], [[position]], [[getPosATL]], [[getPosASL]], [[getPosASLW]], [[visiblePosition]], [[visiblePositionASL]], [[getMarkerPos]] |SEEALSO=
+
|x4 = Find position 100 metres and 45 degrees from player position:<code>[[player]] [[getPos]] [100, 45];</code> |EXAMPLE4=
  
 +
| [[getPosVisual]], [[getRelPos]], [[setPos]], [[Position#setPosAGLS|setPosAGLS]], [[position]], [[getPosATL]], [[getPosASL]], [[getPosASLW]], [[visiblePosition]], [[visiblePositionASL]], [[getMarkerPos]] |SEEALSO=
 
}}
 
}}
  
Line 59: Line 65:
 
<dl class="command_description">
 
<dl class="command_description">
 
<!-- Note Section BEGIN -->
 
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on 16 Feb, 2007
+
<dd class="notedate">Posted on 16 Feb, 2007</dd>
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]<dd class="note">
+
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]</dt>
getPos obj select 2  
+
<dd class="note">
 +
<code>[[getPos]] obj [[select]] 2 </code>
 
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 [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 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 [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'''.
 +
</dd>
  
<dd class="notedate">Posted on 23 Nov, 2011
+
<dd class="notedate">Posted on 23 Nov, 2011</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]<dd class="note">
+
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
You can use getPos and setPos on triggers.  
+
<dd class="note">
 +
You can use [[getPos]] and [[setPos]] on triggers.  
 +
</dd>
  
 
<!-- Note Section END -->
 
<!-- Note Section END -->
Line 72: Line 82:
  
 
<h3 style="display:none">Bottom Section</h3>
 
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|GETPOS]]
+
[[Category:Scripting Commands OFP 1.46|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Scripting Commands OFP 1.96|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands OFP 1.99|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.96|GETPOS]]
+
[[Category:Scripting Commands Armed Assault|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands OFP 1.46|GETPOS]]
 
[[Category:Scripting Commands Armed Assault|GETPOS]]
 
[[Category:Command_Group:_Object_Information|{{uc:{{PAGENAME}}}}]]
 
 
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 2|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
 
[[Category:Scripting Commands Take On Helicopters|{{uc:{{PAGENAME}}}}]]
 +
[[Category:Command Group: Object Information|{{uc:{{PAGENAME}}}}]]

Revision as of 19:28, 8 August 2020

Template:Command

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