getRelDir: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Added example, removed my note)
 
(38 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


|arma3|= Game name
|game1= arma3
|version1= 1.56


|1.56|= Game version
|arg= global


|arg= global|= Arguments in MP
|gr1= Object Manipulation
____________________________________________________________________________________________


| Returns direction, which is relative to object's current direction, from given object to another object or position in the range from 0 to 360, the equivalent of [[BIS_fnc_relativeDirTo]]. Taking the current [[direction]] of the object into account. |= Description
|descr= Returns direction, which is relative to object's current direction, from given object to another object or position in the range from 0 to 360, the equivalent of [[BIS_fnc_relativeDirTo]].
____________________________________________________________________________________________
Taking the current [[direction]] of the object into account.


| object '''getRelDir''' position |= Syntax
|s1= object [[getRelDir]] position


|p1= object: [[Object]] |=Parameter 1
|p1= object: [[Object]]
|p2= position: [[Object]], [[Position2D]] or [[Position3D]] |=Parameter 2
| [[Number]] |= Return value
____________________________________________________________________________________________
|x1 = <code>_reldir = [[player]] '''getRelDir''' tank;</code> |= Example 1
____________________________________________________________________________________________
| [[getDir]], [[direction]], [[getDirVisual]] |= See also


|p2= position: [[Object]], [[Position#Introduction|Position2D]] or [[Position#Introduction|Position3D]]
|r1= [[Number]]
|x1= <sqf>_reldir = player getRelDir tank;</sqf>
|x2= <sqf>
// Set object's direction towards any given position
_object setDir (getDir _object + (_object getRelDir [_x, _y, _z]))
</sqf>
|seealso= [[getDir]] [[direction]] [[getDirVisual]]
}}
}}


<h3 style="display:none">Notes</h3>
<dl class="command_description">
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
<dt></dt>
<dd class="notedate">Posted on 2018-08-07 - 21:50 (UTC)</dd>
<dt class="note">[[User:Tankbuster|Tankbuster]]</dt>
<dd class="note">
To clarify, this returns a relative direction, so objects directly in front are said to be at zero degrees. So, taking example 1 above, if the tank is in front of the player, this function will return 0. If the tank is to the right of the player, it will return 90.
</dd>
 
</dl>
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 03:06, 12 May 2024

Hover & click on the images for description

Description

Description:
Returns direction, which is relative to object's current direction, from given object to another object or position in the range from 0 to 360, the equivalent of BIS_fnc_relativeDirTo. Taking the current direction of the object into account.
Groups:
Object Manipulation

Syntax

Syntax:
object getRelDir position
Parameters:
object: Object
position: Object, Position2D or Position3D
Return Value:
Number

Examples

Example 1:
_reldir = player getRelDir tank;
Example 2:
// Set object's direction towards any given position _object setDir (getDir _object + (_object getRelDir [_x, _y, _z]))

Additional Information

See also:
getDir direction getDirVisual

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
Posted on 2018-08-07 - 21:50 (UTC)
Tankbuster
To clarify, this returns a relative direction, so objects directly in front are said to be at zero degrees. So, taking example 1 above, if the tank is in front of the player, this function will return 0. If the tank is to the right of the player, it will return 90.