getRelPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
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...)
Line 1: Line 1:
{{Command|Comments=
{{Command


|arma3|Game name=
|arma3


|1.56|Game version=
|1.56


|arg= global|Multiplayer Arguments=
|arg= global


|gr1= Positions |GROUP1=
|gr1= Positions


| Returns position, which is given distance and relative direction away from original object. |DESCRIPTION=
| Returns position, which is given distance and relative direction away from original object.


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


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


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


    
    
|x1= Find position 100 metres away at player's 3 o'clock:<code>_relpos = [[player]] [[getRelPos]] [100, 90];</code> |EXAMPLE1=
|x1= Find position 100 metres away at player's 3 o'clock:<code>_relpos = [[player]] [[getRelPos]] [100, 90];</code>


| [[getPosASLVisual]], [[getPosATLVisual]], [[visiblePositionASL]], [[visiblePosition]], [[position]], [[getPos]], [[getPosATL]], [[getPosASL]], [[getPosASLW]] |SEEALSO=
| [[getPosASLVisual]], [[getPosATLVisual]], [[visiblePositionASL]], [[visiblePosition]], [[position]], [[getPos]], [[getPosATL]], [[getPosASL]], [[getPosASLW]]


}}
}}

Revision as of 00:43, 18 January 2021

Hover & click on the images for description

Description

Description:
Returns position, which is given distance and relative direction away from original object.
Groups:
Positions

Syntax

Syntax:
object getRelPos [distance, direction]
Parameters:
object: Object - object
[distance, direction]: Array
distance: Number - distance from object
direction: Number - direction relative to object's current direction
Return Value:
Array - format [x,y,z], where z is land surface in format PositionAGL

Examples

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

Additional Information

See also:
getPosASLVisualgetPosATLVisualvisiblePositionASLvisiblePositionpositiongetPosgetPosATLgetPosASLgetPosASLW

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

talkingtoaj
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.
Posted on 3 March, 2016

Bottom Section