ExifAnalyzer (Cilla Services 0.2-SNAPSHOT API)

java.lang.Object
- org.shredzone.cilla.service.resource.ExifAnalyzer

```
public class ExifAnalyzer
extends Object
```
Analyzes the EXIF and GPS information of a JPEG image. It's a wrapper around the Metadata Extractor of Drew Noakes.

Author:

Richard "Shred" Körber

See Also:

Metadata Extractor

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static ExifAnalyzer`	`create(File file)` Creates a new `ExifAnalyzer` for the given JPEG file.
`static ExifAnalyzer`	`create(InputStream in)` Creates a new `ExifAnalyzer` for the given JPEG input stream.
`String`	`getAperture()` Gets the Aperture in F-Stops of the photo taken.
`String`	`getCameraModel()` Gets the Camera Model.
`Date`	`getDateTime(TimeZone tz)` Gets the date and time when the picture was taken according to the EXIF data.
`ExifData`	`getExifData()` Gets the `ExifData` of the picture taken.
`String`	`getExposureBias()` Gets the Exposure Bias of the photo taken.
`String`	`getFlash()` Reads the Flash Mode that was set on the camera for this photo.
`String`	`getFocalLength()` Gets the Focal Length of the photo taken.
`String`	`getFocusMode()` Reads the Focus Mode that was set on the camera for this photo.
`Geolocation`	`getGeolocation()` Gets the `Geolocation` where the picture was taken.
`String`	`getIso()` Gets the ISO value of the photo taken.
`com.drew.metadata.Metadata`	`getMetadata()` Gets the Metadata containing the EXIF information.
`String`	`getMeteringMode()` Reads the Metering Mode that was set on the camera for this photo.
`String`	`getProgram()` Reads the Program that was set on the camera for this photo.
`String`	`getShutter()` Gets the Shutter Speed of the photo taken.
`String`	`getWhiteBalance()` Reads the White Balance Mode that was set on the camera for this photo.
`protected <T extends com.drew.metadata.Directory> BigDecimal`	`readAngle(Class<T> directory, int tag)` Converts an angle from a directory.
`protected <T extends com.drew.metadata.Directory> Date`	`readDate(Class<T> directory, int tag, TimeZone tz)` Fetches a `Date` from a directory.
`protected <T extends com.drew.metadata.Directory> Integer`	`readInteger(Class<T> directory, int tag)` Fetches an Integer from a directory.
`protected <T extends com.drew.metadata.Directory> com.drew.lang.Rational`	`readRational(Class<T> directory, int tag)` Fetches a Rational from a directory.
`protected <T extends com.drew.metadata.Directory> String`	`readString(Class<T> directory, int tag)` Fetches a String from a directory.

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

- Method Detail
  - create
```
public static ExifAnalyzer create(File file)
                           throws IOException
```
    Creates a new ExifAnalyzer for the given JPEG file.
    
    Parameters:
    
    file - JPEG file to analyze
    
    Returns:
    
    ExifAnalyzer or null if it is no valid JPEG image.
    
    Throws:
    
    IOException
  - create
```
public static ExifAnalyzer create(InputStream in)
                           throws IOException
```
    Creates a new ExifAnalyzer for the given JPEG input stream.
    
    Parameters:
    
    in - JPEG input stream to analyze
    
    Returns:
    
    ExifAnalyzer or null if it is no valid JPEG image.
    
    Throws:
    
    IOException
  - getMetadata
```
public com.drew.metadata.Metadata getMetadata()
```
    Gets the Metadata containing the EXIF information.
    
    Returns:
    
    Metadata
  - getExifData
```
public ExifData getExifData()
```
    Gets the ExifData of the picture taken.
    
    Returns:
    
    ExifData, never null, but it could be empty.
  - getGeolocation
```
public Geolocation getGeolocation()
```
    Gets the Geolocation where the picture was taken.
    
    Returns:
    
    Geolocation, never null, but it could be empty.
  - getDateTime
```
public Date getDateTime(TimeZone tz)
```
    Gets the date and time when the picture was taken according to the EXIF data.
    
    Parameters:
    
    tz - The camera's TimeZone
    
    Returns:
    
    Date and time, or null if the information could not be retrieved
  - getCameraModel
```
public String getCameraModel()
```
    Gets the Camera Model.
    
    Returns:
    
    Camera Model string, or null if the information could not be retrieved
  - getAperture
```
public String getAperture()
```
    Gets the Aperture in F-Stops of the photo taken. Format is "f/6.0".
    
    Returns:
    
    Aperture string, or null if the information could not be retrieved
  - getShutter
```
public String getShutter()
```
    Gets the Shutter Speed of the photo taken. Format is either "1/150 s" or "15.0 s".
    
    Returns:
    
    Shutter Speed string, or null if the information could not be retrieved
  - getIso
```
public String getIso()
```
    Gets the ISO value of the photo taken. Format: "100".
    
    Returns:
    
    ISO string, or null if the information could not be retrieved
  - getExposureBias
```
public String getExposureBias()
```
    Gets the Exposure Bias of the photo taken. Format: "+0.7 EV" (zero is "+0.0 EV").
    
    Returns:
    
    Exposure Bias string, or null if the information could not be retrieved
  - getFocalLength
```
public String getFocalLength()
```
    Gets the Focal Length of the photo taken. Format: "123.0 mm". If there is also a 35 mm film equivalent focal length, the format is "123.0 mm (= 196.8 mm)".
    
    Returns:
    
    Focal Length string, or null if the information could not be retrieved
  - getFlash
```
public String getFlash()
```
    Reads the Flash Mode that was set on the camera for this photo. Flash Mode may consist of several information separated by comma (',').
    
    Returns:
    
    Flash Mode string, or null if the information could not be retrieved
  - getWhiteBalance
```
public String getWhiteBalance()
```
    Reads the White Balance Mode that was set on the camera for this photo.
    
    Returns:
    
    White Balance Mode string, or null if the information could not be retrieved
  - getMeteringMode
```
public String getMeteringMode()
```
    Reads the Metering Mode that was set on the camera for this photo.
    
    Returns:
    
    Metering Mode string, or null if the information could not be retrieved
  - getFocusMode
```
public String getFocusMode()
```
    Reads the Focus Mode that was set on the camera for this photo.
    
    Returns:
    
    Focus Mode string, or null if the information could not be retrieved
  - getProgram
```
public String getProgram()
```
    Reads the Program that was set on the camera for this photo.
    
    Returns:
    
    Program string, or null if the information could not be retrieved
  - readString
```
protected <T extends com.drew.metadata.Directory> String readString(Class<T> directory,
                                                                    int tag)
```
    Fetches a String from a directory.
    
    Parameters:
    
    directory - Directory to read from
    
    tag - Tag to be read
    
    Returns:
    
    String that was read, or null if there was no such information
  - readRational
```
protected <T extends com.drew.metadata.Directory> com.drew.lang.Rational readRational(Class<T> directory,
                                                                                      int tag)
```
    Fetches a Rational from a directory.
    
    Parameters:
    
    directory - Directory to read from
    
    tag - Tag to be read
    
    Returns:
    
    Rational that was read, or null if there was no such information
  - readInteger
```
protected <T extends com.drew.metadata.Directory> Integer readInteger(Class<T> directory,
                                                                      int tag)
```
    Fetches an Integer from a directory.
    
    Parameters:
    
    directory - Directory to read from
    
    tag - Tag to be read
    
    Returns:
    
    Integer that was read, or null if there was no such information
  - readDate
```
protected <T extends com.drew.metadata.Directory> Date readDate(Class<T> directory,
                                                                int tag,
                                                                TimeZone tz)
```
    Fetches a Date from a directory.
    
    Parameters:
    
    directory - Directory to read from
    
    tag - Tag to be read
    
    tz - TimeZone the camera is configured to
    
    Returns:
    
    Date that was read, or null if there was no such information
  - readAngle
```
protected <T extends com.drew.metadata.Directory> BigDecimal readAngle(Class<T> directory,
                                                                       int tag)
```
    Converts an angle from a directory. The implementation handles one to three (and even more) rational array entries.
    
    Parameters:
    
    directory - Directory to read from
    
    tag - Tag to be read
    
    Returns:
    
    BigDecimal containing the angle, probably rounded

Class ExifAnalyzer

Method Summary

Methods inherited from class java.lang.Object

Method Detail

create

create

getMetadata

getExifData

getGeolocation

getDateTime

getCameraModel

getAperture

getShutter

getIso

getExposureBias

getFocalLength

getFlash

getWhiteBalance

getMeteringMode

getFocusMode

getProgram

readString

readRational

readInteger

readDate

readAngle