BIS fnc relPos: Difference between revisions

Latest revision as of 14:07, 13 July 2022

1.00

1.50

1.00

0.50

Hover & click on the images for description

Description

Description:: Returns a position that is a specified distance and compass direction from the passed position or object.
In Arma 3 use getPos' alternative syntax instead.
Execution:: call
Groups:: Positions Geometry

Syntax

Syntax:: [origin, distance, direction] call BIS_fnc_relPos
Parameters:: origin: Object or Position - object or position which should be used as initial point.
: distance: Number - distance from initial point
: direction: Number - direction from the intial position
Return Value:: Position

Examples

Example 1:: [[0,0,0], 1000, 50] call BIS_fnc_relPos; // [766.044,642.788,0]

Additional Information

See also:: getPos

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

Lawman Actual - c: Posted on Jan 07, 2016 - 19:26 (UTC)
: The function appears to work in two dimensions, and as such can be used to find the position of a target relative to the player if bearing and distance are known. However, if there is a significant change in elevation between yourself and the target, the distance registered on a rangefinder (which is measuring in a 3-dimensional straight line) will always be larger than the two-dimensional value required for BIS_fnc_relPos and as such air-strikes and ordnance called in using such a function can miss by several hundred metres in extreme cases. Currently searching for a method which incorporates the azimuth of the rangefinder in calculation.

@@ Line 1: / Line 1: @@
 {{RV|type=function
-|arma2
+|game1= arma2
+|version1= 1.00
-|1.00
+|game2= arma2oa
+|version2= 1.50
-|gr1 = Positions
+|game3= tkoh
+|version3= 1.00
-|gr2 = Geometry
+|game4= arma3
+|version4= 0.50
-|Returns a position that is a specified distance and compass direction from the passed position or object. {{Feature|arma3|In Arma 3 use [[getPos]] instead.}}
+|gr1= Positions
-|[start, distance, direction] call '''BIS_fnc_relPos'''
+|gr2= Geometry
-|p1= start: [[Object]] or [[Position]] - Object or position which should be used as initial point.
+|descr= Returns a position that is a specified distance and compass direction from the passed position or object.
+{{Feature|arma3|In {{arma3}} use [[getPos]]' [[getPos#Syntax 3|alternative syntax]] instead.}}
-|p2= distance: [[Number]] - Distance from initial point.
+|s1= [origin, distance, direction] call [[BIS_fnc_relPos]]
-|p3= direction: [[Number]] - Direction from the intial position.
+|p1= origin: [[Object]] or [[Position]] - object or position which should be used as initial point.
-|[[Position]]
+|p2= distance: [[Number]] - distance from initial point
-|x1= <code>[ [0,0,0], 1000, 50 ] [[call]] '''BIS_fnc_relPos''';//[766.044,642.788,0]</code>
+|p3= direction: [[Number]] - direction from the intial position
-|[[getPos]]
+|r1= [[Position]]
-}}
+|x1= <sqf>[[0,0,0], 1000, 50] call BIS_fnc_relPos; // [766.044,642.788,0]</sqf>
+|seealso= [[getPos]]
+}}
-[[Category:Functions|{{uc:relPos}}]]
+{{Note
-[[Category:{{Name|arma2}}: Functions|{{uc:relPos}}]]
+|user= Lawman Actual
-[[Category:{{Name|arma2oa}}: Functions|{{uc:relPos}}]]
+|timestamp= 20160107192600
-[[Category:{{Name|tkoh}}: Functions|{{uc:relPos}}]]
+|text= The function appears to work in two dimensions, and as such can be used to find the position of a target relative to the player if bearing and distance are known.
-[[Category:{{Name|arma3}}: Functions|{{uc:relPos}}]]
-<!-- CONTINUE Notes -->
+However, if there is a significant change in elevation between yourself and the target, the distance registered on a rangefinder (which is measuring in a 3-dimensional straight line) will always be larger than the two-dimensional value required for [[BIS_fnc_relPos]] and as such air-strikes and ordnance called in using such a function can miss by several hundred metres in extreme cases.
-<dl class="command_description">
-<dd class="notedate">Posted on January 7, 2016 - 19:26 (UTC)</dd>
-<dt class="note">[[User:Lawman Actual|Lawman Actual]]</dt>
-<dd class="note">
-The function appears to work in two dimensions, and as such can be used to find the position of a target relative to the player if bearing and distance are known.
+Currently searching for a method which incorporates the azimuth of the rangefinder in calculation.
+}}
-However, if there is a significant change in elevation between yourself and the target, the distance registered on a ragefinder (which is measuring a 3 dimensional straight line) will always be larger than the two-dimensional value required for BIS_fnc_relPos and as such air-strikes and ordnance called in using such a function can miss by several hundred metres in extreme cases.
-Currently searching for a method which incorporates the azimuth of the rangefinder in calculation.
-</dd>
-</dl>
-<!-- DISCONTINUE Notes -->