GRAD GPS Tracker

GPS Tracker dialog with a basic API.

Dependencies

• CBA_A3

Installation

Manually

1. Create a folder in your mission root folder and name it modules. Then create one inside there and call it grad-gpsTracker.
2. Download the contents of this repository ( there's a download link at the side ) and put it into the directory you just created.
3. Append the following lines of code to the description.ext:

class CfgFunctions {
    #include "modules\grad-gpsTracker\cfgFunctions.hpp"
};

Via npm

for details about what npm is and how to use it, look it up on npmjs.com

1. Install package grad-gpsTracker : npm install --save grad-gpstracker
2. Prepend your mission's description.ext with #define MODULES_DIRECTORY node_modules
3. Append the following lines of code to the description.ext:

class CfgFunctions {
    #include "node_modules\grad-gpsTracker\cfgFunctions.hpp"
};

Usage

There are two functions to open the tracker. grad_gpsTracker_fnc_openTitle creates a cutRsc (this is the function that you want). grad_gpsTracker_fnc_openDialog creates and returns a dialog - I don't know why you would want this, but hey it's here. To close the title, use grad_gpsTracker_fnc_closeTitle. To close the dialog, use the escape button. Most of their parameters are the same.

[target,update interval,size,offset X,offset Y,reception code,duration,showDistance] call grad_gpsTracker_fnc_openTitle

Example:
[_vehicle2,0.1,1,1.2,1,{_target getVariable ['signalStrength',0]}] call grad_gpsTracker_fnc_openTitle;

Target

The target can be manually changed (even while the tracker is open) with grad_gpsTracker_fnc_setTarget. If you pass a null object, "NO SIGNAL" will be displayed.

[target,global] call grad_gpsTracker_fnc_setTarget

The tracker will always point directly at the target, no matter the reception. If you want to simulate inaccuracy, you could manually update the tracking target in a loop like this:

[{
    params ["_targetObj"];
    _targetPos = _targetObj getPos [random 300, random 360];
    [_targetPos,true] call grad_gpsTracker_fnc_setTarget;
} , 10, _targetObj] call CBA_fnc_addPerFrameHandler;

Reception

The reception has no influence on the tracking accuracy, but at 0 reception the tracker will show "NO SIGNAL" instead of the arrow. It can be used to give the user a rough idea about his distance to the target.

The reception code parameter will take any function that returns a number. 0 and below means no reception, 1 and above means full reception. The following parameters are passed to the function:

You can use this to create a sophisticated, nonlinear reception function. By default this function is used, which gives the device a maximum range of 2000m:

params ["_unit","_target","_updateInterval"];
private _reception = 1 - (_unit distance2D _target)/2000;
_reception