ATAKUtilities

java.lang.Object
- com.atakmap.android.util.ATAKUtilities

```
public class ATAKUtilities
extends java.lang.Object
```
Home for utility functions that don't have a better home yet. Should consolidate functions like findSelf that otherwise will be copy-pasted 20 times.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static interface ATAKUtilities.BitmapDecoder
Allow for application registration of decoders.

Nested Classes
Modifier and Type	Class and Description
`static interface`	`ATAKUtilities.BitmapDecoder` Allow for application registration of decoders.

Constructor Summary

Constructors
Constructor and Description

ATAKUtilities()

Constructors
Constructor and Description
`ATAKUtilities()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static java.lang.String`	`bytesToHex(byte[] arr)` Turn a byte array into a hex string representation
`static double`	`computeDistanceOfRayToSegment(GeoPoint p, double azimuth, GeoPoint seg1, GeoPoint seg0)`
`static double`	`computeGridConvergence(GeoPoint sPoint, double angle, double distance)` Obtains the grid convergence used for a specific line of bearing.
`static double`	`computeGridConvergence(GeoPoint sPoint, GeoPoint ePoint)` Obtains the grid convergence used for a specific line of bearing.
`static double`	`convertFromMagneticToTrue(GeoPoint point, double angle)` Convert a bearing from Magnetic North to True North
`static double`	`convertFromTrueToMagnetic(GeoPoint point, double angle)` Convert a bearing from True North to Magnetic North
`static void`	`copyClipboard(java.lang.String label, java.lang.String text, boolean bToast)` Method to assist in the copying of text data to the clipboard supporting cut and paste.
`static MapItem`	`findAssocShape(MapItem mi)` Find the shape, if any, associated with this map item
`static Marker`	`findSelf(MapView mapView)` Finds self marker but only if it has been placed on the map
`static Marker`	`findSelfUnplaced(MapView mapView)` Finds self marker even if it has not been placed on the map.
`static java.util.List<java.lang.String>`	`fromJSON(java.lang.String json)` Convert JSON string into a list of strings
`static Vector2D`	`geo2Vector(GeoPoint p)` Deprecated. UTM-based vectors can't handle intersection/contains checks across different UTM zones. Use `FOVFilter.geo2Vector(GeoPoint)` instead
`static android.graphics.Bitmap`	`getBitmap(android.graphics.drawable.Drawable drawable)` Create a Bitmap from the specified drawable
`static android.graphics.drawable.Drawable`	`getContentIcon(java.lang.String contentType)` Get an icon for a given file content type
`static double`	`getCurrentMagneticVariation(GeoPoint point)` For a specific GeoPoint, derive the actual magnetic declination that should be used as double offset.
`static java.lang.String`	`getDisplayName(MapItem item)` Uses logic to obtain the best display name for a specific MapItem in the system.
`static android.graphics.drawable.Drawable`	`getFileIcon(java.io.File f)` Get an icon for a file Note: If the file does not exist it's recommended to use `getContentIcon(String)` provided you have the content type
`static android.graphics.Bitmap`	`getIconBitmap(MapItem item)` Generate a bitmap for this map item's icon
`static int`	`getIconColor(MapItem mi)` Get color from a map item icon
`static java.lang.String`	`getIconUri(MapItem mi)` Get the Icon URI based on marker icon or 'iconUri' meta string Meant to be used when displaying the map item in UI (not in MapView)
`static double`	`getMaximumFocusResolution(GeoPoint location)`
`static double`	`getMaximumFocusResolution(GeoPoint location, double localElevation, double vfov, int heightPx)` Computes the maximum GSD that should be specified when focusing on a point.
`static double`	`getMetersPerPixel()` Get the estimated meters per pixel at the default focus point
`static double`	`getMetersPerPixel(float x, float y)` Get the estimated meters per pixel at a given point on the screen
`static double`	`getMetersPerPixel(GeoPoint point)` Get the estimated meters per pixel at a given point on the map
`static double`	`getMetersPerPixel(android.graphics.PointF point)` Get the estimated meters per pixel at a given point on the screen
`static java.lang.String`	`getNonDuplicateName(java.lang.String newName, java.util.List<java.lang.String> names, java.lang.String format)` Given a list of names, find the next non-duplicate name based on newName
`static java.lang.String`	`getResourceUri(android.content.Context context, int resId)` Convert resource ID to URI string
`static java.lang.String`	`getResourceUri(int resId)` Provided a resource identifier, return the full resource URI describing the resource.
`static java.lang.String`	`getStartDirectory(android.content.Context sharedPrefContext)` Returns the appropriate starting directory for file dialogs.
`static android.graphics.Bitmap`	`getUriBitmap(android.content.Context ctx, java.lang.String uriStr)` Decode URI to its matching bitmap
`static android.graphics.Bitmap`	`getUriBitmap(java.lang.String uriStr)` Decode URI to its matching bitmap
`static java.lang.String`	`getUriPath(java.lang.String uriStr)` Convert a uriStr into a path keeping legacy behavior.
`static byte[]`	`hexToBytes(java.lang.String hex)` Given a hex string, decode it into a byte array.
`static boolean`	`isSelf(MapView mapView, PointMapItem item)` Method that will return true if the map item provided is the self marker.
`static boolean`	`isSelf(MapView mapView, java.lang.String uid)` Method that will return true if the map item provided is the self marker.
`static boolean`	`isUUID(java.lang.String string)` Determine if a string supplied is a valid UUID.
`static boolean`	`pointInsidePolygon(GeoPoint point, GeoPoint[] polygon)` Check if a GeoPoint resides within a polygon represented by a GeoPoint Array The polygon does not have to convex in order for this function to work, but the first and last GeoPoint must be equivalent
`static void`	`registerBitmapDecoder(java.lang.String scheme, ATAKUtilities.BitmapDecoder uriBitmapDecoder)` Register a bitmap decoder with the system that will be called when the uri scheme is encountered.
`static void`	`scaleToFit(ILocation loc)` Given a location, scale to fit the bounds provided by the location
`static void`	`scaleToFit(MapItem item)` Scales map to fit item.
`static boolean`	`scaleToFit(MapView mv, GeoBounds bounds, double altitude, int widthPad, int heightPad)`
`static boolean`	`scaleToFit(MapView mv, GeoBounds bounds, int widthPad, int heightPad)`
`static boolean`	`scaleToFit(MapView mv, GeoBounds bounds, int widthPad, int heightPad, boolean terrainAdj)` Deprecated. "terrainAdj" parameter no longer supported
`static boolean`	`scaleToFit(MapView mv, GeoPoint[] points, double altitude, int widthPad, int heightPad)` Scales map to fit item and, if includeself is true, the self marker, within a space width by height around the focus point.
`static boolean`	`scaleToFit(MapView mv, GeoPoint[] points, int width, int height)`
`static boolean`	`scaleToFit(MapView mv, GeoPoint[] points, int widthPad, int heightPad, boolean terrainAdj)` Deprecated. "terrainAdj" parameter no longer supported
`static void`	`scaleToFit(MapView _mapView, MapItem[] items, int widthPad, int heightPad)` Scales map to fit items within a space width by height around the focus point.
`static void`	`scaleToFit(MapView _mapView, MapItem item, boolean includeSelf, int widthPad, int heightPad)` Scales map to fit item and, if includeself is true, the self marker, within a space width by height around the focus point.
`static void`	`scaleToFit(MapView _mapView, PointMapItem target, PointMapItem friendly)` Scales map to fit items within a space width by height around the focus point.
`static java.util.ArrayList<GeoPoint>`	`segmentArrayIntersectionsWithPolygon(GeoPoint[] segments, GeoPoint[] polygon)`
`static boolean`	`segmentArrayIntersectsOrContainedByPolygon(GeoPoint[] segments, GeoPoint[] polygon)`
`static boolean`	`segmentInsidePolygon(GeoPoint point0, GeoPoint point1, GeoPoint[] polygon)`
`static void`	`SetIcon(android.content.Context context, android.widget.ImageView view, MapItem mi)` Set the icon based on the iconUriStr Parses all the support uri formats
`static android.graphics.Bitmap`	`SetIcon(android.content.Context context, android.widget.ImageView icon, java.lang.String iconUriStr, int color)` Set the icon based on the iconUriStr, must be run on the ui thread since it directly manipulates the passed in ImageView Parses all the support uri formats
`static void`	`setIcon(android.widget.ImageView view, MapItem mi)` Set the icon based on the map item's icon drawable
`static android.graphics.Bitmap`	`setIconFromFile(android.widget.ImageView icon, java.io.File iconFile)` Given a file and a imageview, set the image from the file as part of the icon and then if sucessful, return the bitmap constructed from the file.
`static void`	`SetUserIcon(MapView context, android.widget.ImageView icon, PointMapItem item)`
`static void`	`SetUserIcon(MapView context, android.widget.ImageView icon, PointMapItem item, int defaultResource)` Set the icon for the user Use current marker's icon Use specified default
`static void`	`SetUserIcon(MapView view, android.widget.ImageView icon, java.lang.String uid)` Set the icon for the user.
`static void`	`SetUserIcon(MapView view, android.widget.ImageView icon, java.lang.String uid, int defaultResource)` Set the icon for the user Use current marker's icon Use self icon if item is 'self' Use specified default
`static java.util.List<GeoPoint>`	`simplifyPoints(SpatialCalculator calc, java.util.Collection<GeoPoint> points)` Helper method for `SpatialCalculator#simplify(Collection, double, boolean)` Automatically calculates degree threshold using the current DPI
`static java.lang.String`	`toJSON(java.util.List<java.lang.String> strings)` Convert list of strings to a JSON array
`static void`	`unregisterBitmapDecoder(java.lang.String scheme)` Unregister the uriBitmapDecoder for a specified scheme.
`static GeoPoint`	`vector2Geo(Vector2D v, java.lang.String zone)` Given a vector from the start of the zone and a zone - utilize UTM to generate a geopoint.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ATAKUtilities
```
public ATAKUtilities()
```
- Method Detail
  - getDisplayName
```
public static java.lang.String getDisplayName(MapItem item)
```
    Uses logic to obtain the best display name for a specific MapItem in the system.
    
    Parameters:
    
    item - The map item to get the display name from.
    
    Returns:
    
    the display name.
  - isUUID
```
public static boolean isUUID(java.lang.String string)
```
    Determine if a string supplied is a valid UUID.
    
    Parameters:
    
    string - the unknown string
    
    Returns:
    
    true if it is a UUID.
  - findSelfUnplaced
```
public static Marker findSelfUnplaced(MapView mapView)
```
    Finds self marker even if it has not been placed on the map.
    
    Parameters:
    
    mapView - the mapView to use
    
    Returns:
    
    Self marker if it exists, otherwise null.
  - findSelf
```
public static Marker findSelf(MapView mapView)
```
    Finds self marker but only if it has been placed on the map
    
    Parameters:
    
    mapView - the mapView to use
    
    Returns:
    
    Self marker if it exists, otherwise null.
  - isSelf
```
public static boolean isSelf(MapView mapView,
                             PointMapItem item)
```
    Method that will return true if the map item provided is the self marker.
    
    Parameters:
    
    mapView - the mapView used
    
    item - the item passed in
    
    Returns:
    
    true if the item is the self marker.
  - isSelf
```
public static boolean isSelf(MapView mapView,
                             java.lang.String uid)
```
    Method that will return true if the map item provided is the self marker.
    
    Parameters:
    
    mapView - the mapView used
    
    uid - the uid of the item to check
    
    Returns:
    
    true if the item is the self marker.
  - scaleToFit
```
public static void scaleToFit(MapView _mapView,
                              MapItem item,
                              boolean includeSelf,
                              int widthPad,
                              int heightPad)
```
    Scales map to fit item and, if includeself is true, the self marker, within a space width by height around the focus point.
    
    Parameters:
    
    _mapView - the mapview to use when scaling to fit around the item.
    
    item - the item to use
    
    includeSelf - if the scaleToFit should also make use of the self marker
    
    widthPad - the padding to be used for the width around the best fit.
    
    heightPad - the padding to be used for the height of the bet fit.
  - scaleToFit
```
public static void scaleToFit(MapView _mapView,
                              MapItem[] items,
                              int widthPad,
                              int heightPad)
```
    Scales map to fit items within a space width by height around the focus point.
    
    Parameters:
    
    _mapView - the mapview to use when scaling to fit around the items.
    
    items - the array of items to provide a best fit for
    
    widthPad - the padding to be used for the width around the best fit.
    
    heightPad - the padding to be used for the height of the bet fit.
  - scaleToFit
```
public static void scaleToFit(MapView _mapView,
                              PointMapItem target,
                              PointMapItem friendly)
```
    Scales map to fit items within a space width by height around the focus point.
    
    Parameters:
    
    _mapView - the mapview to use when scaling to fit around the items.
    
    target - the target point to include
    
    friendly - the friendly point to include
  - scaleToFit
```
public static boolean scaleToFit(MapView mv,
                                 GeoPoint[] points,
                                 double altitude,
                                 int widthPad,
                                 int heightPad)
```
    Scales map to fit item and, if includeself is true, the self marker, within a space width by height around the focus point.
    
    Parameters:
    
    mv - the mapview to use when scaling to fit.
    
    points - the array of geopoints to use
    
    altitude - Altitude to zoom to (perspective mode only; NaN to ignore)
    
    widthPad - the padding to be used for the width around the best fit.
    
    heightPad - the padding to be used for the height of the bet fit.
    
    Returns:
    
    true if the scale process was successful.
  - scaleToFit
```
public static boolean scaleToFit(MapView mv,
                                 GeoPoint[] points,
                                 int width,
                                 int height)
```
  - scaleToFit
```
public static boolean scaleToFit(MapView mv,
                                 GeoBounds bounds,
                                 int widthPad,
                                 int heightPad)
```
  - scaleToFit
```
public static boolean scaleToFit(MapView mv,
                                 GeoBounds bounds,
                                 double altitude,
                                 int widthPad,
                                 int heightPad)
```
  - scaleToFit
```
public static void scaleToFit(MapItem item)
```
    Scales map to fit item.
    
    Parameters:
    
    item - the item to use
  - scaleToFit
```
public static void scaleToFit(ILocation loc)
```
    Given a location, scale to fit the bounds provided by the location
    
    Parameters:
    
    loc - the location
  - scaleToFit
```
@Deprecated
public static boolean scaleToFit(MapView mv,
                                             GeoBounds bounds,
                                             int widthPad,
                                             int heightPad,
                                             boolean terrainAdj)
```
    Deprecated. "terrainAdj" parameter no longer supported
  - scaleToFit
```
@Deprecated
public static boolean scaleToFit(MapView mv,
                                             GeoPoint[] points,
                                             int widthPad,
                                             int heightPad,
                                             boolean terrainAdj)
```
    Deprecated. "terrainAdj" parameter no longer supported
  - getMaximumFocusResolution
```
public static double getMaximumFocusResolution(GeoPoint location,
                                               double localElevation,
                                               double vfov,
                                               int heightPx)
```
    Computes the maximum GSD that should be specified when focusing on a point. This ensures an appropriate minimum camera offset. In general, this method is only recommended for points that are elevated above the terrain surface.
    NOTE: this is NOT a recommended focus distance.
    
    Parameters:
    
    location - The focus location
    
    localElevation - The local elevation at the point location
    
    vfov - The vertical FOV of the camera
    
    heightPx - The height of the display viewport, in pixels
    
    Returns:
    
    The maximum recommended GSD that should be associated when requesting the camera to focus on the specified point, when taking into consideration the local elevation.
  - getMaximumFocusResolution
```
public static double getMaximumFocusResolution(GeoPoint location)
```
  - getCurrentMagneticVariation
```
public static double getCurrentMagneticVariation(GeoPoint point)
```
    For a specific GeoPoint, derive the actual magnetic declination that should be used as double offset. Note: Prior to August 7, 2017 Android devices utilized WMM 2010. See the change id I36f26086b1e2f62f81974d81d90c9a9c315a3445 in the Google Android Source code Peng Xu in response to bug 31216311. https://android.googlesource.com/platform/frameworks/base/+/63bf36a2117ca0338d7d4fdd3c5612a9e6091c04
  - computeGridConvergence
```
public static double computeGridConvergence(GeoPoint sPoint,
                                            GeoPoint ePoint)
```
    Obtains the grid convergence used for a specific line of bearing.
    
    Parameters:
    
    sPoint - the starting point for the line of bearing.
    
    ePoint - the end point for the line of bearing.
    
    Returns:
    
    the grid deviation (grid convergence) for the provided line of bearing. The value is in angular degrees between [-180.0, 180.0)
  - computeGridConvergence
```
public static double computeGridConvergence(GeoPoint sPoint,
                                            double angle,
                                            double distance)
```
    Obtains the grid convergence used for a specific line of bearing.
    
    Parameters:
    
    sPoint - the starting point for the line of bearing.
    
    angle - the angle of the line of bearing.
    
    distance - the length of the line of bearing.
    
    Returns:
    
    the grid deviation (grid convergence) for the provided line of bearing. It is important to note that grid convergence cannot be acheived unless the line of bearing has some length. This will determine which grid line is used to converge against. The value is in angular degrees between [-180.0, 180.0)
  - convertFromMagneticToTrue
```
public static double convertFromMagneticToTrue(GeoPoint point,
                                               double angle)
```
    Convert a bearing from Magnetic North to True North
    
    Parameters:
    
    point - GeoPoint for the location of the Compass.
    
    angle - Bearing in degrees (Magnetic North)
    
    Returns:
    
    Bearing in degrees (True North)
  - convertFromTrueToMagnetic
```
public static double convertFromTrueToMagnetic(GeoPoint point,
                                               double angle)
```
    Convert a bearing from True North to Magnetic North
    
    Parameters:
    
    point - GeoPoint for the location of the Compass.
    
    angle - Bearing in degrees (True North)
    
    Returns:
    
    Bearing in degrees (Magnetic North)
  - pointInsidePolygon
```
public static boolean pointInsidePolygon(GeoPoint point,
                                         GeoPoint[] polygon)
```
    Check if a GeoPoint resides within a polygon represented by a GeoPoint Array The polygon does not have to convex in order for this function to work, but the first and last GeoPoint must be equivalent
    
    Parameters:
    
    point - GeoPoint to be tested
    
    polygon - Array of GeoPoint that represents the polygon (does not have to be convex)
    
    Returns:
    
    point resides in polygon?
  - segmentInsidePolygon
```
public static boolean segmentInsidePolygon(GeoPoint point0,
                                           GeoPoint point1,
                                           GeoPoint[] polygon)
```
  - segmentArrayIntersectsOrContainedByPolygon
```
public static boolean segmentArrayIntersectsOrContainedByPolygon(GeoPoint[] segments,
                                                                 GeoPoint[] polygon)
```
  - segmentArrayIntersectionsWithPolygon
```
public static java.util.ArrayList<GeoPoint> segmentArrayIntersectionsWithPolygon(GeoPoint[] segments,
                                                                                 GeoPoint[] polygon)
```
  - computeDistanceOfRayToSegment
```
public static double computeDistanceOfRayToSegment(GeoPoint p,
                                                   double azimuth,
                                                   GeoPoint seg1,
                                                   GeoPoint seg0)
```
  - geo2Vector
```
@Deprecated
public static Vector2D geo2Vector(GeoPoint p)
```
    Deprecated. UTM-based vectors can't handle intersection/contains checks across different UTM zones. Use FOVFilter.geo2Vector(GeoPoint) instead
    
    Turn a geopoint into a UTM-based vector2d.
    
    Parameters:
    
    p - the geopoint to use
    
    Returns:
    
    the vector2D representation.
  - vector2Geo
```
public static GeoPoint vector2Geo(Vector2D v,
                                  java.lang.String zone)
```
    Given a vector from the start of the zone and a zone - utilize UTM to generate a geopoint.
    
    Parameters:
    
    v - the vector offset from the zone described by easting (x) and northing (y).
    
    zone - the zone descriptor
    
    Returns:
    
    the geopoint.
  - findAssocShape
```
public static MapItem findAssocShape(MapItem mi)
```
    Find the shape, if any, associated with this map item
    
    Parameters:
    
    mi - Map item to search
    
    Returns:
    
    The associated shape or the input map item if none found
  - getIconUri
```
public static java.lang.String getIconUri(MapItem mi)
```
    Get the Icon URI based on marker icon or 'iconUri' meta string Meant to be used when displaying the map item in UI (not in MapView)
    
    Parameters:
    
    mi - Map item
    
    Returns:
    
    Map item icon URI
  - getResourceUri
```
public static java.lang.String getResourceUri(android.content.Context context,
                                              int resId)
```
    Convert resource ID to URI string
    
    Parameters:
    
    context - Resource context
    
    resId - Resource ID
    
    Returns:
    
    Resource URI
  - getResourceUri
```
public static java.lang.String getResourceUri(int resId)
```
    Provided a resource identifier, return the full resource URI describing the resource.
  - getIconColor
```
public static int getIconColor(MapItem mi)
```
    Get color from a map item icon
    
    Parameters:
    
    mi - the map item to use for finding the currently set icon color.
    
    Returns:
    
    the color, WHITE if no color is found.
  - SetUserIcon
```
public static void SetUserIcon(MapView view,
                               android.widget.ImageView icon,
                               java.lang.String uid)
```
    Set the icon for the user. Use current marker's icon Use self icon if item is 'self' Use friendly default
    
    Parameters:
    
    view - the map view to use when searching or the user.
    
    icon - the view to populate with the found icon.
    
    uid - the uid of the user to be found.
  - SetUserIcon
```
public static void SetUserIcon(MapView view,
                               android.widget.ImageView icon,
                               java.lang.String uid,
                               int defaultResource)
```
    Set the icon for the user Use current marker's icon Use self icon if item is 'self' Use specified default
    
    Parameters:
    
    view - the mapView to use to find the online users.
    
    icon - the view to set with the found default icon.
    
    uid - the uid of the user.
    
    defaultResource - if the user is not online or on the map, use the defaultResource to represent the user.
  - SetUserIcon
```
public static void SetUserIcon(MapView context,
                               android.widget.ImageView icon,
                               PointMapItem item)
```
  - SetUserIcon
```
public static void SetUserIcon(MapView context,
                               android.widget.ImageView icon,
                               PointMapItem item,
                               int defaultResource)
```
    Set the icon for the user Use current marker's icon Use specified default
    
    Parameters:
    
    context - the context to use when setting the icon
    
    icon - the icon to use
    
    item - the item to set the icon for
    
    defaultResource - the default resource
  - setIcon
```
public static void setIcon(android.widget.ImageView view,
                           MapItem mi)
```
    Set the icon based on the map item's icon drawable
    
    Parameters:
    
    view - The ImageView to display the icon
    
    mi - The Map Item to load the icon from
  - SetIcon
```
public static void SetIcon(android.content.Context context,
                           android.widget.ImageView view,
                           MapItem mi)
```
    Set the icon based on the iconUriStr Parses all the support uri formats
    
    Parameters:
    
    context - the context to use
    
    view - The ImageView to display the icon
    
    mi - The Map Item to load the icon from
  - SetIcon
```
public static android.graphics.Bitmap SetIcon(android.content.Context context,
                                              android.widget.ImageView icon,
                                              java.lang.String iconUriStr,
                                              int color)
```
    Set the icon based on the iconUriStr, must be run on the ui thread since it directly manipulates the passed in ImageView Parses all the support uri formats
    
    Parameters:
    
    context -
    
    icon - The ImageView to display the icon
    
    iconUriStr - The URI to load the icon from
    
    color - The color to be applied to the icon
    
    Returns:
    
    Bitmap if one was created
  - getIconBitmap
```
public static android.graphics.Bitmap getIconBitmap(MapItem item)
```
    Generate a bitmap for this map item's icon
    
    Parameters:
    
    item - Map item
    
    Returns:
    
    Icon bitmap
  - getUriPath
```
public static java.lang.String getUriPath(java.lang.String uriStr)
```
    Convert a uriStr into a path keeping legacy behavior. Does not account for the hostname being included in the path. We also do not support file uri with two slashes "used to access files in a remote system."
    
    Parameters:
    
    uriStr - the uri string { file, android, android.resource, base64 or no scheme at all}
    
    Returns:
    
    the path of the uriStr
  - registerBitmapDecoder
```
public static void registerBitmapDecoder(java.lang.String scheme,
                                         ATAKUtilities.BitmapDecoder uriBitmapDecoder)
```
    Register a bitmap decoder with the system that will be called when the uri scheme is encountered.
    
    Parameters:
    
    scheme - the uri scheme supported.
    
    uriBitmapDecoder - the decoder used to process the uri.
  - unregisterBitmapDecoder
```
public static void unregisterBitmapDecoder(java.lang.String scheme)
```
    Unregister the uriBitmapDecoder for a specified scheme.
    
    Parameters:
    
    scheme - the uri scheme for the bitmap decoder to remove.
  - getUriBitmap
```
public static android.graphics.Bitmap getUriBitmap(java.lang.String uriStr)
```
    Decode URI to its matching bitmap
    
    Parameters:
    
    uriStr - URI string to decode
    
    Returns:
    
    Icon bitmap the bitmap that can be recycled by the user at any time.
  - getUriBitmap
```
public static android.graphics.Bitmap getUriBitmap(android.content.Context ctx,
                                                   java.lang.String uriStr)
```
    Decode URI to its matching bitmap
    
    Parameters:
    
    uriStr - URI string to decode
    
    ctx - The application context
    
    Returns:
    
    Icon bitmap the bitmap that can be recycled by the user at any time.
  - toJSON
```
public static java.lang.String toJSON(java.util.List<java.lang.String> strings)
```
    Convert list of strings to a JSON array
    
    Parameters:
    
    strings - the list of string
    
    Returns:
    
    a list of strings into a JSON string array.
  - fromJSON
```
public static java.util.List<java.lang.String> fromJSON(java.lang.String json)
```
    Convert JSON string into a list of strings
    
    Parameters:
    
    json - the original encoded json document.
    
    Returns:
    
    the list of Strings
  - bytesToHex
```
public static java.lang.String bytesToHex(byte[] arr)
```
    Turn a byte array into a hex string representation
    
    Parameters:
    
    arr - the byte array
    
    Returns:
    
    the corresponding string
  - hexToBytes
```
public static byte[] hexToBytes(java.lang.String hex)
```
    Given a hex string, decode it into a byte array.
    
    Parameters:
    
    hex - a hex string containing characters [0-F]
    
    Returns:
    
    the corresponding byte array
    
    Throws:
    
    java.lang.IllegalArgumentException - if the string contains a non hex character
  - getNonDuplicateName
```
public static java.lang.String getNonDuplicateName(java.lang.String newName,
                                                   java.util.List<java.lang.String> names,
                                                   java.lang.String format)
```
    Given a list of names, find the next non-duplicate name based on newName
    
    Parameters:
    
    newName - New name - i.e. ItemName
    
    names - List of names - i.e. ItemName, ItemName (1), ItemName (2)
    
    format - Format where '#' is replaced by the dupe number - i.e. " (#)"
    
    Returns:
    
    New non-duplicate name - i.e. ItemName (3)
  - setIconFromFile
```
public static android.graphics.Bitmap setIconFromFile(android.widget.ImageView icon,
                                                      java.io.File iconFile)
```
    Given a file and a imageview, set the image from the file as part of the icon and then if sucessful, return the bitmap constructed from the file.
    
    Parameters:
    
    icon - the imageview used for the bitmap from the file.
    
    iconFile - the file containing the image.
    
    Returns:
    
    the bitmap if the file is loaded correctly.
  - getBitmap
```
public static android.graphics.Bitmap getBitmap(android.graphics.drawable.Drawable drawable)
```
    Create a Bitmap from the specified drawable
    
    Parameters:
    
    drawable - the drawable to turn into a bitmap.
    
    Returns:
    
    the bitmap representation of the drawable.
  - copyClipboard
```
public static void copyClipboard(java.lang.String label,
                                 java.lang.String text,
                                 boolean bToast)
```
    Method to assist in the copying of text data to the clipboard supporting cut and paste.
    
    Parameters:
    
    label - the label defining the data
    
    text - the actual data to be copied
    
    bToast - if true, displays a toast.
    
    Since:
    
    3.8
  - getContentIcon
```
public static android.graphics.drawable.Drawable getContentIcon(java.lang.String contentType)
```
    Get an icon for a given file content type
    
    Parameters:
    
    contentType - Content type
    
    Returns:
    
    Icon or null if N/A
  - getFileIcon
```
public static android.graphics.drawable.Drawable getFileIcon(java.io.File f)
```
    Get an icon for a file Note: If the file does not exist it's recommended to use getContentIcon(String) provided you have the content type
    
    Parameters:
    
    f - File
    
    Returns:
    
    File icon or null if N/A
  - getStartDirectory
```
public static java.lang.String getStartDirectory(android.content.Context sharedPrefContext)
```
    Returns the appropriate starting directory for file dialogs. If the "defaultDirectory" shared preference exists, it will use the value. Otherwise, the "lastDirectory" shared preference value will be used.
    
    Parameters:
    
    sharedPrefContext - The context of the shared preferences to use
    
    Returns:
    
    the "defaultDirectory" shared preference, if exists, it will use the value. Otherwise, the "lastDirectory" shared preference value will be used.
  - getMetersPerPixel
```
public static double getMetersPerPixel(float x,
                                       float y)
```
    Get the estimated meters per pixel at a given point on the screen
    
    Parameters:
    
    x - X coordinate on the screen
    
    y - Y coordinate on the screen
    
    Returns:
    
    Meters or Double.NaN if could not be calculated
  - getMetersPerPixel
```
public static double getMetersPerPixel(android.graphics.PointF point)
```
    Get the estimated meters per pixel at a given point on the screen
    
    Parameters:
    
    point - Point on the screen (x, y)
    
    Returns:
    
    Meters or Double.NaN if could not be calculated
  - getMetersPerPixel
```
public static double getMetersPerPixel(GeoPoint point)
```
    Get the estimated meters per pixel at a given point on the map
    
    Parameters:
    
    point - Point on the map
    
    Returns:
    
    Meters or Double.NaN if could not be calculated
  - getMetersPerPixel
```
public static double getMetersPerPixel()
```
    Get the estimated meters per pixel at the default focus point
    
    Returns:
    
    Meters or Double.NaN if could not be calculated
  - simplifyPoints
```
public static java.util.List<GeoPoint> simplifyPoints(SpatialCalculator calc,
                                                      java.util.Collection<GeoPoint> points)
```
    Helper method for SpatialCalculator#simplify(Collection, double, boolean) Automatically calculates degree threshold using the current DPI
    
    Parameters:
    
    calc - Spatial calcualtor
    
    points - List of points
    
    Returns:
    
    List of simplified points

Class ATAKUtilities

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ATAKUtilities

Method Detail

getDisplayName

isUUID

findSelfUnplaced

findSelf

isSelf

isSelf

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

scaleToFit

getMaximumFocusResolution

getMaximumFocusResolution

getCurrentMagneticVariation

computeGridConvergence

computeGridConvergence

convertFromMagneticToTrue

convertFromTrueToMagnetic

pointInsidePolygon

segmentInsidePolygon

segmentArrayIntersectsOrContainedByPolygon

segmentArrayIntersectionsWithPolygon

computeDistanceOfRayToSegment

geo2Vector

vector2Geo

findAssocShape

getIconUri

getResourceUri

getResourceUri

getIconColor

SetUserIcon

SetUserIcon

SetUserIcon

SetUserIcon

setIcon

SetIcon

SetIcon

getIconBitmap

getUriPath

registerBitmapDecoder

unregisterBitmapDecoder

getUriBitmap

getUriBitmap

toJSON

fromJSON

bytesToHex

hexToBytes

getNonDuplicateName

setIconFromFile

getBitmap

copyClipboard

getContentIcon

getFileIcon

getStartDirectory

getMetersPerPixel

getMetersPerPixel

getMetersPerPixel

getMetersPerPixel

simplifyPoints