getPos: Difference between revisions
Jump to navigation
Jump to search
m (syntax format) |
Killzone Kid (talk | contribs) (alt syntax) |
||
(7 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{Command|= | {{Command|Comments= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| ofp | | | ofp |Game name= | ||
|1.00| | |1.00|Game version= | ||
|arg= global |= | |arg= global |Multiplayer Arguments= | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| Returns the object | | 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= | ||
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]]|= | |||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| '''getPos''' object |= | | '''getPos''' object |SYNTAX= | ||
|p1 = object: [[Object | |p1 = object: [[Object]]|PARAMETER1= | ||
| [[Array]] - format [[PositionAGLS]] |= | | [[Array]] - format [[PositionAGLS]] |RETURNVALUE= | ||
| s2= | | s2= '''getPos''' location |SYNTAX2= | ||
| r2= [[Array]] - format [x,y,z], where z is land surface in format [[PositionAGL]] |= | |p21= location: [[Location]] |PARAMETER21= | ||
| r2= [[Array]] - format [x,y,z], where z is <tt>-1 * [[getTerrainHeightASL]]</tt> at the location |RETURNVALUE2= | |||
| s3= origin '''getPos''' [distance, heading] (''Since Arma 3 v1.55.133361'') |SYNTAX3= | |||
|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= | |||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
|x1 = <code>[[hintSilent]] [[str]] [[getPos]] [[player]];</code> |= | |x1 = <code>[[hintSilent]] [[str]] [[getPos]] [[player]];</code> |EXAMPLE1= | ||
|x2 = [[getPos]] vs. other methods (over sea) | |x2 = [[getPos]] vs. other methods (over sea) | ||
Line 34: | Line 39: | ||
[[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> |= | [[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) | ||
Line 43: | Line 48: | ||
[[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> |= | [[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> |= | |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]] |= | | [[getPosVisual]], [[getRelPos]], [[setPos]], [[Position#setPosAGLS|setPosAGLS]], [[position]], [[getPosATL]], [[getPosASL]], [[getPosASLW]], [[visiblePosition]], [[visiblePositionASL]], [[getMarkerPos]] |SEEALSO= | ||
}} | }} | ||
Line 58: | Line 63: | ||
getPos obj select 2 | 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 [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 class="notedate">Posted on 23 Nov, 2011 | <dd class="notedate">Posted on 23 Nov, 2011 |
Revision as of 17:18, 17 November 2019
Description
- 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. 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
- Groups:
- Uncategorised
Syntax 1
- Syntax:
- getPos object
- Parameters:
- object: Object
- Return Value:
- Array - format PositionAGLS
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] (Since Arma 3 v1.55.133361)
- Parameters:
- origin: Object, Position2D or Position3D
- [distance, heading]: Array
- distance: Number - distance from position
- heading: Number - in which compass direction
- Return Value:
- Array - format [x,y,z], where z is land surface in format PositionAGL
Examples
- Example 1:
hintSilent str getPos player;
- Example 2:
- getPos vs. other methods (over sea)
diag_log getPos ship; // [2412.01, 6036.33, -0.839965] diag_log getPosATL ship; // [2412.01, 6036.33, 19.4266] diag_log getPosASL ship; // [2412.01, 6036.33, -0.920066] diag_log getPosASLW ship; // [2412.01, 6036.33, -0.865981] diag_log visiblePosition ship; // [2412.02, 6036.33, -0.837952] diag_log visiblePositionASL ship; // [2412.02, 6036.33, -0.91798] diag_log position ship; // [2412.01, 6036.33, -0.839965]
- Example 3:
- getPos vs. other methods (over land)
diag_log getPos car; // [2508.64, 5681.47, 0.0609589] diag_log getPosATL car; // [2508.64, 5681.47, 0.0356369] diag_log getPosASL 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 visiblePositionASL car; // [2508.64, 5681.47, 71.718] diag_log position car; // [2508.64, 5681.47, 0.0609589]
- Example 4:
- Find position 100 metres and 45 degrees from player position:
player getPos [100,45];
Additional Information
- See also:
- getPosVisualgetRelPossetPossetPosAGLSpositiongetPosATLgetPosASLgetPosASLWvisiblePositionvisiblePositionASLgetMarkerPos
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
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
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Command Group: Uncategorised
- Scripting Commands OFP 1.99
- Scripting Commands OFP 1.96
- Scripting Commands OFP 1.46
- Scripting Commands ArmA
- Command Group: Object Information
- Scripting Commands ArmA2
- Scripting Commands Arma 3
- Scripting Commands Take On Helicopters