getRelPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments( \("local" or "global"\))?|Effects|Multiplayer Effects( \("local" or "global"\))?|Multiplayer Exe...)
m (Text replacement - "since= Arma3" to "since= arma3")
 
(36 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command
{{RV|type=command


|arma3
|game1= arma3
 
|version1= 1.56
|1.56


|arg= global
|arg= global
Line 9: Line 8:
|gr1= Positions
|gr1= Positions


| Returns position, which is given distance and relative direction away from original object.
|descr= Returns position that is given distance and relative direction away from original object. The alternative syntax available from Arma 3 v 2.14, returns the position offset of the attached object. If the animated memory point is used for attachment, the offset is calculated in [[Simulation_vs_Render_Time_Scope#Render_Time_Scope | render scope]].


| object '''getRelPos''' [distance, direction]
|s1= object [[getRelPos]]  [distance, direction]


|p1= object: [[Object]] - object
|p1= object: [[Object]] - object
|p2= [distance, direction]: [[Array]]
 
|p3= distance: [[Number]] - distance from object
|p3= distance: [[Number]] - distance from object
|p4= direction: [[Number]] - direction relative to object's current direction
|p4= direction: [[Number]] - direction relative to object's current direction


| [[Array]] - format [x,y,z], where z is land surface in format [[PositionAGL]]
|r1= [[Array]] format [[Position#PositionAGL|PositionAGL]]


 
|s2= obj1 [[getRelPos]] obj2
|x1= Find position 100 metres away at player's 3 o'clock:<code>_relpos = [[player]] [[getRelPos]] [100, 90];</code>
|s2since= arma3 2.14


| [[getPosASLVisual]], [[getPosATLVisual]], [[visiblePositionASL]], [[visiblePosition]], [[position]], [[getPos]], [[getPosATL]], [[getPosASL]], [[getPosASLW]]
|p21= obj1: [[Object]] - parent object


}}
|p22= obj2: [[Object]] - attached object


<h3 style="display:none">Notes</h3>
|r2= [[Array]] format [[Position#PositionRelative|PositionRelative]]
<dl class="command_description">
<!-- Note Section BEGIN -->
<dt class="note">[[User:talkingtoaj|talkingtoaj]]<dd class="note">
getPos vs getRelPos: getRelPos operates similarly to getPos except in getRelPos the direction is calculated 'relative' to the current object direction whereas getPos's direction is from North. Thus while getPos can take a position array as it is starting point, getRelPos requires an object with its own azithmus heading.


<dd class="notedate">Posted on 3 March, 2016
|x1= Find position 100 metres away at player's 3 o'clock:
<sqf>_relpos = player getRelPos [100, 90];</sqf>


|seealso= [[getPos]] [[getPosASLVisual]] [[getPosATLVisual]] [[visiblePositionASL]] [[visiblePosition]] [[position]] [[getPosATL]] [[getPosASL]] [[getPosASLW]]
}}


 
{{Note
<!-- Note Section END -->
|user= talkingtoaj
</dl>
|timestamp= 20160303155300
 
|text= [[getPos]] vs [[getRelPos]]: [[getRelPos]] operates similarly to [[getPos]] except in [[getRelPos]] the direction is calculated 'relative' to the current object direction whereas [[getPos]]'s direction is from North. Thus while [[getPos]] can take a position array as it is starting point, [[getRelPos]] requires an object with its own azimut heading.
<h3 style="display:none">Bottom Section</h3>
}}
 
{{GameCategory|arma3|New Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 17:26, 9 February 2024

Arma 3 logo black.png1.56
GAGlobal
Hover & click on the images for description

Description

Description:
Returns position that is given distance and relative direction away from original object. The alternative syntax available from Arma 3 v 2.14, returns the position offset of the attached object. If the animated memory point is used for attachment, the offset is calculated in render scope.
Groups:
Positions

Syntax

Syntax:
object getRelPos [distance, direction]
Parameters:
object: Object - object
distance: Number - distance from object
direction: Number - direction relative to object's current direction
Return Value:
Array format PositionAGL

Alternative Syntax

Syntax:
obj1 getRelPos obj2
Parameters:
obj1: Object - parent object
obj2: Object - attached object
Return Value:
Array format PositionRelative

Examples

Example 1:
Find position 100 metres away at player's 3 o'clock:
_relpos = player getRelPos [100, 90];

Additional Information

See also:
getPos getPosASLVisual getPosATLVisual visiblePositionASL visiblePosition position getPosATL getPosASL getPosASLW

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
talkingtoaj - c
Posted on Mar 03, 2016 - 15:53 (UTC)
getPos vs getRelPos: getRelPos operates similarly to getPos except in getRelPos the direction is calculated 'relative' to the current object direction whereas getPos's direction is from North. Thus while getPos can take a position array as it is starting point, getRelPos requires an object with its own azimut heading.
Retrieved from "https://community.bistudio.com/wiki?title=getRelPos&oldid=352422"