Epoch/Sources/epoch_code/compile/functions/EPOCH_fnc_findSapperStalkLocation.sqf
2017-05-02 08:28:52 -05:00

42 lines
1.7 KiB
Plaintext

/*
Author: Andrew Gregory - EpochMod.com
Contributors:
Description:
Picks a random spot relative to the target with some randomness. Used in Sapper Brain
Licence:
Arma Public License Share Alike (APL-SA) - https://www.bistudio.com/community/licenses/arma-public-license-share-alike
Github:
https://github.com/EpochModTeam/Epoch/tree/release/Sources/epoch_code/compile/functions/EPOCH_fnc_findSapperStalkLocation.sqf
Example:
_moveTo = [_centre, _min_distance, _max_distance, _height, _onRoad] call EPOCH_fnc_findSafePos;
Parameter(s):
_this select 0: SCALAR - Maximum distance to choose point
_this select 1: SCALAR - Minimum distance to choose point
_this select 2: SCALAR - Spread of arc in degrees relative to _unitIn. Is randomised to add fuzziness to final location.
_this select 3: OBJECT - Unit, player, vehicle etc.
_this select 4: SCALAR - Offset initial angle, allows to pick position to the side of _unitIn with -90 or 90.
_this select 5: OBJECT - Target to use for relative position from _unitIn. Allows to pick a position left of _trgtin for example. [optional: default false]
Returns:
ARRAY
*/
//[[[cog import generate_private_arrays ]]]
private ["_dir","_dirTo","_dist","_moveTo","_pos","_rnd"];
//[[[end]]]
params ["_maxIn","_minIn","_arcIn","_unitIn","_offset","_trgtIn"];
_dirTo = (position _unitIn) getDir (position _trgtIn);
_rnd = _offset - (random _arcIn);
_pos = getPosATL _trgtIn;
_dist = ((random (_maxIn - _minIn)) + _minIn) max _minIn;
_dir = _dirTo - _rnd;
if (_dir < 0) then {_dir = _dir + 360};
// Return
[(_pos select 0) + (_dist*(sin _dir)), (_pos select 1) + (_dist*(cos _dir)), _pos select 2]