Class JPEGSegmentUtil

java.lang.Object

com.twelvemonkeys.imageio.metadata.jpeg.JPEGSegmentUtil

public final class JPEGSegmentUtil
extends Object

JPEGSegmentUtil

Version:

$Id: JPEGSegmentUtil.java,v 1.0 24.01.11 17.37 haraldk Exp$

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	JPEGSegmentUtil.AllAppSegmentsMap
private static class	JPEGSegmentUtil.AllIdsList
private static class	JPEGSegmentUtil.AllSegmentsMap

Field Summary

Fields

Modifier and Type	Field	Description
static final List<String>	ALL_IDS
static final Map<Integer, List<String>>	ALL_SEGMENTS
static final Map<Integer, List<String>>	APP_SEGMENTS

Constructor Summary

Constructors

Modifier	Constructor	Description
private	JPEGSegmentUtil()

Method Summary

Modifier and Type	Method	Description
(package private) static String	asAsciiString(byte[] data, int offset, int length)
(package private) static String	asNullTerminatedAsciiString(byte[] data, int offset)
private static boolean	containsSafe(JPEGSegment segment, Map<Integer, List<String>> segmentIdentifiers)
private static boolean	isImageDone(JPEGSegment segment)
static boolean	isKnownJPEGMarker(int marker)
private static boolean	isRequested(JPEGSegment segment, Map<Integer, List<String>> segmentIdentifiers)
static void	main(String[] args)
(package private) static JPEGSegment	readSegment(ImageInputStream stream, Map<Integer, List<String>> segmentIdentifiers)
static List<JPEGSegment>	readSegments(ImageInputStream stream, int marker, String identifier)	Reads the requested JPEG segments from the stream.
static List<JPEGSegment>	readSegments(ImageInputStream stream, Map<Integer, List<String>> segmentIdentifiers)	Reads the requested JPEG segments from the stream.
(package private) static void	readSOI(ImageInputStream stream)

Methods inherited from class Object

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

Field Details

ALL_IDS

public static final List<String> ALL_IDS

ALL_SEGMENTS

public static final Map<Integer, List<String>> ALL_SEGMENTS

APP_SEGMENTS

public static final Map<Integer, List<String>> APP_SEGMENTS

Constructor Details

JPEGSegmentUtil

private JPEGSegmentUtil()

Method Details

readSegments

public static List<JPEGSegment> readSegments(ImageInputStream stream,
 int marker,
 String identifier)
                                      throws IOException

Reads the requested JPEG segments from the stream. The stream position must be directly before the SOI marker, and only segments for the current image is read.

Parameters:

stream - the stream to read from.

marker - the segment marker to read

identifier - the identifier to read, or null to match any segment

Returns:

a list of segments with the given app marker and optional identifier. If no segments are found, an empty list is returned.

Throws:

IIOException - if a JPEG format exception occurs during reading

IOException - if an I/O exception occurs during reading

readSegments

public static List<JPEGSegment> readSegments(ImageInputStream stream,
 Map<Integer, List<String>> segmentIdentifiers)
                                      throws IOException

Reads the requested JPEG segments from the stream. The stream position must be directly before the SOI marker, and only segments for the current image is read.

Parameters:

stream - the stream to read from.

segmentIdentifiers - the segment identifiers

Returns:

a list of segments with the given app markers and optional identifiers. If no segments are found, an empty list is returned.

Throws:

IIOException - if a JPEG format exception occurs during reading

IOException - if an I/O exception occurs during reading

See Also:

• ALL_SEGMENTS
• APP_SEGMENTS
• ALL_IDS

isRequested

private static boolean isRequested(JPEGSegment segment,
 Map<Integer, List<String>> segmentIdentifiers)

containsSafe

private static boolean containsSafe(JPEGSegment segment,
 Map<Integer, List<String>> segmentIdentifiers)

isImageDone

private static boolean isImageDone(JPEGSegment segment)

asNullTerminatedAsciiString

static String asNullTerminatedAsciiString(byte[] data,
 int offset)

asAsciiString

static String asAsciiString(byte[] data,
 int offset,
 int length)

readSOI

static void readSOI(ImageInputStream stream)
             throws IOException

Throws:

IOException

readSegment

static JPEGSegment readSegment(ImageInputStream stream,
 Map<Integer, List<String>> segmentIdentifiers)
                        throws IOException

Throws:

IOException

isKnownJPEGMarker

public static boolean isKnownJPEGMarker(int marker)

main

public static void main(String[] args)
                 throws IOException

Throws:

IOException