Backups/TwelveMonkeys
2
0
Fork 0
mirror of https://github.com/haraldk/TwelveMonkeys.git synced 2025-08-04 20:15:28 -04:00
Code Issues Projects Releases Wiki Activity

Documentation & details.

Browse Source 
(cherry picked from commit 8992406f502a1c8415ac9ed80267d8a705541440)
This commit is contained in:
Harald Kuhr 2022-05-18 20:31:28 +02:00
parent 37d1da9b9d
commit 6bcc17a020
1 changed files with 24 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
contrib/src/main/java/com/twelvemonkeys/contrib/exif/EXIFUtilities.java
View File

@ -30,9 +30,14 @@ import static com.twelvemonkeys.contrib.tiff.TIFFUtilities.applyOrientation;
public class EXIFUtilities { public class EXIFUtilities {
/** /**
* Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}. * Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}.
* The returned {@code IIOImage} will always contain an image and no raster, and
* the {@code RenderedImage} may be safely cast to a {@code BufferedImage}.
*
* If no registered {@code ImageReader} claims to be able to read the input, {@code null} is returned.
* *
* @param input a {@code URL} * @param input a {@code URL}
* @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info. * @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info, or
* {@code null}.
* @throws IOException if an error occurs during reading. * @throws IOException if an error occurs during reading.
*/ */
public static IIOImage readWithOrientation(final URL input) throws IOException { public static IIOImage readWithOrientation(final URL input) throws IOException {
@ -43,9 +48,14 @@ public class EXIFUtilities {
/** /**
* Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}. * Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}.
* The returned {@code IIOImage} will always contain an image and no raster, and
* the {@code RenderedImage} may be safely cast to a {@code BufferedImage}.
*
* If no registered {@code ImageReader} claims to be able to read the input, {@code null} is returned.
* *
* @param input an {@code InputStream} * @param input an {@code InputStream}
* @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info. * @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info, or
* {@code null}.
* @throws IOException if an error occurs during reading. * @throws IOException if an error occurs during reading.
*/ */
public static IIOImage readWithOrientation(final InputStream input) throws IOException { public static IIOImage readWithOrientation(final InputStream input) throws IOException {
@ -56,9 +66,14 @@ public class EXIFUtilities {
/** /**
* Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}. * Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}.
* The returned {@code IIOImage} will always contain an image and no raster, and
* the {@code RenderedImage} may be safely cast to a {@code BufferedImage}.
*
* If no registered {@code ImageReader} claims to be able to read the input, {@code null} is returned.
* *
* @param input a {@code File} * @param input a {@code File}
* @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info. * @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info or
* {@code null}.
* @throws IOException if an error occurs during reading. * @throws IOException if an error occurs during reading.
*/ */
public static IIOImage readWithOrientation(final File input) throws IOException { public static IIOImage readWithOrientation(final File input) throws IOException {
@ -69,9 +84,14 @@ public class EXIFUtilities {
/** /**
* Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}. * Reads image and metadata, applies Exif orientation to image, and returns everything as an {@code IIOImage}.
* The returned {@code IIOImage} will always contain an image and no raster, and
* the {@code RenderedImage} may be safely cast to a {@code BufferedImage}.
*
* If no registered {@code ImageReader} claims to be able to read the input, {@code null} is returned.
* *
* @param input an {@code ImageInputStream} * @param input an {@code ImageInputStream}
* @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info. * @return an {@code IIOImage} containing the correctly oriented image and metadata including rotation info, or
* {@code null}.
* @throws IOException if an error occurs during reading. * @throws IOException if an error occurs during reading.
*/ */
public static IIOImage readWithOrientation(final ImageInputStream input) throws IOException { public static IIOImage readWithOrientation(final ImageInputStream input) throws IOException {