BIS fnc relPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
(page filling, comment cleanup)
Line 1: Line 1:
{{Function|= Comments
{{Function|= Comments
____________________________________________________________________________________________
____________________________________________________________________________________________


| arma2 |= Game name
|arma2|= Game name


|1.00|= Game version
|1.00|= Game version
____________________________________________________________________________________________
____________________________________________________________________________________________


| <pre>
|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.}}|= Description
/************************************************************
____________________________________________________________________________________________
Relative Position


Parameters: [object or position, distance, direction]
|[start, distance, direction] call '''BIS_fnc_relPos'''|= Syntax


Returns a position that is a specified distance and compass
|p1= start: [[Object]] or [[Position]] - Object or position which should be used as initial point.|= Parameter 1
direction from the passed position or object.


Example: [player, 5, 100] call BIS_fnc_relPos
|p2= distance: [[Number]] - Distance from initial point.|= Parameter 2
************************************************************/


</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
|p3= direction: [[Number]] - Direction from the intial position.|= Parameter 3
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_relPos]]; --> |= Syntax
|[[Position]]|= Return value
 
|p1= |= Parameter 1
 
| |= Return value
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1= <code>
|x1= <code>[ [0,0,0], 1000, 50 ] [[call]] '''BIS_fnc_relPos''';//[766.044,642.788,0]</code> |= Example 1
 
//Lawman_Actual: "Will Create a nice spiral of flares from the player at 30 degree intervals and increasing distance"
 
for "_x" from 0 to 1440 step 30 do{
 
_distance = (_x/100)*2;
_targetPos = [(getPos player), _distance, _x] call BIS_fnc_relPos;
_targetPos set [2,0];
_flare = "F_40mm_White" createVehicle _targetPos;
sleep 0.25;
 
};
 
</code> |=  
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[getPos]]|= See also
|[[getPos]]|= See also
 
}}
}}


Line 77: Line 53:


Currently searching for a method which incorporates the azimuth of the rangefinder in calculation.  
Currently searching for a method which incorporates the azimuth of the rangefinder in calculation.  
</dd>
</dl>
<!-- DISCONTINUE Notes -->
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on March 25, 2017 - 20:36 (UTC)</dd>
<dt class="note">[[User:Feint|Feint]]</dt>
<dd class="note">
Since Arma 3 v1.55.133361, an alternative syntax was added to [[getPos]] that allows one to get a position that is a given distance and heading away from original object or position, the equivalent of BIS_fnc_relPos<br>
<br>
Example:<br>
<code>_relPos = _caller [[getPos]] [([[abs]] _boundingBoxDimensions) -0.2, _direction];</code>
// RESULT: 0.0021 ms<br>
<br>
is equal to:<br>
<code>_relPos = [_caller, ([[abs]] _boundingBoxDimensions) -0.2, _direction] [[call]] BIS_fnc_relPos;</code>
// RESULT: 0.554324 ms
</dd>
</dd>
</dl>
</dl>
<!-- DISCONTINUE Notes -->
<!-- DISCONTINUE Notes -->

Revision as of 10:45, 26 April 2018

Logo A2.png1.00
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.
Arma 3
In Arma 3 use getPos instead.
Execution:
call
Groups:
Uncategorised

Syntax

Syntax:
[start, distance, direction] call BIS_fnc_relPos
Parameters:
start: 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

Notes

Bottom Section

Posted on January 7, 2016 - 19:26 (UTC)
Lawman Actual
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 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.
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_relPos&oldid=106786"