com.atakmap.android.lrf

Class LocalRangeFinderInput

java.lang.Object

com.atakmap.android.lrf.LocalRangeFinderInput

All Implemented Interfaces:

android.content.SharedPreferences.OnSharedPreferenceChangeListener, RangeFinderAction, java.lang.Runnable

public class LocalRangeFinderInput
extends java.lang.Object
implements java.lang.Runnable, RangeFinderAction, android.content.SharedPreferences.OnSharedPreferenceChangeListener

Allows for local range finder data receipt over port 17211. It is assumed that the publication of local data will be done using a TTL of 0. The input data at this time will only be for supporting PC mode style data from the PLFR in a receive only fashion. The data will be transmitted as triplets D,A,E where A is magnetic with no declination applied. The packets listened for are (currently specversion = 1): specversion,uid,timestamp,d,a,e - d is distance in meters - a is the azimuth in degrees (magnetic with no declination applied) - e elevation/inclination in degrees The distance is considered raw and attempts to modify it based on the inclination (elevation) of the unit should be done by the user (this code) with an understanding of the underlying terrain model. specversion,uid,timestamp,UNKNOWN_MESSAGE specversion,uid,timestamp,COMPASS_ERROR specversion,uid,timestamp,MAINBOARD_ERROR specversion,uid,timestamp,RANGE_ERROR TODO: socket timeout alternative local intent passing, to compliment socket version

Constructor Summary

Constructors

Constructor and Description
LocalRangeFinderInput(MapView mapView, android.content.Context context)

Method Summary

Modifier and Type	Method and Description
void	dispose()
static LocalRangeFinderInput	getInstance() Obtains the instance of the LocalRangeFinderInput.
void	onRangeFinderInfo(java.lang.String uidPrefix, double distance, double azimuth, double zAngle) Copy of the implementation of onRangeFinderInfo from Dan Carpenter.
void	onSharedPreferenceChanged(android.content.SharedPreferences sharedPreferences, java.lang.String key)
void	process(java.lang.String input) This is the primary mechanism for handling all laser range finder data into the system.
void	registerAction(RangeFinderAction externalAction) Allow for plugin's to override the action that occurs when a laser range finder is used.
void	run()
void	toastMessage(java.lang.String message, int toast_length) The original implementation utilized toasts to notify the user of an issue.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

LocalRangeFinderInput

public LocalRangeFinderInput(MapView mapView,
                             android.content.Context context)

Method Detail

getInstance

public static LocalRangeFinderInput getInstance()

Obtains the instance of the LocalRangeFinderInput.

registerAction

public void registerAction(RangeFinderAction externalAction)

Allow for plugin's to override the action that occurs when a laser range finder is used.

run

public void run()

Specified by:

run in interface java.lang.Runnable

process

public void process(java.lang.String input)

This is the primary mechanism for handling all laser range finder data into the system. Process a laser range finder input in the form of laserRangeFinderUid, time, meters, azimuth, inclination or in the case of an error mode laserRangeFinderUid, time, ERROR

Parameters:

input - the string in the above format.

onRangeFinderInfo

public void onRangeFinderInfo(java.lang.String uidPrefix,
                              double distance,
                              double azimuth,
                              double zAngle)

Copy of the implementation of onRangeFinderInfo from Dan Carpenter. This method takes in a distance, azimuth, elevation and based on the self positional computes the exact location of the target.

Specified by:

onRangeFinderInfo in interface RangeFinderAction

Parameters:

zAngle - - angle from source to target in degrees

toastMessage

public void toastMessage(java.lang.String message,
                         int toast_length)

The original implementation utilized toasts to notify the user of an issue.

onSharedPreferenceChanged

public void onSharedPreferenceChanged(android.content.SharedPreferences sharedPreferences,
                                      java.lang.String key)

Specified by:

onSharedPreferenceChanged in interface android.content.SharedPreferences.OnSharedPreferenceChangeListener

dispose

public void dispose()