getRelPos: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
mNo edit summary
Line 18: Line 18:
|p4= direction: [[Number]] - Direction relative to object's current direction
|p4= direction: [[Number]] - Direction relative to object's current direction


|r1= [[Array]] in format [[Position#PositionAGL|PositionAGL]]
|r1= [[Array]] format [[Position#PositionAGL|PositionAGL]]


|s2= obj1 [[getRelPos]] obj2
|s2= obj1 [[getRelPos]] obj2
Line 27: Line 27:
|p22= obj2: [[Object]] - Attached object
|p22= obj2: [[Object]] - Attached object


|r2= [[Array]] in format [[PositionRelative]]
|r2= [[Array]] format [[Position#PositionRelative|PositionRelative]]


|x1= Find position 100 metres away at player's 3 o'clock:
|x1= Find position 100 metres away at player's 3 o'clock:

Revision as of 11:01, 28 September 2023

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.