getRelPos

Global argument
Arma 3 v1.56

Command · Markdown · JSON · original wiki page

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.

Syntax

Syntax 1

object getRelPos [distance, direction]

Parameters:

object: Object - object
distance: Number - distance from object
direction: Number - direction relative to object's current direction

Returns: PositionAGL

Syntax 2

since arma3 2.14

obj1 getRelPos obj2

Parameters:

obj1: Object - parent object
obj2: Object - attached object

Returns: PositionRelative

Examples

Example 1

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

_relpos = player getRelPos [100, 90];

Community notes

talkingtoaj

2016-03-03

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.