gallery.images

Class ImageOperations

java.lang.Object

gallery.images.ImageOperations

public class ImageOperations
extends java.lang.Object

Operations on images like resizing and rotating as well as reading metadata in image files.

Method Summary

Methods

Modifier and Type	Method and Description
static ImageAngle	getAngle(java.io.File jpegFile) Returns the angle stored in the jpeg file.
static java.util.Date	getDateTimeTaken(java.io.File jpegFile) Returns the date and time when the photograph was taken, null if unable to retrieve.
static java.util.List<PhotoMetadata>	getMetadata(java.io.File jpegFile) Retrieve the metadata from an image file.
static boolean	isImage(java.nio.file.Path path) Equivalent functionality regarding isImage(java.lang.String).
static boolean	isImage(java.lang.String path) Indicates if a path refers to an image or not.
static java.awt.image.BufferedImage	rotate(java.awt.image.BufferedImage originalImage, ImageAngle imageAngle) Rotate an image with the appropriate angle.
static java.awt.image.BufferedImage	scaleImage(java.awt.image.BufferedImage originalImage, int newWidth, int newHeight) Scale an image down to a new size.

Methods inherited from class java.lang.Object

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

Method Detail

isImage

public static boolean isImage(java.lang.String path)

Indicates if a path refers to an image or not.

Parameters:

path - a path to a file

Returns:

true if it is an image, false otherwise.

isImage

public static boolean isImage(java.nio.file.Path path)

Equivalent functionality regarding isImage(java.lang.String).

Parameters:

path -

Returns:

getAngle

public static ImageAngle getAngle(java.io.File jpegFile)
                           throws com.drew.imaging.ImageProcessingException,
                                  java.io.IOException,
                                  com.drew.metadata.MetadataException

Returns the angle stored in the jpeg file.

Parameters:

jpegFile - file containing an image

Returns:

the angle, or null if not able to retrieve it from the image.

Throws:

com.drew.imaging.ImageProcessingException - if an image processing error occurred

java.io.IOException - if a file error occurred

com.drew.metadata.MetadataException - if the reading of the image metadata failed.

rotate

public static java.awt.image.BufferedImage rotate(java.awt.image.BufferedImage originalImage,
                                  ImageAngle imageAngle)

Rotate an image with the appropriate angle.

Parameters:

originalImage - the original image that needs to be rotated

imageAngle - the image angle, may be null. In which case, the original image is returned.

Returns:

returns a possibly rotated BufferImage.

scaleImage

public static java.awt.image.BufferedImage scaleImage(java.awt.image.BufferedImage originalImage,
                                      int newWidth,
                                      int newHeight)

Scale an image down to a new size. Keeps ratio.

Parameters:

originalImage - the original image

newWidth - the new width in pixels

newHeight - the new height in pixels

Returns:

a new image that is at most newWidth

getMetadata

public static java.util.List<PhotoMetadata> getMetadata(java.io.File jpegFile)
                                                 throws com.drew.imaging.ImageProcessingException,
                                                        java.io.IOException

Retrieve the metadata from an image file.

Parameters:

jpegFile - the image file

Returns:

List of PhotoMetadata

Throws:

com.drew.imaging.ImageProcessingException - an image processing error occurred when interpreting the image.

java.io.IOException - an error occurred when reading the file

getDateTimeTaken

public static java.util.Date getDateTimeTaken(java.io.File jpegFile)
                                       throws com.drew.imaging.ImageProcessingException,
                                              java.io.IOException

Returns the date and time when the photograph was taken, null if unable to retrieve.

Parameters:

jpegFile - a file containing an image.

Returns:

date or null if unable to determine the date when the photograph was taken

Throws:

com.drew.imaging.ImageProcessingException - an image processing error occurred when interpreting the image.

java.io.IOException - an error occurred when reading the file