Exify

java.lang.Object
- ly.img.android.sdk.exif.Exify

```
public class Exify
extends java.lang.Object
```
This class provides methods and constants for reading and writing jpeg file metadata. It contains a collection of ExifTags, and a collection of definitions for creating valid ExifTags. The collection of ExifTags can be updated by: reading new ones from a file, deleting or adding existing ones, or building new ExifTags from a tag definition. These ExifTags can be written to a valid jpeg image as exif metadata.
Each ExifTag has a tag ID (TID) and is stored in a specific image file directory (IFD) as specified by the exif standard. A tag definition can be looked up with a constant that is a combination of TID and IFD. This definition has information about the type, number of components, and valid IFDs for a ExifTagKey.

See Also:

ExifTagInfo

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`Exify.ColorSpace` Constants for `#ExifTagKey.COLOR_SPACE`
`static interface`	`Exify.ComponentsConfiguration` Constants for `#ExifTagKey.COMPONENTS_CONFIGURATION`
`static interface`	`Exify.Compression` Constants for `#ExifTagKey.COMPRESSION`
`static interface`	`Exify.Contrast` Constants for `#ExifTagKey.CONTRAST`
`static interface`	`Exify.ExposureMode` Constants for `#ExifTagKey.EXPOSURE_MODE`
`static interface`	`Exify.ExposureProgram` Constants for `#ExifTagKey.EXPOSURE_PROGRAM`
`static interface`	`Exify.FileSource` Constants for `#ExifTagKey.FILE_SOURCE`
`static interface`	`Exify.Flash` Constants for `#ExifTagKey.FLASH` As the definition in Jeita EXIF 2.2
`static interface`	`Exify.GainControl` Constants for `#ExifTagKey.GAIN_CONTROL`
`static interface`	`Exify.GpsAltitudeRef` Constants for `#ExifTagKey.GPS_ALTITUDE_REF`
`static interface`	`Exify.GpsDifferential` Constants for `#ExifTagKey.GPS_DIFFERENTIAL`
`static interface`	`Exify.GpsLatitudeRef` Constants for `#ExifTagKey.GPS_LATITUDE_REF`, `#ExifTagKey.GPS_DEST_LATITUDE_REF`
`static interface`	`Exify.GpsLongitudeRef` Constants for `#ExifTagKey.GPS_LONGITUDE_REF`, `#ExifTagKey.GPS_DEST_LONGITUDE_REF`
`static interface`	`Exify.GpsMeasureMode` Constants for `#ExifTagKey.GPS_MEASURE_MODE`
`static interface`	`Exify.GpsSpeedRef` Constants for `#ExifTagKey.GPS_SPEED_REF`, `#ExifTagKey.GPS_DEST_DISTANCE_REF`
`static interface`	`Exify.GpsStatus` Constants for `#ExifTagKey.GPS_STATUS`
`static interface`	`Exify.GpsTrackRef` Constants for `#ExifTagKey.GPS_TRACK_REF`, `#ExifTagKey.GPS_IMG_DIRECTION_REF`, `#ExifTagKey.GPS_DEST_BEARING_REF`
`static interface`	`Exify.JpegProcess` Constants for the jpeg process algorithm used.
`static interface`	`Exify.LightSource` Constants for `#ExifTagKey.LIGHT_SOURCE`
`static interface`	`Exify.MeteringMode` Constants for `#ExifTagKey.METERING_MODE`
`static interface`	`Exify.Options` Options for calling `readExif(InputStream, int)`, `readExif(byte[], int)`, `readExif(String, int)`
`static interface`	`Exify.Orientation` Constants for `#ExifTagKey.ORIENTATION`.
`static interface`	`Exify.PhotometricInterpretation` Constants for `#ExifTagKey.PHOTOMETRIC_INTERPRETATION`
`static interface`	`Exify.PlanarConfiguration` Constants for `#ExifTagKey.PLANAR_CONFIGURATION`
`static interface`	`Exify.ResolutionUnit` Constants for `#ExifTagKey.RESOLUTION_UNIT`
`static interface`	`Exify.Saturation` Constants for `#ExifTagKey.SATURATION`
`static interface`	`Exify.SceneCapture` Constants for `#ExifTagKey.SCENE_CAPTURE_TYPE`
`static interface`	`Exify.SceneType` Constants for `#ExifTagKey.SCENE_TYPE`
`static interface`	`Exify.SensingMethod` Constants for `#ExifTagKey.SENSING_METHOD`
`static interface`	`Exify.SensitivityType` Constants for the `#ExifTagKey.SENSITIVITY_TYPE` tag
`static interface`	`Exify.Sharpness` Constants for `#ExifTagKey.SHARPNESS`
`static interface`	`Exify.SubjectDistance` Constants for `#ExifTagKey.SUBJECT_DISTANCE`
`static class`	`Exify.TAG`
`static interface`	`Exify.WhiteBalance` Constants for `#ExifTagKey.WHITE_BALANCE`
`static interface`	`Exify.YCbCrPositioning` Constants for `#ExifTagKey.Y_CB_CR_POSITIONING`

Field Summary

Fields
Modifier and Type	Field and Description
`static java.nio.ByteOrder`	`DEFAULT_BYTE_ORDER`
`static int`	`DEFINITION_NULL`
`static int`	`IFD_NULL`
`protected static java.util.HashSet<java.lang.Short>`	`sBannedDefines` Tags with definitions that cannot be overridden (banned defines).
`static int`	`TAG_NULL`

Constructor Summary

Constructors
Constructor and Description

Exify()

Constructors
Constructor and Description
`Exify()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`addDateTimeStampTag(Exify.TAG tag, long timestamp, java.util.TimeZone timezone)` Creates, formats, and sets the DateTimeStamp tag for one of: `#ExifTagKey.DATE_TIME`, `#ExifTagKey.DATE_TIME_DIGITIZED`, `#ExifTagKey.DATE_TIME_ORIGINAL`.
`boolean`	`addGpsDateTimeStampTag(long timestamp)` Creates and sets the GPS timestamp ExifTagKey.
`boolean`	`addGpsTags(double latitude, double longitude)` Creates and sets all to the GPS tags for a give latitude and longitude.
`ExifTagInfo`	`buildTag(Exify.TAG tag, java.lang.Object val)` Creates a tag for a defined tag constant in the tag's default IFD.
`ExifTagInfo`	`buildTag(int tagId, int ifdId, java.lang.Object val)` Creates a tag for a defined tag constant in a given IFD if that IFD is allowed for the ExifTagKey.
`protected ExifTagInfo`	`buildUninitializedTag(Exify.TAG tag)`
`protected ExifTagInfo`	`buildUninitializedTag(int tagId)`
`void`	`clearExif()` Clears this ExifInterface object's existing exif tags.
`protected static void`	`closeSilently(java.io.Closeable c)`
`static double`	`convertLatOrLongToDouble(Rational[] coordinate, java.lang.String reference)` Gets the double representation of the GPS latitude or longitude coordinate.
`static int`	`defineTag(int ifdId, short tagId)` Returns the constant representing a tag with a given TID and default IFD.
`void`	`deleteTag(Exify.TAG tag)` Removes the ExifTag for a tag constant from that tag's default IFD.
`void`	`deleteTag(int tagId)` Removes the ExifTag for a tag constant from that tag's default IFD.
`void`	`deleteTag(int tagId, int ifdId)` Removes the ExifTag for a tag constant from the given IFD.
`int`	`getActualTagCount(int tagId, int ifdId)` Gets the number of elements for an ExifTag in a given IFD.
`protected static int`	`getAllowedIfdFlagsFromInfo(int info)`
`protected static int[]`	`getAllowedIfdsFromInfo(int info)`
`java.util.List<ExifTagInfo>`	`getAllTags()` Get the exif tags in this ExifInterface object or null if none exist.
`double`	`getAltitude(double defaultValue)` Return the altitude in meters.
`double`	`getApertureSize()` Return the aperture size, if present, 0 if missing
`protected static int`	`getComponentCountFromInfo(int info)`
`static java.util.Date`	`getDateTime(java.lang.String dateTimeString, java.util.TimeZone timeZone)` Given an exif date time, like `#ExifTagKey.DATE_TIME` or `#ExifTagKey.DATE_TIME_DIGITIZED` returns a java Date object
`int`	`getDefinedTagCount(Exify.TAG tag)` Gets the defined number of elements for a ExifTagKey.
`int`	`getDefinedTagCount(int tagId)` Gets the defined number of elements for a ExifTagKey.
`int`	`getDefinedTagDefaultIfd(int tagId)` Gets the default IFD for a ExifTagKey.
`short`	`getDefinedTagType(int tagId)` Gets the defined type for a ExifTagKey.
`protected static int`	`getFlagsFromAllowedIfds(int[] allowedIfds)`
`int[]`	`getImageSize()` Returns the Image size as decoded from the SOF marker
`short`	`getJpegProcess()` this gives information about the process used to create the JPEG file.
`java.lang.String`	`getLatitude()` Returns a formatted String with the latitude representation: 39° 8' 16.8" N
`double[]`	`getLatLongAsDoubles()` Gets the GPS latitude and longitude as a pair of doubles from this ExifInterface object's tags, or null if the necessary tags do not exist.
`java.lang.String`	`getLensModelDescription()` Returns the lens model as string if any of the tags `#ExifTagKey.LENS_MODEL` or `#ExifTagKey.LENS_SPECS` are found
`java.lang.String`	`getLongitude()` Returns a formatted String with the longitude representation: 77° 37' 51.6" W
`static short`	`getOrientationValueForRotation(int degrees)` Returns the Orientation ExifTag value for a given number of degrees.
`int`	`getQualityGuess()` Returns the JPEG quality used to generate the image or 0 if not found
`double`	`getResolutionUnit(int resolution)` Given the value from `#ExifTagKey.FOCAL_PLANE_RESOLUTION_UNIT` or `#ExifTagKey.RESOLUTION_UNIT` this method will return the corresponding value in millimeters
`static int`	`getRotationForOrientationValue(short orientation)` Returns the rotation degrees corresponding to an ExifTag Orientation value.
`ExifTagInfo`	`getTag(Exify.TAG tag)` Returns the ExifTag in that tag's default IFD for a defined tag constant or null if none exists.
`ExifTagInfo`	`getTag(int tagId)` Returns the ExifTag in that tag's default IFD for a defined tag constant or null if none exists.
`ExifTagInfo`	`getTag(int tagId, int ifdId)` Gets an ExifTag for an IFD other than the tag's default.
`java.lang.Byte`	`getTagByteValue(Exify.TAG tag)`
`java.lang.Byte`	`getTagByteValue(int tagId)`
`java.lang.Byte`	`getTagByteValue(int tagId, int ifdId)`
`byte[]`	`getTagByteValues(Exify.TAG tag)`
`byte[]`	`getTagByteValues(int tagId)`
`byte[]`	`getTagByteValues(int tagId, int ifdId)`
`protected int`	`getTagDefinition(short tagId, int defaultIfd)`
`protected int`	`getTagDefinitionForTag(ExifTagInfo tag)`
`protected int`	`getTagDefinitionForTag(short tagId, short type, int count, int ifd)`
`protected int[]`	`getTagDefinitionsForTagId(short tagId)`
`protected android.util.SparseIntArray`	`getTagInfo()`
`java.lang.Integer`	`getTagIntValue(Exify.TAG tag)`
`java.lang.Integer`	`getTagIntValue(int tagId)`
`java.lang.Integer`	`getTagIntValue(int tagId, int ifdId)`
`int[]`	`getTagIntValues(Exify.TAG tag)`
`int[]`	`getTagIntValues(int tagId)`
`int[]`	`getTagIntValues(int tagId, int ifdId)`
`java.lang.Long`	`getTagLongValue(Exify.TAG tag)`
`java.lang.Long`	`getTagLongValue(int tagId)`
`java.lang.Long`	`getTagLongValue(int tagId, int ifdId)`
`long[]`	`getTagLongValues(Exify.TAG tag)`
`long[]`	`getTagLongValues(int tagId)`
`long[]`	`getTagLongValues(int tagId, int ifdId)`
`Rational`	`getTagRationalValue(Exify.TAG tag)`
`Rational`	`getTagRationalValue(int tagId)`
`Rational`	`getTagRationalValue(int tagId, int ifdId)`
`Rational[]`	`getTagRationalValues(Exify.TAG tag)`
`Rational[]`	`getTagRationalValues(int tagId)`
`Rational[]`	`getTagRationalValues(int tagId, int ifdId)`
`java.util.List<ExifTagInfo>`	`getTagsForIfdId(int ifdId)` Returns a list of ExifTags that share an IFD (which can be obtained by calling `getTrueIfd(int)` on a defined tag constant) or null if none exist.
`java.util.List<ExifTagInfo>`	`getTagsForTagId(short tagId)` Returns a list of ExifTags that share a TID (which can be obtained by calling `getTrueTagKey(ly.img.android.sdk.exif.Exify.TAG)` on a defined tag constant) or null if none exist.
`java.lang.String`	`getTagStringValue(Exify.TAG tag)`
`java.lang.String`	`getTagStringValue(int tagId)`
`java.lang.String`	`getTagStringValue(int tagId, int ifdId)`
`java.lang.Object`	`getTagValue(Exify.TAG tag)` Returns the value of the ExifTag in that tag's default IFD for a defined tag constant or null if none exists or the value could not be cast into the return type.
`java.lang.Object`	`getTagValue(int tagId)` Returns the value of the ExifTag in that tag's default IFD for a defined tag constant or null if none exists or the value could not be cast into the return type.
`java.lang.Object`	`getTagValue(int tagId, int ifdId)` Gets a tag value for an IFD other than the tag's default.
`byte[]`	`getThumbnail()` Returns the thumbnail if it is jpeg compressed, or null if none exists.
`android.graphics.Bitmap`	`getThumbnailBitmap()` Returns the thumbnail from IFD1 as a bitmap, or null if none exists.
`byte[]`	`getThumbnailBytes()` Returns the thumbnail from IFD1 as a byte array, or null if none exists.
`static int`	`getTrueIfd(Exify.TAG tag)` Returns the default IFD for a tag constant.
`static int`	`getTrueIfd(int tag)` Returns the default IFD for a tag constant.
`static short`	`getTrueTagKey(Exify.TAG tag)` Returns the TID for a tag constant.
`static short`	`getTrueTagKey(int tag)` Returns the TID for a tag constant.
`protected static short`	`getTypeFromInfo(int info)`
`java.lang.String`	`getUserComment()` Decodes the user comment tag into string as specified in the EXIF standard.
`boolean`	`hasThumbnail()` Check if thumbnail exists.
`protected static boolean`	`isIfdAllowed(int info, int ifd)`
`protected static boolean`	`isOffsetTag(short tag)` Returns true if tag TID is one of the following: `#ExifTagKey.EXIF_IFD`, `#ExifTagKey.GPS_IFD`, `#ExifTagKey.JPEG_INTERCHANGE_FORMAT`, `#ExifTagKey.STRIP_OFFSETS`, `#ExifTagKey.INTEROPERABILITY_IFD` Note: defining tags with these TID's is disallowed.
`boolean`	`isTagCountDefined(int tagId)` Checks whether a tag has a defined number of elements.
`boolean`	`isThumbnailCompressed()` Check if thumbnail is compressed.
`void`	`readExif(byte[] jpeg, int options)` Reads the exif tags from a byte array, clearing this ExifInterface object's existing exif tags.
`void`	`readExif(java.io.InputStream inStream, int options)` Reads the exif tags from an InputStream, clearing this ExifInterface object's existing exif tags.
`void`	`readExif(java.lang.String inFileName, int options)` Reads the exif tags from a file, clearing this ExifInterface object's existing exif tags.
`void`	`removeCompressedThumbnail()` Clears the compressed thumbnail if it exists.
`void`	`removeTagDefinition(int tagId)` Removes a tag definition for given defined tag constant.
`void`	`resetTagDefinitions()` Resets tag definitions to the default ones.
`boolean`	`setCompressedThumbnail(android.graphics.Bitmap thumb)` Sets the thumbnail to be a jpeg compressed bitmap.
`boolean`	`setCompressedThumbnail(byte[] thumb)` Sets the thumbnail to be a jpeg compressed image.
`void`	`setExif(java.util.Collection<ExifTagInfo> tags)` Sets the exif tags, clearing this ExifInterface object's existing exif tags.
`ExifTagInfo`	`setTag(ExifTagInfo tag)` Puts an ExifTag into this ExifInterface object's tags, removing a previous ExifTag with the same TID and IFD.
`int`	`setTagDefinition(short tagId, int defaultIfd, short tagType, short defaultComponentCount, int[] allowedIfds)` Creates a new tag definition in this ExifInterface object for a given TID and default IFD.
`void`	`setTags(java.util.Collection<ExifTagInfo> tags)` Puts a collection of ExifTags into this ExifInterface objects's tags.
`boolean`	`setTagValue(Exify.TAG tag, java.lang.Object val)` Sets the value of an ExifTag if it exists it's default IFD.
`boolean`	`setTagValue(int tagId, int ifdId, java.lang.Object val)` Sets the value of an ExifTag if it exists in the given IFD.
`boolean`	`setTagValue(int tagId, java.lang.Object val)` Sets the value of an ExifTag if it exists it's default IFD.
`static byte[]`	`toBitArray(short value)`
`void`	`writeExif(android.graphics.Bitmap input, java.lang.String dstFilename, int quality)`
`void`	`writeExif(java.io.InputStream input, java.lang.String dstFilename)`
`void`	`writeExif(java.lang.String dstFilename)`
`void`	`writeExif(java.lang.String srcFilename, java.lang.String dstFilename)`

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

- Field Detail
  - DEFAULT_BYTE_ORDER
```
public static final java.nio.ByteOrder DEFAULT_BYTE_ORDER
```
  - DEFINITION_NULL
```
public static final int DEFINITION_NULL
```
    See Also:
    
    Constant Field Values
  - IFD_NULL
```
public static final int IFD_NULL
```
    See Also:
    
    Constant Field Values
  - sBannedDefines
```
protected static java.util.HashSet<java.lang.Short> sBannedDefines
```
    Tags with definitions that cannot be overridden (banned defines).
  - TAG_NULL
```
public static final int TAG_NULL
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Exify
```
public Exify()
```
- Method Detail
  - addDateTimeStampTag
```
public boolean addDateTimeStampTag(Exify.TAG tag,
                                   long timestamp,
                                   java.util.TimeZone timezone)
```
    Creates, formats, and sets the DateTimeStamp tag for one of: #ExifTagKey.DATE_TIME, #ExifTagKey.DATE_TIME_DIGITIZED, #ExifTagKey.DATE_TIME_ORIGINAL.
    
    Parameters:
    
    tag - one of the DateTimeStamp tags.
    
    timestamp - a timestamp to format.
    
    timezone - a TimeZone object.
    
    Returns:
    
    true if success, false if the tag could not be set.
  - addGpsDateTimeStampTag
```
public boolean addGpsDateTimeStampTag(long timestamp)
```
    Creates and sets the GPS timestamp ExifTagKey.
    
    Parameters:
    
    timestamp - a GPS timestamp.
    
    Returns:
    
    true if success, false if could not be created or set.
  - addGpsTags
```
public boolean addGpsTags(double latitude,
                          double longitude)
```
    Creates and sets all to the GPS tags for a give latitude and longitude.
    
    Parameters:
    
    latitude - a GPS latitude coordinate.
    
    longitude - a GPS longitude coordinate.
    
    Returns:
    
    true if success, false if they could not be created or set.
  - buildTag
```
public ExifTagInfo buildTag(Exify.TAG tag,
                            java.lang.Object val)
```
    Creates a tag for a defined tag constant in the tag's default IFD.
    
    Parameters:
    
    tag - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    val - the tag's value.
    
    Returns:
    
    an ExifTag object.
  - buildTag
```
public ExifTagInfo buildTag(int tagId,
                            int ifdId,
                            java.lang.Object val)
```
    Creates a tag for a defined tag constant in a given IFD if that IFD is allowed for the ExifTagKey. This method will fail anytime the appropriate ExifTagInfo.setValue(int[]) for this tag's datatype would fail.
    
    Parameters:
    
    tagId - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    ifdId - the IFD that the tag should be in.
    
    val - the value of the tag to set.
    
    Returns:
    
    an ExifTag object or null if one could not be constructed.
    
    See Also:
    
    buildTag(ly.img.android.sdk.exif.Exify.TAG, java.lang.Object)
  - buildUninitializedTag
```
protected ExifTagInfo buildUninitializedTag(Exify.TAG tag)
```
  - buildUninitializedTag
```
protected ExifTagInfo buildUninitializedTag(int tagId)
```
  - clearExif
```
public void clearExif()
```
    Clears this ExifInterface object's existing exif tags.
  - closeSilently
```
protected static void closeSilently(java.io.Closeable c)
```
  - convertLatOrLongToDouble
```
public static double convertLatOrLongToDouble(Rational[] coordinate,
                                              java.lang.String reference)
```
    Gets the double representation of the GPS latitude or longitude coordinate.
    
    Parameters:
    
    coordinate - an array of 3 Rationals representing the degrees, minutes, and seconds of the GPS location as defined in the exif specification.
    
    reference - a GPS reference reperesented by a String containing "N", "S", "E", or "W".
    
    Returns:
    
    the GPS coordinate represented as degrees + minutes/60 + seconds/3600
  - defineTag
```
public static int defineTag(int ifdId,
                            short tagId)
```
    Returns the constant representing a tag with a given TID and default IFD.
  - deleteTag
```
public void deleteTag(Exify.TAG tag)
```
    Removes the ExifTag for a tag constant from that tag's default IFD.
    
    Parameters:
    
    tag - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
  - deleteTag
```
public void deleteTag(int tagId)
```
    Removes the ExifTag for a tag constant from that tag's default IFD.
    
    Parameters:
    
    tagId - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
  - deleteTag
```
public void deleteTag(int tagId,
                      int ifdId)
```
    Removes the ExifTag for a tag constant from the given IFD.
    
    Parameters:
    
    tagId - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    ifdId - the IFD of the ExifTag to remove.
  - getActualTagCount
```
public int getActualTagCount(int tagId,
                             int ifdId)
```
    Gets the number of elements for an ExifTag in a given IFD.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    ifdId - the IFD containing the ExifTag to check.
    
    Returns:
    
    the number of elements in the ExifTag, if the tag's size is undefined this will return the actual number of elements that is in the ExifTag's value.
  - getAllowedIfdFlagsFromInfo
```
protected static int getAllowedIfdFlagsFromInfo(int info)
```
  - getAllowedIfdsFromInfo
```
protected static int[] getAllowedIfdsFromInfo(int info)
```
  - getAllTags
```
public java.util.List<ExifTagInfo> getAllTags()
```
    Get the exif tags in this ExifInterface object or null if none exist.
    
    Returns:
    
    a List of ExifTagInfos.
  - getAltitude
```
public double getAltitude(double defaultValue)
```
    Return the altitude in meters. If the exif tag does not exist, return defaultValue.
    
    Parameters:
    
    defaultValue - the value to return if the tag is not available.
  - getApertureSize
```
public double getApertureSize()
```
    Return the aperture size, if present, 0 if missing
  - getComponentCountFromInfo
```
protected static int getComponentCountFromInfo(int info)
```
  - getDateTime
```
public static java.util.Date getDateTime(java.lang.String dateTimeString,
                                         java.util.TimeZone timeZone)
```
    Given an exif date time, like #ExifTagKey.DATE_TIME or #ExifTagKey.DATE_TIME_DIGITIZED returns a java Date object
    
    Parameters:
    
    dateTimeString - one of the value of #ExifTagKey.DATE_TIME or #ExifTagKey.DATE_TIME_DIGITIZED
    
    timeZone - the target timezone
    
    Returns:
    
    the parsed date
  - getDefinedTagCount
```
public int getDefinedTagCount(Exify.TAG tag)
```
    Gets the defined number of elements for a ExifTagKey.
    
    Parameters:
    
    tag - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    the number of elements or ExifTagInfo.SIZE_UNDEFINED if the tag or the number of elements is not defined.
  - getDefinedTagCount
```
public int getDefinedTagCount(int tagId)
```
    Gets the defined number of elements for a ExifTagKey.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    the number of elements or ExifTagInfo.SIZE_UNDEFINED if the tag or the number of elements is not defined.
  - getDefinedTagDefaultIfd
```
public int getDefinedTagDefaultIfd(int tagId)
```
    Gets the default IFD for a ExifTagKey.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    the default IFD for a tag definition or IFD_NULL if no definition exists.
  - getDefinedTagType
```
public short getDefinedTagType(int tagId)
```
    Gets the defined type for a ExifTagKey.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    the type.
    
    See Also:
    
    ExifTagInfo.getDataType()
  - getFlagsFromAllowedIfds
```
protected static int getFlagsFromAllowedIfds(int[] allowedIfds)
```
  - getImageSize
```
public int[] getImageSize()
```
    Returns the Image size as decoded from the SOF marker
  - getJpegProcess
```
public short getJpegProcess()
```
    this gives information about the process used to create the JPEG file. Possible values are:
    - '0' Unknown
    - '192' Baseline
    - '193' Extended sequential
    - '194' Progressive
    - '195' Lossless
    - '197' Differential sequential
    - '198' Differential progressive
    - '199' Differential lossless
    - '201' Extended sequential, arithmetic coding
    - '202' Progressive, arithmetic coding
    - '203' Lossless, arithmetic coding
    - '205' Differential sequential, arithmetic coding
    - '206' Differential progressive, arithmetic codng
    - '207' Differential lossless, arithmetic coding
  - getLatitude
```
public java.lang.String getLatitude()
```
    Returns a formatted String with the latitude representation:
    39° 8' 16.8" N
  - getLatLongAsDoubles
```
public double[] getLatLongAsDoubles()
```
    Gets the GPS latitude and longitude as a pair of doubles from this ExifInterface object's tags, or null if the necessary tags do not exist.
    
    Returns:
    
    an array of 2 doubles containing the latitude, and longitude respectively.
    
    See Also:
    
    convertLatOrLongToDouble(ly.img.android.sdk.exif.Rational[], java.lang.String)
  - getLensModelDescription
```
public java.lang.String getLensModelDescription()
```
    Returns the lens model as string if any of the tags #ExifTagKey.LENS_MODEL or #ExifTagKey.LENS_SPECS are found
    
    Returns:
    
    the string representation of the lens spec
  - getLongitude
```
public java.lang.String getLongitude()
```
    Returns a formatted String with the longitude representation:
    77° 37' 51.6" W
  - getOrientationValueForRotation
```
public static short getOrientationValueForRotation(int degrees)
```
    Returns the Orientation ExifTag value for a given number of degrees.
    
    Parameters:
    
    degrees - the amount an image is rotated in degrees.
  - getQualityGuess
```
public int getQualityGuess()
```
    Returns the JPEG quality used to generate the image or 0 if not found
    
    Returns:
  - getResolutionUnit
```
public double getResolutionUnit(int resolution)
```
    Given the value from #ExifTagKey.FOCAL_PLANE_RESOLUTION_UNIT or #ExifTagKey.RESOLUTION_UNIT this method will return the corresponding value in millimeters
    
    Parameters:
    
    resolution - #ExifTagKey.FOCAL_PLANE_RESOLUTION_UNIT or #ExifTagKey.RESOLUTION_UNIT
    
    Returns:
    
    resolution in millimeters
  - getRotationForOrientationValue
```
public static int getRotationForOrientationValue(short orientation)
```
    Returns the rotation degrees corresponding to an ExifTag Orientation value.
    
    Parameters:
    
    orientation - the ExifTag Orientation value.
  - getTag
```
public ExifTagInfo getTag(Exify.TAG tag)
```
    Returns the ExifTag in that tag's default IFD for a defined tag constant or null if none exists.
    
    Parameters:
    
    tag - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    an ExifTagInfo or null if none exists.
  - getTag
```
public ExifTagInfo getTag(int tagId)
```
    Returns the ExifTag in that tag's default IFD for a defined tag constant or null if none exists.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    an ExifTagInfo or null if none exists.
  - getTag
```
public ExifTagInfo getTag(int tagId,
                          int ifdId)
```
    Gets an ExifTag for an IFD other than the tag's default.
    
    See Also:
    
    getTag(int)
  - getTagByteValue
```
public java.lang.Byte getTagByteValue(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagByteValue
```
public java.lang.Byte getTagByteValue(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagByteValue
```
public java.lang.Byte getTagByteValue(int tagId,
                                      int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagByteValues
```
public byte[] getTagByteValues(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagByteValues
```
public byte[] getTagByteValues(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagByteValues
```
public byte[] getTagByteValues(int tagId,
                               int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagDefinition
```
protected int getTagDefinition(short tagId,
                               int defaultIfd)
```
  - getTagDefinitionForTag
```
protected int getTagDefinitionForTag(ExifTagInfo tag)
```
  - getTagDefinitionForTag
```
protected int getTagDefinitionForTag(short tagId,
                                     short type,
                                     int count,
                                     int ifd)
```
  - getTagDefinitionsForTagId
```
protected int[] getTagDefinitionsForTagId(short tagId)
```
  - getTagInfo
```
protected android.util.SparseIntArray getTagInfo()
```
  - getTagIntValue
```
public java.lang.Integer getTagIntValue(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagIntValue
```
public java.lang.Integer getTagIntValue(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagIntValue
```
public java.lang.Integer getTagIntValue(int tagId,
                                        int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagIntValues
```
public int[] getTagIntValues(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagIntValues
```
public int[] getTagIntValues(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagIntValues
```
public int[] getTagIntValues(int tagId,
                             int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagLongValue
```
public java.lang.Long getTagLongValue(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagLongValue
```
public java.lang.Long getTagLongValue(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagLongValue
```
public java.lang.Long getTagLongValue(int tagId,
                                      int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagLongValues
```
public long[] getTagLongValues(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagLongValues
```
public long[] getTagLongValues(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagLongValues
```
public long[] getTagLongValues(int tagId,
                               int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagRationalValue
```
public Rational getTagRationalValue(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagRationalValue
```
public Rational getTagRationalValue(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagRationalValue
```
public Rational getTagRationalValue(int tagId,
                                    int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagRationalValues
```
public Rational[] getTagRationalValues(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagRationalValues
```
public Rational[] getTagRationalValues(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagRationalValues
```
public Rational[] getTagRationalValues(int tagId,
                                       int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagsForIfdId
```
public java.util.List<ExifTagInfo> getTagsForIfdId(int ifdId)
```
    Returns a list of ExifTags that share an IFD (which can be obtained by calling getTrueIfd(int) on a defined tag constant) or null if none exist.
    
    Parameters:
    
    ifdId - an IFD as defined in the exif standard (or with defineTag(int, short)).
    
    Returns:
    
    a List of ExifTagInfos.
  - getTagsForTagId
```
public java.util.List<ExifTagInfo> getTagsForTagId(short tagId)
```
    Returns a list of ExifTags that share a TID (which can be obtained by calling getTrueTagKey(ly.img.android.sdk.exif.Exify.TAG) on a defined tag constant) or null if none exist.
    
    Parameters:
    
    tagId - a TID as defined in the exif standard (or with defineTag(int, short)).
    
    Returns:
    
    a List of ExifTagInfos.
  - getTagStringValue
```
public java.lang.String getTagStringValue(Exify.TAG tag)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagStringValue
```
public java.lang.String getTagStringValue(int tagId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagStringValue
```
public java.lang.String getTagStringValue(int tagId,
                                          int ifdId)
```
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getTagValue
```
public java.lang.Object getTagValue(Exify.TAG tag)
```
    Returns the value of the ExifTag in that tag's default IFD for a defined tag constant or null if none exists or the value could not be cast into the return type.
    
    Parameters:
    
    tag - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    the value of the ExifTag or null if none exists.
  - getTagValue
```
public java.lang.Object getTagValue(int tagId)
```
    Returns the value of the ExifTag in that tag's default IFD for a defined tag constant or null if none exists or the value could not be cast into the return type.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    the value of the ExifTag or null if none exists.
  - getTagValue
```
public java.lang.Object getTagValue(int tagId,
                                    int ifdId)
```
    Gets a tag value for an IFD other than the tag's default.
    
    See Also:
    
    getTagValue(ly.img.android.sdk.exif.Exify.TAG)
  - getThumbnail
```
public byte[] getThumbnail()
```
    Returns the thumbnail if it is jpeg compressed, or null if none exists.
    
    Returns:
    
    the thumbnail as a byte array.
  - getThumbnailBitmap
```
public android.graphics.Bitmap getThumbnailBitmap()
```
    Returns the thumbnail from IFD1 as a bitmap, or null if none exists.
    
    Returns:
    
    the thumbnail as a bitmap.
  - getThumbnailBytes
```
public byte[] getThumbnailBytes()
```
    Returns the thumbnail from IFD1 as a byte array, or null if none exists. The bytes may either be an uncompressed strip as specified in the exif standard or a jpeg compressed image.
    
    Returns:
    
    the thumbnail as a byte array.
  - getTrueIfd
```
public static int getTrueIfd(Exify.TAG tag)
```
    Returns the default IFD for a tag constant.
  - getTrueIfd
```
public static int getTrueIfd(int tag)
```
    Returns the default IFD for a tag constant.
  - getTrueTagKey
```
public static short getTrueTagKey(Exify.TAG tag)
```
    Returns the TID for a tag constant.
  - getTrueTagKey
```
public static short getTrueTagKey(int tag)
```
    Returns the TID for a tag constant.
  - getTypeFromInfo
```
protected static short getTypeFromInfo(int info)
```
  - getUserComment
```
public java.lang.String getUserComment()
```
    Decodes the user comment tag into string as specified in the EXIF standard. Returns null if decoding failed.
  - hasThumbnail
```
public boolean hasThumbnail()
```
    Check if thumbnail exists.
    
    Returns:
    
    true if a compressed thumbnail exists.
  - isIfdAllowed
```
protected static boolean isIfdAllowed(int info,
                                      int ifd)
```
  - isOffsetTag
```
protected static boolean isOffsetTag(short tag)
```
    Returns true if tag TID is one of the following: #ExifTagKey.EXIF_IFD, #ExifTagKey.GPS_IFD, #ExifTagKey.JPEG_INTERCHANGE_FORMAT, #ExifTagKey.STRIP_OFFSETS, #ExifTagKey.INTEROPERABILITY_IFD
    Note: defining tags with these TID's is disallowed.
    
    Parameters:
    
    tag - a tag's TID (can be obtained from a defined tag constant with getTrueTagKey(ly.img.android.sdk.exif.Exify.TAG)).
    
    Returns:
    
    true if the TID is that of an offset ExifTagKey.
  - isTagCountDefined
```
public boolean isTagCountDefined(int tagId)
```
    Checks whether a tag has a defined number of elements.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    Returns:
    
    true if the tag has a defined number of elements.
  - isThumbnailCompressed
```
public boolean isThumbnailCompressed()
```
    Check if thumbnail is compressed.
    
    Returns:
    
    true if the thumbnail is compressed.
  - readExif
```
public void readExif(byte[] jpeg,
                     int options)
              throws java.io.IOException
```
    Reads the exif tags from a byte array, clearing this ExifInterface object's existing exif tags.
    
    Parameters:
    
    jpeg - a byte array containing a jpeg compressed image.
    
    options - bit flag which defines which type of tags to process, see Exify.Options
    
    Throws:
    
    java.io.IOException
    
    See Also:
    
    readExif(InputStream, int)
  - readExif
```
public void readExif(java.io.InputStream inStream,
                     int options)
              throws java.io.IOException
```
    Reads the exif tags from an InputStream, clearing this ExifInterface object's existing exif tags.
```
     ExifInterface exif = new ExifInterface();
     exif.readExif( stream, Options.OPTION_IFD_0 | Options.OPTION_IFD_1 | Options.OPTION_IFD_EXIF );
     ...
     // to request all the options use the OPTION_ALL bit mask
     exif.readExif( stream, Options.OPTION_ALL );
 
```
    Parameters:
    
    inStream - an InputStream containing a jpeg compressed image.
    
    options - bit flag which defines which type of tags to process, see Exify.Options
    
    Throws:
    
    java.io.IOException
  - readExif
```
public void readExif(java.lang.String inFileName,
                     int options)
              throws java.io.IOException
```
    Reads the exif tags from a file, clearing this ExifInterface object's existing exif tags.
    
    Parameters:
    
    inFileName - a string representing the filepath to jpeg file.
    
    options - bit flag which defines which type of tags to process, see Exify.Options
    
    Throws:
    
    java.io.IOException
    
    See Also:
    
    readExif(InputStream, int)
  - removeCompressedThumbnail
```
public void removeCompressedThumbnail()
```
    Clears the compressed thumbnail if it exists.
  - removeTagDefinition
```
public void removeTagDefinition(int tagId)
```
    Removes a tag definition for given defined tag constant.
    
    Parameters:
    
    tagId - a defined tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
  - resetTagDefinitions
```
public void resetTagDefinitions()
```
    Resets tag definitions to the default ones.
  - setCompressedThumbnail
```
public boolean setCompressedThumbnail(android.graphics.Bitmap thumb)
```
    Sets the thumbnail to be a jpeg compressed bitmap. Clears any prior thumbnail.
    
    Parameters:
    
    thumb - a bitmap to compress to a jpeg thumbnail.
    
    Returns:
    
    true if the thumbnail was set.
  - setCompressedThumbnail
```
public boolean setCompressedThumbnail(byte[] thumb)
```
    Sets the thumbnail to be a jpeg compressed image. Clears any prior thumbnail.
    
    Parameters:
    
    thumb - a byte array containing a jpeg compressed image.
    
    Returns:
    
    true if the thumbnail was set.
  - setExif
```
public void setExif(java.util.Collection<ExifTagInfo> tags)
```
    Sets the exif tags, clearing this ExifInterface object's existing exif tags.
    
    Parameters:
    
    tags - a collection of exif tags to set.
  - setTag
```
public ExifTagInfo setTag(ExifTagInfo tag)
```
    Puts an ExifTag into this ExifInterface object's tags, removing a previous ExifTag with the same TID and IFD. The IFD it is put into will be the one the tag was created with in buildTag(ly.img.android.sdk.exif.Exify.TAG, java.lang.Object).
    
    Parameters:
    
    tag - an ExifTag to put into this ExifInterface's tags.
    
    Returns:
    
    the previous ExifTag with the same TID and IFD or null if none exists.
  - setTagDefinition
```
public int setTagDefinition(short tagId,
                            int defaultIfd,
                            short tagType,
                            short defaultComponentCount,
                            int[] allowedIfds)
```
    Creates a new tag definition in this ExifInterface object for a given TID and default IFD. Creating a definition with the same TID and default IFD as a previous definition will override it.
    
    Parameters:
    
    tagId - the TID for the ExifTagKey.
    
    defaultIfd - the default IFD for the ExifTagKey.
    
    tagType - the type of the tag (see ExifTagInfo.getDataType()).
    
    defaultComponentCount - the number of elements of this tag's type in the tags value.
    
    allowedIfds - the IFD's this tag is allowed to be put in.
    
    Returns:
    
    the defined tag constant (e.g. #ExifTagKey.IMAGE_WIDTH) or #ExifTagKey.NULL if the definition could not be made.
  - setTags
```
public void setTags(java.util.Collection<ExifTagInfo> tags)
```
    Puts a collection of ExifTags into this ExifInterface objects's tags. Any previous ExifTags with the same TID and IFDs will be removed.
    
    Parameters:
    
    tags - a Collection of ExifTags.
    
    See Also:
    
    setTag(ly.img.android.sdk.exif.ExifTagInfo)
  - setTagValue
```
public boolean setTagValue(Exify.TAG tag,
                           java.lang.Object val)
```
    Sets the value of an ExifTag if it exists it's default IFD. The value must be the correct type and length for that ExifExifTagKey.
    
    Parameters:
    
    tag - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    val - the value to set.
    
    Returns:
    
    true if success, false if the ExifTag doesn't exist or the value is the wrong type/length.
  - setTagValue
```
public boolean setTagValue(int tagId,
                           int ifdId,
                           java.lang.Object val)
```
    Sets the value of an ExifTag if it exists in the given IFD. The value must be the correct type and length for that ExifExifTagKey.
    
    Parameters:
    
    tagId - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    ifdId - the IFD that the ExifTag is in.
    
    val - the value to set.
    
    Returns:
    
    true if success, false if the ExifTag doesn't exist or the value is the wrong type/length.
    
    See Also:
    
    setTagValue(ly.img.android.sdk.exif.Exify.TAG, java.lang.Object)
  - setTagValue
```
public boolean setTagValue(int tagId,
                           java.lang.Object val)
```
    Sets the value of an ExifTag if it exists it's default IFD. The value must be the correct type and length for that ExifExifTagKey.
    
    Parameters:
    
    tagId - a tag constant, e.g. #ExifTagKey.IMAGE_WIDTH.
    
    val - the value to set.
    
    Returns:
    
    true if success, false if the ExifTag doesn't exist or the value is the wrong type/length.
  - toBitArray
```
public static byte[] toBitArray(short value)
```
  - writeExif
```
public void writeExif(android.graphics.Bitmap input,
                      java.lang.String dstFilename,
                      int quality)
               throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - writeExif
```
public void writeExif(java.io.InputStream input,
                      java.lang.String dstFilename)
               throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - writeExif
```
public void writeExif(java.lang.String dstFilename)
               throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - writeExif
```
public void writeExif(java.lang.String srcFilename,
                      java.lang.String dstFilename)
               throws java.io.IOException
```
    Throws:
    
    java.io.IOException

Class Exify

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT_BYTE_ORDER

DEFINITION_NULL

IFD_NULL

sBannedDefines

TAG_NULL

Constructor Detail

Exify

Method Detail

addDateTimeStampTag

addGpsDateTimeStampTag

addGpsTags

buildTag

buildTag

buildUninitializedTag

buildUninitializedTag

clearExif

closeSilently

convertLatOrLongToDouble

defineTag

deleteTag

deleteTag

deleteTag

getActualTagCount

getAllowedIfdFlagsFromInfo

getAllowedIfdsFromInfo

getAllTags

getAltitude

getApertureSize

getComponentCountFromInfo

getDateTime

getDefinedTagCount

getDefinedTagCount

getDefinedTagDefaultIfd

getDefinedTagType

getFlagsFromAllowedIfds

getImageSize

getJpegProcess

getLatitude

getLatLongAsDoubles

getLensModelDescription

getLongitude

getOrientationValueForRotation

getQualityGuess

getResolutionUnit

getRotationForOrientationValue

getTag

getTag

getTag

getTagByteValue

getTagByteValue

getTagByteValue

getTagByteValues

getTagByteValues

getTagByteValues

getTagDefinition

getTagDefinitionForTag

getTagDefinitionForTag

getTagDefinitionsForTagId

getTagInfo

getTagIntValue

getTagIntValue

getTagIntValue

getTagIntValues

getTagIntValues

getTagIntValues

getTagLongValue

getTagLongValue

getTagLongValue

getTagLongValues

getTagLongValues

getTagLongValues

getTagRationalValue

getTagRationalValue