Difference between revisions of "getPos"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|seealso= *\[\[([^ ]+)\]\], \[\[([^ ]+)\]\]" to "|seealso= $1 $2")
m (Some wiki formatting)
 
(22 intermediate revisions by the same user not shown)
Line 31: Line 31:
 
{{Feature|important|
 
{{Feature|important|
 
Do '''not''' use this command to get an object's position in 3D format:
 
Do '''not''' use this command to get an object's position in 3D format:
* the Z value from this command is '''relative''' to the surface underneath, and there is no compatible setter command to use it with;<br>the commonly misused code: {{ic|_obj1 [[setPos]] [[getPos]] _obj2}} is '''absolutely wrong'''
+
* the Z value from this command is '''relative''' to the surface underneath, and there is no compatible setter command to use it with;<br>the commonly misused code: <sqf inline>_obj1 setPos getPos _obj2</sqf> is '''absolutely wrong'''
 
* this command is significantly '''slower''' than other [[:Category:Command Group: Positions|position commands]] because it has to calculate the surface below a position from objects in the (2D) area; its performance therefore suffers from areas with a high density of objects such as cities, and can easily be ~20x slower than other, simpler position commands - see [[Code Optimisation#getPos.2A and setPos.2A|this benchmark]].
 
* this command is significantly '''slower''' than other [[:Category:Command Group: Positions|position commands]] because it has to calculate the surface below a position from objects in the (2D) area; its performance therefore suffers from areas with a high density of objects such as cities, and can easily be ~20x slower than other, simpler position commands - see [[Code Optimisation#getPos.2A and setPos.2A|this benchmark]].
 
The '''only''' correct usage of this command is to determine the altitude of an object '''from the surface below it''' (see {{HashLink|#Example 5}}).
 
The '''only''' correct usage of this command is to determine the altitude of an object '''from the surface below it''' (see {{HashLink|#Example 5}}).
Line 46: Line 46:
 
|p21= location: [[Location]]
 
|p21= location: [[Location]]
  
|r2= [[Array]] format [x,y,z], where Z is {{ic|-1 * [[getTerrainHeightASL]]}} at the location
+
|r2= [[Array]] format [x,y,z], where Z is <sqf inline>-1 * getTerrainHeightASL</sqf> at the location
  
 
|s3= origin [[getPos]] [distance, heading]
 
|s3= origin [[getPos]] [distance, heading]
Line 60: Line 60:
 
|r3= [[Array]] - format [x,y,z], where z is land surface position in format [[Position#PositionAGL|PositionAGL]]
 
|r3= [[Array]] - format [x,y,z], where z is land surface position in format [[Position#PositionAGL|PositionAGL]]
  
|x1= <code>[[hintSilent]] [[str]] [[getPos]] [[player]];</code>
+
|x1= <sqf>hintSilent str getPos player;</sqf>
  
 
|x2= [[getPos]] vs. other methods (over sea). Pay attention to Z values:
 
|x2= [[getPos]] vs. other methods (over sea). Pay attention to Z values:
<code>[[getPos]] ship; {{cc|[2412.01, 6036.33, -0.839965]}}
+
<sqf>
[[getPosATL]] ship; {{cc|[2412.01, 6036.33, 19.4266]}}
+
getPos ship; // [2412.01, 6036.33, -0.839965]
[[getPosASL]] ship; {{cc|[2412.01, 6036.33, -0.920066]}}
+
getPosATL ship; // [2412.01, 6036.33, 19.4266]
[[getPosASLW]] ship; {{cc|[2412.01, 6036.33, -0.865981]}}
+
getPosASL ship; // [2412.01, 6036.33, -0.920066]
[[visiblePosition]] ship; {{cc|[2412.02, 6036.33, -0.837952]}}
+
getPosASLW ship; // [2412.01, 6036.33, -0.865981]
[[visiblePositionASL]] ship; {{cc|[2412.02, 6036.33, -0.91798]}}
+
visiblePosition ship; // [2412.02, 6036.33, -0.837952]
[[position]] ship; {{cc|[2412.01, 6036.33, -0.839965]}}</code>
+
visiblePositionASL ship; // [2412.02, 6036.33, -0.91798]
 +
position ship; // [2412.01, 6036.33, -0.839965]
 +
</sqf>
  
 
|x3= [[getPos]] vs. other methods (over land, on top of a 100m high building). Pay attention to Z values:
 
|x3= [[getPos]] vs. other methods (over land, on top of a 100m high building). Pay attention to Z values:
<code>[[getPos]] car; {{cc|[2508.64, 5681.47, 0.0609589]}}
+
<sqf>
[[getPosATL]] car; {{cc|[2508.64, 5681.47, 100.0356369]}}
+
getPos car; // [2508.64, 5681.47, 0.0609589]
[[getPosASL]] car; {{cc|[2508.64, 5681.47, 171.718]}}
+
getPosATL car; // [2508.64, 5681.47, 100.0356369]
[[getPosASLW]] car; {{cc|[2508.64, 5681.47, 171.718]}}
+
getPosASL car; // [2508.64, 5681.47, 171.718]
[[visiblePosition]] car; {{cc|[2508.64, 5681.47, 0.0609512]}}
+
getPosASLW car; // [2508.64, 5681.47, 171.718]
[[visiblePositionASL]] car; {{cc|[2508.64, 5681.47, 171.718]}}
+
visiblePosition car; // [2508.64, 5681.47, 0.0609512]
[[position]] car; {{cc|[2508.64, 5681.47, 0.0609589]}}</code>
+
visiblePositionASL car; // [2508.64, 5681.47, 171.718]
 +
position car; // [2508.64, 5681.47, 0.0609589]
 +
</sqf>
  
|x4= Find position 100 metres and 45 degrees from player position:<code>[[player]] [[getPos]] [100, 45];</code>
+
|x4= Find position 100 metres and 45 degrees from player position:
 +
<sqf>player getPos [100, 45];</sqf>
  
 
|x5= Determine if a free-falling unit is close enough to the surface (including buildings, aircraft carriers etc) below to deploy the parachute:
 
|x5= Determine if a free-falling unit is close enough to the surface (including buildings, aircraft carriers etc) below to deploy the parachute:
<code>[[waitUntil]] { [[sleep]] 1; [[getPos]] [[player]] [[select]] 2 [[a_less_b|<]] 200 };
+
<sqf>waitUntil { sleep 1; getPos player select 2 < 200 };
[[hint]] "Deploying a parachute might be a good idea";</code>
+
hint "Deploying a parachute might be a good idea";</sqf>
  
|seealso= [[getPosVisual]] [[getRelPos]] [[setPos]] [[Position#setPosAGLS|setPosAGLS]] [[position]] [[getPosATL]] [[getPosASL]] [[getPosASLW]] [[visiblePosition]] [[visiblePositionASL]], [[getMarkerPos]]
+
|seealso= [[getPosVisual]] [[getRelPos]] [[setPos]] [[Position#setPosAGLS|setPosAGLS]] [[position]] [[getPosATL]] [[getPosASL]] [[getPosASLW]] [[visiblePosition]] [[visiblePositionASL]] [[getMarkerPos]]
 
}}
 
}}
  
<dl class="command_description">
+
{{Note
 
+
|user= Dr_Eyeball
<dt></dt>
+
|timestamp= 20070217134300
<dd class="notedate">Posted on 16 Feb, 2007</dd>
+
|text= <sqf inline>getPos obj select 2</sqf> 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 existed for [[getPosASL]] ('''pre-Arma 2 games only'''). 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'''.
<dt class="note">[[User:Dr_Eyeball|Dr_Eyeball]]</dt>
+
}}
<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 existed for [[getPosASL]] ('''pre-Arma 2 games only'''). There was a {{ExternalLink|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>
 
 
 
<dt><dt>
 
<dd class="notedate">Posted on 23 Nov, 2011</dd>
 
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
 
<dd class="note">
 
You can use [[getPos]] and [[setPos]] on triggers.
 
</dd>
 
 
 
</dl>
 

Latest revision as of 14:20, 25 July 2022

Hover & click on the images for description

Description

Description:
Returns object or location position. If the argument is an object, the return value is in format PositionAGLS.
The alternative syntax gets the position given distance and heading away from provided object or position - the command equivalent of BIS_fnc_relPos.
Do not use this command to get an object's position in 3D format:
  • the Z value from this command is relative to the surface underneath, and there is no compatible setter command to use it with;
    the commonly misused code: _obj1 setPos getPos _obj2 is absolutely wrong
  • this command is significantly slower than other position commands because it has to calculate the surface below a position from objects in the (2D) area; its performance therefore suffers from areas with a high density of objects such as cities, and can easily be ~20x slower than other, simpler position commands - see this benchmark.
The only correct usage of this command is to determine the altitude of an object from the surface below it (see Example 5).
Groups:
Positions

Syntax 1

Syntax:
getPos object
Parameters:
object: Object
Return Value:
Array format PositionAGLS where Z is the height over the surface underneath

Syntax 2

Syntax:
getPos location
Parameters:
location: Location
Return Value:
Array format [x,y,z], where Z is -1 * getTerrainHeightASL at the location

Syntax 3

Syntax:
origin getPos [distance, heading]
Parameters:
origin: Object, Position2D or Position3D
distance: Number - distance from position
heading: Number - in which compass direction
Return Value:
Array - format [x,y,z], where z is land surface position in format PositionAGL

Examples

Example 1:
Example 2:
getPos vs. other methods (over sea). Pay attention to Z values:
getPos ship; // [2412.01, 6036.33, -0.839965] getPosATL ship; // [2412.01, 6036.33, 19.4266] getPosASL ship; // [2412.01, 6036.33, -0.920066] getPosASLW ship; // [2412.01, 6036.33, -0.865981] visiblePosition ship; // [2412.02, 6036.33, -0.837952] visiblePositionASL ship; // [2412.02, 6036.33, -0.91798] position ship; // [2412.01, 6036.33, -0.839965]
Example 3:
getPos vs. other methods (over land, on top of a 100m high building). Pay attention to Z values:
getPos car; // [2508.64, 5681.47, 0.0609589] getPosATL car; // [2508.64, 5681.47, 100.0356369] getPosASL car; // [2508.64, 5681.47, 171.718] getPosASLW car; // [2508.64, 5681.47, 171.718] visiblePosition car; // [2508.64, 5681.47, 0.0609512] visiblePositionASL car; // [2508.64, 5681.47, 171.718] position car; // [2508.64, 5681.47, 0.0609589]
Example 4:
Find position 100 metres and 45 degrees from player position:
player getPos [100, 45];
Example 5:
Determine if a free-falling unit is close enough to the surface (including buildings, aircraft carriers etc) below to deploy the parachute:
waitUntil { sleep 1; getPos player select 2 < 200 }; hint "Deploying a parachute might be a good idea";

Additional Information

See also:
getPosVisual getRelPos setPos setPosAGLS position getPosATL getPosASL getPosASLW visiblePosition visiblePositionASL getMarkerPos

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
Posted on Feb 17, 2007 - 13:43 (UTC)
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 existed for getPosASL (pre-Arma 2 games only). 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.