com.atakmap.android.image

Class ExifHelper

java.lang.Object

com.atakmap.android.image.ExifHelper

public class ExifHelper
extends java.lang.Object

Reference: https://android.googlesource.com/platform/frameworks/base/+/cd92588/media/java/android/media/ExifInterface.java

Field Summary

Fields

Modifier and Type	Field and Description
static TagInfo	GPS_ALTITUDE Sanselan doesn't properly define certain tags...
static TagInfo	GPS_ALTITUDE_REF
static TagInfo	GPS_DOP
static TagInfo	GPS_IMG_DIRECTION
static TagInfo	GPS_IMG_DIRECTION_REF
static TagInfo	GPS_SOURCE
static TagInfo	GPS_SPEED
static TagInfo	GPS_TRACK
static java.lang.String	TAG
static TagInfo	USER_COMMENT

Constructor Summary

Constructors

Constructor and Description
ExifHelper()

Method Summary

Modifier and Type	Method and Description
static GeoPoint	fixImage(MapView _mapView, java.lang.String path) Use EXIF location, otherwise use self location, default to last known location...
static double	getAltitude(TiffImageMetadata exif, double defaultValue) Get the altitude this image was taken at in meters MSL
static java.lang.Number[]	getDMSArray(double tude) Convert latlng value to DMS number array
static double	getDouble(TiffImageMetadata exif, TagInfo tag, double defaultValue)
static double[]	getDoubleArray(TiffImageMetadata exif, TagInfo tag, double[] defaultValue)
static TiffImageMetadata	getExifMetadata(byte[] blob)
static TiffImageMetadata	getExifMetadata(java.io.File jpegFile)
static TiffOutputSet	getExifOutput(TiffImageMetadata exif)
static boolean	getExtra(TiffImageMetadata exif, java.lang.String key, boolean defaultValue)
static float	getExtra(TiffImageMetadata exif, java.lang.String key, float defaultValue)
static int	getExtra(TiffImageMetadata exif, java.lang.String key, int defaultValue)
static java.lang.Object	getExtra(TiffImageMetadata exif, java.lang.String key, java.lang.Object defValue) Get a single extra parameter
static float	getExtraFloat(TiffImageMetadata exif, java.lang.String key, float defaultValue)
static void	getExtras(TiffImageMetadata exif, java.util.Map<java.lang.String,java.lang.Object> bundle) Convert JSON string in UserComment to a Map (GeoTakCam images only) Fields include: - ImgPitch (float) - ImgRoll (float) - Inclination (float) - HorizontalFOV (float) - VerticalFOV (float) - Address (string)
static java.lang.String	getExtraString(TiffImageMetadata exif, java.lang.String key, java.lang.String defaultValue)
static TiffOutputDirectory	getFieldDirectory(TiffOutputSet tos, TagInfo tag) Get the output directory for a given metadata tag
static int	getImageOrientation(java.io.File img) Returns the image orientation as an integer
static int	getInt(TiffImageMetadata exif, TagInfo tag, int defaultValue)
static double[]	getLatLon(TiffImageMetadata exif)
static GeoPoint	getLocation(TiffImageMetadata exif) Get the GPS location this image was taken it (if available)
static java.lang.String	getString(TiffImageMetadata exif, TagInfo tag, java.lang.String defaultValue)
static long	getTimeStamp(TiffImageMetadata exif, long defaultValue) Get the EXIF GPS time stamp
static void	putExtras(java.util.Map<java.lang.String,java.lang.Object> bundle, TiffOutputSet tos) Put the extras bundle back into the TIFF output set
static boolean	saveExifOutput(TiffOutputSet tos, java.io.File imageFile)
static void	setPNGDescription(java.io.File f, java.lang.String desc) Set PNG description directly by adding/modifying the tEXt chunk
static boolean	setPoint(TiffOutputSet tos, GeoPoint point) Set the point and altitude (if valid)
static boolean	updateField(TiffOutputSet set, TagInfo tag, java.lang.Object data)

Methods inherited from class java.lang.Object

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

Field Detail

TAG

public static final java.lang.String TAG

See Also:

Constant Field Values

GPS_ALTITUDE

public static final TagInfo GPS_ALTITUDE

Sanselan doesn't properly define certain tags...

GPS_ALTITUDE_REF

public static final TagInfo GPS_ALTITUDE_REF

GPS_DOP

public static final TagInfo GPS_DOP

GPS_SOURCE

public static final TagInfo GPS_SOURCE

GPS_SPEED

public static final TagInfo GPS_SPEED

GPS_TRACK

public static final TagInfo GPS_TRACK

GPS_IMG_DIRECTION

public static final TagInfo GPS_IMG_DIRECTION

GPS_IMG_DIRECTION_REF

public static final TagInfo GPS_IMG_DIRECTION_REF

USER_COMMENT

public static final TagInfo USER_COMMENT

Constructor Detail

ExifHelper

public ExifHelper()

Method Detail

getDMSArray

public static java.lang.Number[] getDMSArray(double tude)

Convert latlng value to DMS number array

Parameters:

tude - the latitude or longitude

getImageOrientation

public static int getImageOrientation(java.io.File img)

Returns the image orientation as an integer

Parameters:

img - the image file

Returns:

a value representing the orientation as 0, 90, 180, 270.

getExifMetadata

public static TiffImageMetadata getExifMetadata(java.io.File jpegFile)

getExifMetadata

public static TiffImageMetadata getExifMetadata(byte[] blob)

getExifOutput

public static TiffOutputSet getExifOutput(TiffImageMetadata exif)

getDouble

public static double getDouble(TiffImageMetadata exif,
                               TagInfo tag,
                               double defaultValue)

getInt

public static int getInt(TiffImageMetadata exif,
                         TagInfo tag,
                         int defaultValue)

getString

public static java.lang.String getString(TiffImageMetadata exif,
                                         TagInfo tag,
                                         java.lang.String defaultValue)

getTimeStamp

public static long getTimeStamp(TiffImageMetadata exif,
                                long defaultValue)

Get the EXIF GPS time stamp

Parameters:

exif - Exif metadata

defaultValue - Default timestamp return

Returns:

Time stamp in milliseconds since UNIX epoch

getDoubleArray

public static double[] getDoubleArray(TiffImageMetadata exif,
                                      TagInfo tag,
                                      double[] defaultValue)

getLatLon

public static double[] getLatLon(TiffImageMetadata exif)

getLocation

public static GeoPoint getLocation(TiffImageMetadata exif)

Get the GPS location this image was taken it (if available)

Parameters:

exif - Exif metadata

Returns:

Location as geo point

getAltitude

public static double getAltitude(TiffImageMetadata exif,
                                 double defaultValue)

Get the altitude this image was taken at in meters MSL

Parameters:

exif - Exif metadata

defaultValue - Default elevation (meters MSL)

Returns:

Elevation (meters MSL)

setPoint

public static boolean setPoint(TiffOutputSet tos,
                               GeoPoint point)

Set the point and altitude (if valid)

Parameters:

tos - EXIF output set

point - Point to set

getExtras

public static void getExtras(TiffImageMetadata exif,
                             java.util.Map<java.lang.String,java.lang.Object> bundle)

Convert JSON string in UserComment to a Map (GeoTakCam images only) Fields include: - ImgPitch (float) - ImgRoll (float) - Inclination (float) - HorizontalFOV (float) - VerticalFOV (float) - Address (string)

putExtras

public static void putExtras(java.util.Map<java.lang.String,java.lang.Object> bundle,
                             TiffOutputSet tos)

Put the extras bundle back into the TIFF output set

Parameters:

bundle - Extras bundle

tos - TIFF output set

getExtra

public static java.lang.Object getExtra(TiffImageMetadata exif,
                                        java.lang.String key,
                                        java.lang.Object defValue)

Get a single extra parameter

Parameters:

exif - Exif metadata

key - Extra key

defValue - Extra default value

Returns:

The extra value (defValue if null or cannot be converted)

getExtra

public static int getExtra(TiffImageMetadata exif,
                           java.lang.String key,
                           int defaultValue)

getExtra

public static float getExtra(TiffImageMetadata exif,
                             java.lang.String key,
                             float defaultValue)

getExtra

public static boolean getExtra(TiffImageMetadata exif,
                               java.lang.String key,
                               boolean defaultValue)

getExtraFloat

public static float getExtraFloat(TiffImageMetadata exif,
                                  java.lang.String key,
                                  float defaultValue)

getExtraString

public static java.lang.String getExtraString(TiffImageMetadata exif,
                                              java.lang.String key,
                                              java.lang.String defaultValue)

updateField

public static boolean updateField(TiffOutputSet set,
                                  TagInfo tag,
                                  java.lang.Object data)

getFieldDirectory

public static TiffOutputDirectory getFieldDirectory(TiffOutputSet tos,
                                                    TagInfo tag)

Get the output directory for a given metadata tag

Parameters:

tos - TIFF output set

tag - Metadata tag

Returns:

Output directory or null if error

saveExifOutput

public static boolean saveExifOutput(TiffOutputSet tos,
                                     java.io.File imageFile)

fixImage

public static GeoPoint fixImage(MapView _mapView,
                                java.lang.String path)

Use EXIF location, otherwise use self location, default to last known location...

Returns:

setPNGDescription

public static void setPNGDescription(java.io.File f,
                                     java.lang.String desc)

Set PNG description directly by adding/modifying the tEXt chunk

Parameters:

f - The PNG file to modify

desc - The image description