org.openstreetmap.josm.tools

Class ExifReader

java.lang.Object

org.openstreetmap.josm.tools.ExifReader

public final class ExifReader
extends java.lang.Object

Read out EXIF information from a JPEG file

Since:

99

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ExifReader()

Method Summary

Modifier and Type	Method and Description
private static double	readAxis(GpsDirectory dirGps, int gpsTag, int gpsTagRef, char cRef)
static java.lang.Double	readDirection(java.io.File filename) Returns the direction of the given JPEG file.
static java.lang.Double	readDirection(GpsDirectory dirGps) Returns the direction of the given EXIF GPS directory.
static LatLon	readLatLon(java.io.File filename) Returns the geolocation of the given JPEG file.
static LatLon	readLatLon(GpsDirectory dirGps) Returns the geolocation of the given EXIF GPS directory.
static java.lang.Integer	readOrientation(java.io.File filename) Returns the image orientation of the given JPEG file.
static java.util.Date	readTime(java.io.File filename) Returns the date/time from the given JPEG file.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExifReader

private ExifReader()

Method Detail

readTime

public static java.util.Date readTime(java.io.File filename)
                               throws java.text.ParseException

Returns the date/time from the given JPEG file.

Parameters:

filename - The JPEG file to read

Returns:

The date/time read in the EXIF section, or null if not found

Throws:

java.text.ParseException - if PrimaryDateParser.parse(java.lang.String) fails to parse date/time

readOrientation

public static java.lang.Integer readOrientation(java.io.File filename)

Returns the image orientation of the given JPEG file.

Parameters:

filename - The JPEG file to read

Returns:

The image orientation as an int. Default value is 1. Possible values are listed in EXIF spec as follows:

1. The 0th row is at the visual top of the image, and the 0th column is the visual left-hand side.
2. The 0th row is at the visual top of the image, and the 0th column is the visual right-hand side.
3. The 0th row is at the visual bottom of the image, and the 0th column is the visual right-hand side.
4. The 0th row is at the visual bottom of the image, and the 0th column is the visual left-hand side.
5. The 0th row is the visual left-hand side of the image, and the 0th column is the visual top.
6. The 0th row is the visual right-hand side of the image, and the 0th column is the visual top.
7. The 0th row is the visual right-hand side of the image, and the 0th column is the visual bottom.
8. The 0th row is the visual left-hand side of the image, and the 0th column is the visual bottom.

See Also:

http://www.impulseadventure.com/photo/exif-orientation.html, http://www.daveperrett.com/articles/2012/07/28/exif-orientation-handling-is-a-ghetto

readLatLon

public static LatLon readLatLon(java.io.File filename)

Returns the geolocation of the given JPEG file.

Parameters:

filename - The JPEG file to read

Returns:

The lat/lon read in the EXIF section, or null if not found

Since:

6209

readLatLon

public static LatLon readLatLon(GpsDirectory dirGps)
                         throws MetadataException

Returns the geolocation of the given EXIF GPS directory.

Parameters:

dirGps - The EXIF GPS directory

Returns:

The lat/lon read in the EXIF section, or null if dirGps is null

Throws:

MetadataException

Since:

6209

readDirection

public static java.lang.Double readDirection(java.io.File filename)

Returns the direction of the given JPEG file.

Parameters:

filename - The JPEG file to read

Returns:

The direction of the image when it was captures (in degrees between 0.0 and 359.99), or null if missing or if dirGps is null

Since:

6209

readDirection

public static java.lang.Double readDirection(GpsDirectory dirGps)

Returns the direction of the given EXIF GPS directory.

Parameters:

dirGps - The EXIF GPS directory

Returns:

The direction of the image when it was captures (in degrees between 0.0 and 359.99), or null if missing or if dirGps is null

Since:

6209

readAxis

private static double readAxis(GpsDirectory dirGps,
                               int gpsTag,
                               int gpsTagRef,
                               char cRef)
                        throws MetadataException

Throws:

MetadataException