|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--com.sun.media.imageio.plugins.tiff.TIFFTag
A class defining the notion of a TIFF tag. A TIFF tag is a key that may appear in an Image File Directory (IFD). Each tag has some data associated with it, which may consist of zero or more values of a given data type.
The actual tag values used in a standard ("baseline") tiff file
are defined in the
class.
BaselineTIFFTagSet
BaselineTIFFTagSet
,
EXIFParentTIFFTagSet
,
EXIFTIFFTagSet
Field Summary | |
static int |
MAX_DATATYPE
The numerically largest constant representing a TIFF data type. |
static int |
MIN_DATATYPE
The numerically smallest constant representing a TIFF data type. |
static int |
TIFF_ASCII
Flag for null-terminated ASCII strings. |
static int |
TIFF_BYTE
Flag for 8 bit unsigned integers. |
static int |
TIFF_DOUBLE
Flag for 64 bit IEEE doubles. |
static int |
TIFF_FLOAT
Flag for 32 bit IEEE floats. |
static int |
TIFF_IFD_POINTER
Flag for IFD pointer (Tech Note 1). |
static int |
TIFF_LONG
Flag for 32 bit unsigned integers. |
static int |
TIFF_RATIONAL
Flag for pairs of 32 bit unsigned integers. |
static int |
TIFF_SBYTE
Flag for 8 bit signed integers. |
static int |
TIFF_SHORT
Flag for 16 bit unsigned integers. |
static int |
TIFF_SLONG
Flag for 32 bit signed integers. |
static int |
TIFF_SRATIONAL
Flag for pairs of 32 bit signed integers. |
static int |
TIFF_SSHORT
Flag for 16 bit signed integers. |
static int |
TIFF_UNDEFINED
Flag for 8 bit uninterpreted bytes. |
Constructor Summary | |
TIFFTag(String name,
int number,
int dataTypes)
Constructs a TIFFTag with a given name, tag
number, set of legal data types. |
|
TIFFTag(String name,
int number,
int dataTypes,
TIFFTagSet tagSet)
Constructs a TIFFTag with a given name, tag number,
set of legal data types, and a reference to the TIFFTagSet
to which it belongs. |
Method Summary | |
protected void |
addValueName(int value,
String name)
Adds a mnemonic name for a particular value that this tag's data may take on. |
int |
getDataTypes()
Returns a bit mask indicating the set of data types that may be used to store the data associated with the tag. |
String |
getName()
Returns the name of the tag, as it will appear in image metadata. |
int |
getNumber()
Returns the integer used to represent the tag. |
static int |
getSizeOfType(int dataType)
Returns the number of bytes used to store a value of the given data type. |
TIFFTagSet |
getTagSet()
Returns the TIFFTagSet of which this tag is a part. |
String |
getValueName(int value)
Returns the mnemonic name associated with a particular value that this tag's data may take on, or null if
no name is present. |
boolean |
hasValueNames()
Returns true if there are mnemonic names associated with
the set of legal values for the data associated with this tag. |
boolean |
isDataTypeOK(int dataType)
Returns true if the given data type
may be used for the data associated with this tag. |
boolean |
isIFDPointer()
Returns true if this tag is used to point to an IFD
structure containing additional tags. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final int TIFF_BYTE
public static final int TIFF_ASCII
public static final int TIFF_SHORT
public static final int TIFF_LONG
public static final int TIFF_RATIONAL
public static final int TIFF_SBYTE
public static final int TIFF_UNDEFINED
public static final int TIFF_SSHORT
public static final int TIFF_SLONG
public static final int TIFF_SRATIONAL
public static final int TIFF_FLOAT
public static final int TIFF_DOUBLE
public static final int TIFF_IFD_POINTER
public static final int MIN_DATATYPE
public static final int MAX_DATATYPE
Constructor Detail |
public TIFFTag(String name, int number, int dataTypes, TIFFTagSet tagSet)
TIFFTag
with a given name, tag number,
set of legal data types, and a reference to the TIFFTagSet
to which it belongs.
If there are mnemonic names to be associated with the legal
data values for the tag,
should be called on the new instance
for each name.
addValueName
See the documentation for
for an explanation of how the set
of data types are to be converted into a bit mask.
getDataTypes()
name
- the name of the tag.number
- the number used to represent the tag.dataTypes
- a bit mask indicating the set of legal data
types for this tag.tagSet
- the TIFFTagSet
to which this tag
belongs.public TIFFTag(String name, int number, int dataTypes)
TIFFTag
with a given name, tag
number, set of legal data types. The tag will have no
associated TIFFTagSet
.
name
- the name of the tag.number
- the number used to represent the tag.dataTypes
- a bit mask indicating the set of legal data
types for this tag.TIFFTag(String, int, int, TIFFTagSet)
Method Detail |
public static int getSizeOfType(int dataType)
dataType
- the data type to be queried.
IllegalArgumentException
- if datatype
is
less than MIN_DATATYPE
or greater than
MAX_DATATYPE
.public String getName()
String
.public int getNumber()
int
.public int getDataTypes()
(1 << TIFFTag.TIFF_SHORT) | (1 < TIFFTag.TIFF_LONG)
int
containing a bitmask encoding the
set of valid data types.public boolean isDataTypeOK(int dataType)
true
if the given data type
may be used for the data associated with this tag.
dataType
- the data type to be queried, one of
TIFF_BYTE
, TIFF_SHORT
, etc.
boolean
indicating whether the given
data type may be used with this tag.
IllegalArgumentException
- if datatype
is
less than MIN_DATATYPE
or greater than
MAX_DATATYPE
.public TIFFTagSet getTagSet()
TIFFTagSet
of which this tag is a part.
TIFFTagSet
.public boolean isIFDPointer()
true
if this tag is used to point to an IFD
structure containing additional tags. Many TIFF extensions use
this mechanism in order to limit the number of new tags that
may appear in the root IFD.
true
if this tag points to an IFD.public boolean hasValueNames()
true
if there are mnemonic names associated with
the set of legal values for the data associated with this tag.
true
if mnemonic value names are available.protected void addValueName(int value, String name)
value
- the data value.name
- the name to associate with the value.public String getValueName(int value)
null
if
no name is present.
value
- the data value.
String
.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |