javax.imageio.metadata
Interface IIOMetadataFormat

All Known Implementing Classes:
IIOMetadataFormatImpl sample code for javax.imageio.metadata.IIOMetadataFormatImpl definition code for javax.imageio.metadata.IIOMetadataFormatImpl

public interface IIOMetadataFormat

An object describing the structure of metadata documents returned from IIOMetadata.getAsTree and passed to IIOMetadata.setFromTree and mergeTree. Document structures are described by a set of constraints on the type and number of child elements that may belong to a given parent element type, the names, types, and values of attributes that may belong to an element, and the type and values of Object reference that may be stored at a node.

N.B: classes that implement this interface should contain a method declared as public static getInstance() which returns an instance of the class. Commonly, an implentation will construct only a single instance and cache it for future invocations of getInstance.

The structures that may be described by this class are a subset of those expressible using XML document type definitions (DTDs), with the addition of some basic information on the datatypes of attributes and the ability to store an Object reference within a node. In the future, XML Schemas could be used to represent these structures, and many others.

The differences between IIOMetadataFormat-described structures and DTDs are as follows:


Field Summary
static int CHILD_POLICY_ALL sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_ALL definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_ALL
          A constant returned by getChildPolicy to indicate that an element must have a single instance of each of its legal child elements, in order.
static int CHILD_POLICY_CHOICE sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_CHOICE definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_CHOICE
          A constant returned by getChildPolicy to indicate that an element must have zero or one children, selected from among its legal child elements.
static int CHILD_POLICY_EMPTY sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_EMPTY definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_EMPTY
          A constant returned by getChildPolicy to indicate that an element may not have any children.
static int CHILD_POLICY_MAX sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_MAX definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_MAX
          The largest valid CHILD_POLICY_* constant, to be used for range checks.
static int CHILD_POLICY_REPEAT sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_REPEAT definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_REPEAT
          A constant returned by getChildPolicy to indicate that an element must have zero or more instances of its unique legal child element.
static int CHILD_POLICY_SEQUENCE sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_SEQUENCE definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_SEQUENCE
          A constant returned by getChildPolicy to indicate that an element must have a sequence of instances of any of its legal child elements.
static int CHILD_POLICY_SOME sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_SOME definition code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_SOME
          A constant returned by getChildPolicy to indicate that an element must have zero or one instance of each of its legal child elements, in order.
static int DATATYPE_BOOLEAN sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_BOOLEAN definition code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_BOOLEAN
          A constant returned by getAttributeDataType indicating that the value of an attribute is one of 'true' or 'false'.
static int DATATYPE_DOUBLE sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_DOUBLE definition code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_DOUBLE
          A constant returned by getAttributeDataType indicating that the value of an attribute is a string representation of a double-precision decimal floating-point number.
static int DATATYPE_FLOAT sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_FLOAT definition code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_FLOAT
          A constant returned by getAttributeDataType indicating that the value of an attribute is a string representation of a decimal floating-point number.
static int DATATYPE_INTEGER sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_INTEGER definition code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_INTEGER
          A constant returned by getAttributeDataType indicating that the value of an attribute is a string representation of an integer.
static int DATATYPE_STRING sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_STRING definition code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_STRING
          A constant returned by getAttributeDataType indicating that the value of an attribute is a general Unicode string.
static int VALUE_ARBITRARY sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_ARBITRARY definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_ARBITRARY
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set a single, arbitrary value.
static int VALUE_ENUMERATION sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_ENUMERATION definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_ENUMERATION
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set one of a number of enumerated values.
static int VALUE_LIST sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_LIST definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_LIST
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set to a list or array of values.
static int VALUE_NONE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_NONE definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_NONE
          A constant returned by getObjectValueType to indicate the absence of a user object.
static int VALUE_RANGE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set a range of values.
static int VALUE_RANGE_MAX_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MAX_INCLUSIVE definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MAX_INCLUSIVE
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set to a range of values.
static int VALUE_RANGE_MAX_INCLUSIVE_MASK sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MAX_INCLUSIVE_MASK definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MAX_INCLUSIVE_MASK
          A value that may be or'ed with VALUE_RANGE to obtain VALUE_RANGE_MAX_INCLUSIVE, and with VALUE_RANGE_MIN_INCLUSIVE to obtain VALUE_RANGE_MIN_MAX_INCLUSIVE.
static int VALUE_RANGE_MIN_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_INCLUSIVE definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_INCLUSIVE
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set to a range of values.
static int VALUE_RANGE_MIN_INCLUSIVE_MASK sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_INCLUSIVE_MASK definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_INCLUSIVE_MASK
          A value that may be or'ed with VALUE_RANGE to obtain VALUE_RANGE_MIN_INCLUSIVE, and with VALUE_RANGE_MAX_INCLUSIVE to obtain VALUE_RANGE_MIN_MAX_INCLUSIVE.
static int VALUE_RANGE_MIN_MAX_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_MAX_INCLUSIVE definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_MAX_INCLUSIVE
          A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set a range of values.
 
Method Summary
 boolean canNodeAppear sample code for javax.imageio.metadata.IIOMetadataFormat.canNodeAppear(java.lang.String, javax.imageio.ImageTypeSpecifier) definition code for javax.imageio.metadata.IIOMetadataFormat.canNodeAppear(java.lang.String, javax.imageio.ImageTypeSpecifier) (String sample code for java.lang.String definition code for java.lang.String  elementName, ImageTypeSpecifier sample code for javax.imageio.ImageTypeSpecifier definition code for javax.imageio.ImageTypeSpecifier  imageType)
          Returns true if the element (and the subtree below it) is allowed to appear in a metadata document for an image of the given type, defined by an ImageTypeSpecifier.
 int getAttributeDataType sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDataType(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDataType(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns one of the constants starting with DATATYPE_, indicating the format and interpretation of the value of the given attribute within th enamed element.
 String sample code for java.lang.String definition code for java.lang.String getAttributeDefaultValue sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDefaultValue(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDefaultValue(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns the default value of the named attribute, if it is not explictly present within the named element, as a String, or null if no default value is available.
 String sample code for java.lang.String definition code for java.lang.String getAttributeDescription sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDescription(java.lang.String, java.lang.String, java.util.Locale) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDescription(java.lang.String, java.lang.String, java.util.Locale) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName, Locale sample code for java.util.Locale definition code for java.util.Locale  locale)
          Returns a String containing a description of the named attribute, or null.
 String sample code for java.lang.String definition code for java.lang.String [] getAttributeEnumerations sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeEnumerations(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeEnumerations(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns an array of Strings containing the legal enumerated values for the given attribute within the named element.
 int getAttributeListMaxLength sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMaxLength(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMaxLength(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns the maximum number of list items that may be used to define this attribute.
 int getAttributeListMinLength sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMinLength(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMinLength(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns the minimum number of list items that may be used to define this attribute.
 String sample code for java.lang.String definition code for java.lang.String getAttributeMaxValue sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMaxValue(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMaxValue(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns the maximum legal value for the attribute.
 String sample code for java.lang.String definition code for java.lang.String getAttributeMinValue sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMinValue(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMinValue(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns the minimum legal value for the attribute.
 String sample code for java.lang.String definition code for java.lang.String [] getAttributeNames sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeNames(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeNames(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns an array of Strings listing the names of the attributes that may be associated with the named element.
 int getAttributeValueType sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeValueType(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeValueType(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns one of the constants starting with VALUE_, indicating whether the values of the given attribute within the named element are arbitrary, constrained to lie within a specified range, constrained to be one of a set of enumerated values, or are a whitespace-separated list of arbitrary values.
 String sample code for java.lang.String definition code for java.lang.String [] getChildNames sample code for javax.imageio.metadata.IIOMetadataFormat.getChildNames(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getChildNames(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns an array of Strings indicating the names of the element which are allowed to be children of the named element, in the order in which they should appear.
 int getChildPolicy sample code for javax.imageio.metadata.IIOMetadataFormat.getChildPolicy(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getChildPolicy(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns one of the constants starting with CHILD_POLICY_, indicating the legal pattern of children for the named element.
 String sample code for java.lang.String definition code for java.lang.String getElementDescription sample code for javax.imageio.metadata.IIOMetadataFormat.getElementDescription(java.lang.String, java.util.Locale) definition code for javax.imageio.metadata.IIOMetadataFormat.getElementDescription(java.lang.String, java.util.Locale) (String sample code for java.lang.String definition code for java.lang.String  elementName, Locale sample code for java.util.Locale definition code for java.util.Locale  locale)
          Returns a String containing a description of the named element, or null.
 int getElementMaxChildren sample code for javax.imageio.metadata.IIOMetadataFormat.getElementMaxChildren(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getElementMaxChildren(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the maximum number of children of the named element with child policy CHILD_POLICY_REPEAT.
 int getElementMinChildren sample code for javax.imageio.metadata.IIOMetadataFormat.getElementMinChildren(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getElementMinChildren(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the minimum number of children of the named element with child policy CHILD_POLICY_REPEAT.
 int getObjectArrayMaxLength sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMaxLength(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMaxLength(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the maximum number of array elements that may be used to define the Object reference within the named element.
 int getObjectArrayMinLength sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMinLength(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMinLength(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the minimum number of array elements that may be used to define the Object reference within the named element.
 Class sample code for java.lang.Class definition code for java.lang.Class <?> getObjectClass sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectClass(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectClass(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the Class type of the Object reference stored within the element.
 Object sample code for java.lang.Object definition code for java.lang.Object getObjectDefaultValue sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectDefaultValue(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectDefaultValue(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns an Objects containing the default value for the Object reference within the named element.
 Object sample code for java.lang.Object definition code for java.lang.Object [] getObjectEnumerations sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectEnumerations(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectEnumerations(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns an array of Objects containing the legal enumerated values for the Object reference within the named element.
 Comparable sample code for java.lang.Comparable definition code for java.lang.Comparable <?> getObjectMaxValue sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectMaxValue(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectMaxValue(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the maximum legal value for the Object reference within the named element.
 Comparable sample code for java.lang.Comparable definition code for java.lang.Comparable <?> getObjectMinValue sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectMinValue(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectMinValue(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns the minimum legal value for the Object reference within the named element.
 int getObjectValueType sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectValueType(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectValueType(java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName)
          Returns one of the enumerated values starting with VALUE_, indicating the type of values (enumeration, range, or array) that are allowed for the Object reference.
 String sample code for java.lang.String definition code for java.lang.String getRootName sample code for javax.imageio.metadata.IIOMetadataFormat.getRootName() definition code for javax.imageio.metadata.IIOMetadataFormat.getRootName() ()
          Returns the name of the root element of the format.
 boolean isAttributeRequired sample code for javax.imageio.metadata.IIOMetadataFormat.isAttributeRequired(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.isAttributeRequired(java.lang.String, java.lang.String) (String sample code for java.lang.String definition code for java.lang.String  elementName, String sample code for java.lang.String definition code for java.lang.String  attrName)
          Returns true if the named attribute must be present within the named element.
 

Field Detail

CHILD_POLICY_EMPTY sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_EMPTY

static final int CHILD_POLICY_EMPTY
A constant returned by getChildPolicy to indicate that an element may not have any children. In other words, it is required to be a leaf node.

See Also:
Constant Field Values

CHILD_POLICY_ALL sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_ALL

static final int CHILD_POLICY_ALL
A constant returned by getChildPolicy to indicate that an element must have a single instance of each of its legal child elements, in order. In DTD terms, the contents of the element are defined by a sequence a,b,c,d,....

See Also:
Constant Field Values

CHILD_POLICY_SOME sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_SOME

static final int CHILD_POLICY_SOME
A constant returned by getChildPolicy to indicate that an element must have zero or one instance of each of its legal child elements, in order. In DTD terms, the contents of the element are defined by a sequence a?,b?,c?,d?,....

See Also:
Constant Field Values

CHILD_POLICY_CHOICE sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_CHOICE

static final int CHILD_POLICY_CHOICE
A constant returned by getChildPolicy to indicate that an element must have zero or one children, selected from among its legal child elements. In DTD terms, the contents of the element are defined by a selection a|b|c|d|....

See Also:
Constant Field Values

CHILD_POLICY_SEQUENCE sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_SEQUENCE

static final int CHILD_POLICY_SEQUENCE
A constant returned by getChildPolicy to indicate that an element must have a sequence of instances of any of its legal child elements. In DTD terms, the contents of the element are defined by a sequence (a|b|c|d|...)*.

See Also:
Constant Field Values

CHILD_POLICY_REPEAT sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_REPEAT

static final int CHILD_POLICY_REPEAT
A constant returned by getChildPolicy to indicate that an element must have zero or more instances of its unique legal child element. In DTD terms, the contents of the element are defined by a starred expression a*.

See Also:
Constant Field Values

CHILD_POLICY_MAX sample code for javax.imageio.metadata.IIOMetadataFormat.CHILD_POLICY_MAX

static final int CHILD_POLICY_MAX
The largest valid CHILD_POLICY_* constant, to be used for range checks.

See Also:
Constant Field Values

VALUE_NONE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_NONE

static final int VALUE_NONE
A constant returned by getObjectValueType to indicate the absence of a user object.

See Also:
Constant Field Values

VALUE_ARBITRARY sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_ARBITRARY

static final int VALUE_ARBITRARY
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set a single, arbitrary value.

See Also:
Constant Field Values

VALUE_RANGE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE

static final int VALUE_RANGE
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set a range of values. Both the minimum and maximum values of the range are exclusive. It is recommended that ranges of integers be inclusive on both ends, and that exclusive ranges be used only for floating-point data.

See Also:
VALUE_RANGE_MIN_MAX_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_MAX_INCLUSIVE definition code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_MAX_INCLUSIVE , Constant Field Values

VALUE_RANGE_MIN_INCLUSIVE_MASK sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_INCLUSIVE_MASK

static final int VALUE_RANGE_MIN_INCLUSIVE_MASK
A value that may be or'ed with VALUE_RANGE to obtain VALUE_RANGE_MIN_INCLUSIVE, and with VALUE_RANGE_MAX_INCLUSIVE to obtain VALUE_RANGE_MIN_MAX_INCLUSIVE.

Similarly, the value may be and'ed with the value of getAttributeValueTypeor getObjectValueType to determine if the minimum value of the range is inclusive.

See Also:
Constant Field Values

VALUE_RANGE_MAX_INCLUSIVE_MASK sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MAX_INCLUSIVE_MASK

static final int VALUE_RANGE_MAX_INCLUSIVE_MASK
A value that may be or'ed with VALUE_RANGE to obtain VALUE_RANGE_MAX_INCLUSIVE, and with VALUE_RANGE_MIN_INCLUSIVE to obtain VALUE_RANGE_MIN_MAX_INCLUSIVE.

Similarly, the value may be and'ed with the value of getAttributeValueTypeor getObjectValueType to determine if the maximum value of the range is inclusive.

See Also:
Constant Field Values

VALUE_RANGE_MIN_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_INCLUSIVE

static final int VALUE_RANGE_MIN_INCLUSIVE
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set to a range of values. The minimum (but not the maximum) value of the range is inclusive.

See Also:
Constant Field Values

VALUE_RANGE_MAX_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MAX_INCLUSIVE

static final int VALUE_RANGE_MAX_INCLUSIVE
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set to a range of values. The maximum (but not the minimum) value of the range is inclusive.

See Also:
Constant Field Values

VALUE_RANGE_MIN_MAX_INCLUSIVE sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_RANGE_MIN_MAX_INCLUSIVE

static final int VALUE_RANGE_MIN_MAX_INCLUSIVE
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set a range of values. Both the minimum and maximum values of the range are inclusive. It is recommended that ranges of integers be inclusive on both ends, and that exclusive ranges be used only for floating-point data.

See Also:
Constant Field Values

VALUE_ENUMERATION sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_ENUMERATION

static final int VALUE_ENUMERATION
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set one of a number of enumerated values. In the case of attributes, these values are Strings; for objects, they are Objects implementing a given class or interface.

Attribute values of type DATATYPE_BOOLEAN should be marked as enumerations.

See Also:
Constant Field Values

VALUE_LIST sample code for javax.imageio.metadata.IIOMetadataFormat.VALUE_LIST

static final int VALUE_LIST
A constant returned by getAttributeValueType and getObjectValueType to indicate that the attribute or user object may be set to a list or array of values. In the case of attributes, the list will consist of whitespace-separated values within a String; for objects, an array will be used.

See Also:
Constant Field Values

DATATYPE_STRING sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_STRING

static final int DATATYPE_STRING
A constant returned by getAttributeDataType indicating that the value of an attribute is a general Unicode string.

See Also:
Constant Field Values

DATATYPE_BOOLEAN sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_BOOLEAN

static final int DATATYPE_BOOLEAN
A constant returned by getAttributeDataType indicating that the value of an attribute is one of 'true' or 'false'.

See Also:
Constant Field Values

DATATYPE_INTEGER sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_INTEGER

static final int DATATYPE_INTEGER
A constant returned by getAttributeDataType indicating that the value of an attribute is a string representation of an integer.

See Also:
Constant Field Values

DATATYPE_FLOAT sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_FLOAT

static final int DATATYPE_FLOAT
A constant returned by getAttributeDataType indicating that the value of an attribute is a string representation of a decimal floating-point number.

See Also:
Constant Field Values

DATATYPE_DOUBLE sample code for javax.imageio.metadata.IIOMetadataFormat.DATATYPE_DOUBLE

static final int DATATYPE_DOUBLE
A constant returned by getAttributeDataType indicating that the value of an attribute is a string representation of a double-precision decimal floating-point number.

See Also:
Constant Field Values
Method Detail

getRootName sample code for javax.imageio.metadata.IIOMetadataFormat.getRootName() definition code for javax.imageio.metadata.IIOMetadataFormat.getRootName()

String sample code for java.lang.String definition code for java.lang.String  getRootName()
Returns the name of the root element of the format.

Returns:
a String.

canNodeAppear sample code for javax.imageio.metadata.IIOMetadataFormat.canNodeAppear(java.lang.String, javax.imageio.ImageTypeSpecifier) definition code for javax.imageio.metadata.IIOMetadataFormat.canNodeAppear(java.lang.String, javax.imageio.ImageTypeSpecifier)

boolean canNodeAppear(String sample code for java.lang.String definition code for java.lang.String  elementName,
                      ImageTypeSpecifier sample code for javax.imageio.ImageTypeSpecifier definition code for javax.imageio.ImageTypeSpecifier  imageType)
Returns true if the element (and the subtree below it) is allowed to appear in a metadata document for an image of the given type, defined by an ImageTypeSpecifier. For example, a metadata document format might contain an element that describes the primary colors of the image, which would not be allowed when writing a grayscale image.

Parameters:
elementName - the name of the element being queried.
imageType - an ImageTypeSpecifier indicating the type of the image that will be associated with the metadata.
Returns:
true if the node is meaningful for images of the given type.

getElementMinChildren sample code for javax.imageio.metadata.IIOMetadataFormat.getElementMinChildren(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getElementMinChildren(java.lang.String)

int getElementMinChildren(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the minimum number of children of the named element with child policy CHILD_POLICY_REPEAT. For example, an element representing color primary information might be required to have at least 3 children, one for each primay.

Parameters:
elementName - the name of the element being queried.
Returns:
an int.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element does not have a child policy of CHILD_POLICY_REPEAT.

getElementMaxChildren sample code for javax.imageio.metadata.IIOMetadataFormat.getElementMaxChildren(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getElementMaxChildren(java.lang.String)

int getElementMaxChildren(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the maximum number of children of the named element with child policy CHILD_POLICY_REPEAT. For example, an element representing an entry in an 8-bit color palette might be allowed to repeat up to 256 times. A value of Integer.MAX_VALUE may be used to specify that there is no upper bound.

Parameters:
elementName - the name of the element being queried.
Returns:
an int.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element does not have a child policy of CHILD_POLICY_REPEAT.

getElementDescription sample code for javax.imageio.metadata.IIOMetadataFormat.getElementDescription(java.lang.String, java.util.Locale) definition code for javax.imageio.metadata.IIOMetadataFormat.getElementDescription(java.lang.String, java.util.Locale)

String sample code for java.lang.String definition code for java.lang.String  getElementDescription(String sample code for java.lang.String definition code for java.lang.String  elementName,
                             Locale sample code for java.util.Locale definition code for java.util.Locale  locale)
Returns a String containing a description of the named element, or null. The desciption will be localized for the supplied Locale if possible.

If locale is null, the current default Locale returned by Locale.getLocale will be used.

Parameters:
elementName - the name of the element.
locale - the Locale for which localization will be attempted.
Returns:
the element description.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null, or is not a legal element name for this format.

getChildPolicy sample code for javax.imageio.metadata.IIOMetadataFormat.getChildPolicy(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getChildPolicy(java.lang.String)

int getChildPolicy(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns one of the constants starting with CHILD_POLICY_, indicating the legal pattern of children for the named element.

Parameters:
elementName - the name of the element being queried.
Returns:
one of the CHILD_POLICY_* constants.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.

getChildNames sample code for javax.imageio.metadata.IIOMetadataFormat.getChildNames(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getChildNames(java.lang.String)

String sample code for java.lang.String definition code for java.lang.String [] getChildNames(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns an array of Strings indicating the names of the element which are allowed to be children of the named element, in the order in which they should appear. If the element cannot have children, null is returned.

Parameters:
elementName - the name of the element being queried.
Returns:
an array of Strings, or null.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.

getAttributeNames sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeNames(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeNames(java.lang.String)

String sample code for java.lang.String definition code for java.lang.String [] getAttributeNames(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns an array of Strings listing the names of the attributes that may be associated with the named element.

Parameters:
elementName - the name of the element being queried.
Returns:
an array of Strings.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.

getAttributeValueType sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeValueType(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeValueType(java.lang.String, java.lang.String)

int getAttributeValueType(String sample code for java.lang.String definition code for java.lang.String  elementName,
                          String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns one of the constants starting with VALUE_, indicating whether the values of the given attribute within the named element are arbitrary, constrained to lie within a specified range, constrained to be one of a set of enumerated values, or are a whitespace-separated list of arbitrary values.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
one of the VALUE_* constants.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.

getAttributeDataType sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDataType(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDataType(java.lang.String, java.lang.String)

int getAttributeDataType(String sample code for java.lang.String definition code for java.lang.String  elementName,
                         String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns one of the constants starting with DATATYPE_, indicating the format and interpretation of the value of the given attribute within th enamed element. If getAttributeValueType returns VALUE_LIST, then the legal value is a whitespace-spearated list of values of the returned datatype.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
one of the DATATYPE_* constants.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.

isAttributeRequired sample code for javax.imageio.metadata.IIOMetadataFormat.isAttributeRequired(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.isAttributeRequired(java.lang.String, java.lang.String)

boolean isAttributeRequired(String sample code for java.lang.String definition code for java.lang.String  elementName,
                            String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns true if the named attribute must be present within the named element.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
true if the attribut must be present.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.

getAttributeDefaultValue sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDefaultValue(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDefaultValue(java.lang.String, java.lang.String)

String sample code for java.lang.String definition code for java.lang.String  getAttributeDefaultValue(String sample code for java.lang.String definition code for java.lang.String  elementName,
                                String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns the default value of the named attribute, if it is not explictly present within the named element, as a String, or null if no default value is available.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
a String containing the default value, or null.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.

getAttributeEnumerations sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeEnumerations(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeEnumerations(java.lang.String, java.lang.String)

String sample code for java.lang.String definition code for java.lang.String [] getAttributeEnumerations(String sample code for java.lang.String definition code for java.lang.String  elementName,
                                  String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns an array of Strings containing the legal enumerated values for the given attribute within the named element. This method should only be called if getAttributeValueType returns VALUE_ENUMERATION.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
an array of Strings.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the given attribute is not defined as an enumeration.

getAttributeMinValue sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMinValue(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMinValue(java.lang.String, java.lang.String)

String sample code for java.lang.String definition code for java.lang.String  getAttributeMinValue(String sample code for java.lang.String definition code for java.lang.String  elementName,
                            String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns the minimum legal value for the attribute. Whether this value is inclusive or exclusive may be determined by the value of getAttributeValueType. The value is returned as a String; its interpretation is dependent on the value of getAttributeDataType. This method should only be called if getAttributeValueType returns VALUE_RANGE_*.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
a String containing the smallest legal value for the attribute.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the given attribute is not defined as a range.

getAttributeMaxValue sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMaxValue(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeMaxValue(java.lang.String, java.lang.String)

String sample code for java.lang.String definition code for java.lang.String  getAttributeMaxValue(String sample code for java.lang.String definition code for java.lang.String  elementName,
                            String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns the maximum legal value for the attribute. Whether this value is inclusive or exclusive may be determined by the value of getAttributeValueType. The value is returned as a String; its interpretation is dependent on the value of getAttributeDataType. This method should only be called if getAttributeValueType returns VALUE_RANGE_*.

Parameters:
elementName - the name of the element being queried, as a String.
attrName - the name of the attribute being queried.
Returns:
a String containing the largest legal value for the attribute.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the given attribute is not defined as a range.

getAttributeListMinLength sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMinLength(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMinLength(java.lang.String, java.lang.String)

int getAttributeListMinLength(String sample code for java.lang.String definition code for java.lang.String  elementName,
                              String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns the minimum number of list items that may be used to define this attribute. The attribute itself is defined as a String containing multiple whitespace-separated items. This method should only be called if getAttributeValueType returns VALUE_LIST.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
the smallest legal number of list items for the attribute.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the given attribute is not defined as a list.

getAttributeListMaxLength sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMaxLength(java.lang.String, java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeListMaxLength(java.lang.String, java.lang.String)

int getAttributeListMaxLength(String sample code for java.lang.String definition code for java.lang.String  elementName,
                              String sample code for java.lang.String definition code for java.lang.String  attrName)
Returns the maximum number of list items that may be used to define this attribute. A value of Integer.MAX_VALUE may be used to specify that there is no upper bound. The attribute itself is defined as a String containing multiple whitespace-separated items. This method should only be called if getAttributeValueType returns VALUE_LIST.

Parameters:
elementName - the name of the element being queried.
attrName - the name of the attribute being queried.
Returns:
the largest legal number of list items for the attribute.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the given attribute is not defined as a list.

getAttributeDescription sample code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDescription(java.lang.String, java.lang.String, java.util.Locale) definition code for javax.imageio.metadata.IIOMetadataFormat.getAttributeDescription(java.lang.String, java.lang.String, java.util.Locale)

String sample code for java.lang.String definition code for java.lang.String  getAttributeDescription(String sample code for java.lang.String definition code for java.lang.String  elementName,
                               String sample code for java.lang.String definition code for java.lang.String  attrName,
                               Locale sample code for java.util.Locale definition code for java.util.Locale  locale)
Returns a String containing a description of the named attribute, or null. The desciption will be localized for the supplied Locale if possible.

If locale is null, the current default Locale returned by Locale.getLocale will be used.

Parameters:
elementName - the name of the element.
attrName - the name of the attribute.
locale - the Locale for which localization will be attempted.
Returns:
the attribute description.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null, or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if attrName is null or is not a legal attribute name for this element.

getObjectValueType sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectValueType(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectValueType(java.lang.String)

int getObjectValueType(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns one of the enumerated values starting with VALUE_, indicating the type of values (enumeration, range, or array) that are allowed for the Object reference. If no object value can be stored within the given element, the result of this method will be VALUE_NONE.

Object references whose legal values are defined as a range must implement the Comparable interface.

Parameters:
elementName - the name of the element being queried.
Returns:
one of the VALUE_* constants.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
See Also:
Comparable sample code for java.lang.Comparable definition code for java.lang.Comparable

getObjectClass sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectClass(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectClass(java.lang.String)

Class sample code for java.lang.Class definition code for java.lang.Class <?> getObjectClass(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the Class type of the Object reference stored within the element. If this element may not contain an Object reference, an IllegalArgumentException will be thrown. If the class type is an array, this field indicates the underlying class type (e.g, for an array of ints, this method would return int.class).

Object references whose legal values are defined as a range must implement the Comparable interface.

Parameters:
elementName - the name of the element being queried.
Returns:
a Class object.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).

getObjectDefaultValue sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectDefaultValue(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectDefaultValue(java.lang.String)

Object sample code for java.lang.Object definition code for java.lang.Object  getObjectDefaultValue(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns an Objects containing the default value for the Object reference within the named element.

Parameters:
elementName - the name of the element being queried.
Returns:
an Object.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).

getObjectEnumerations sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectEnumerations(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectEnumerations(java.lang.String)

Object sample code for java.lang.Object definition code for java.lang.Object [] getObjectEnumerations(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns an array of Objects containing the legal enumerated values for the Object reference within the named element. This method should only be called if getObjectValueType returns VALUE_ENUMERATION.

The Object associated with a node that accepts emuerated values must be equal to one of the values returned by this method, as defined by the == operator (as opposed to the Object.equals method).

Parameters:
elementName - the name of the element being queried.
Returns:
an array of Objects.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the Object is not defined as an enumeration.

getObjectMinValue sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectMinValue(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectMinValue(java.lang.String)

Comparable sample code for java.lang.Comparable definition code for java.lang.Comparable <?> getObjectMinValue(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the minimum legal value for the Object reference within the named element. Whether this value is inclusive or exclusive may be determined by the value of getObjectValueType. This method should only be called if getObjectValueType returns one of the constants starting with VALUE_RANGE.

Parameters:
elementName - the name of the element being queried.
Returns:
the smallest legal value for the attribute.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the Object is not defined as a range.

getObjectMaxValue sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectMaxValue(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectMaxValue(java.lang.String)

Comparable sample code for java.lang.Comparable definition code for java.lang.Comparable <?> getObjectMaxValue(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the maximum legal value for the Object reference within the named element. Whether this value is inclusive or exclusive may be determined by the value of getObjectValueType. This method should only be called if getObjectValueType returns one of the constants starting with VALUE_RANGE.

Parameters:
elementName - the name of the element being queried.
Returns:
the smallest legal value for the attribute.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the Object is not defined as a range.

getObjectArrayMinLength sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMinLength(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMinLength(java.lang.String)

int getObjectArrayMinLength(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the minimum number of array elements that may be used to define the Object reference within the named element. This method should only be called if getObjectValueType returns VALUE_LIST.

Parameters:
elementName - the name of the element being queried.
Returns:
the smallest valid array length for the Object reference.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the Object is not an array.

getObjectArrayMaxLength sample code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMaxLength(java.lang.String) definition code for javax.imageio.metadata.IIOMetadataFormat.getObjectArrayMaxLength(java.lang.String)

int getObjectArrayMaxLength(String sample code for java.lang.String definition code for java.lang.String  elementName)
Returns the maximum number of array elements that may be used to define the Object reference within the named element. A value of Integer.MAX_VALUE may be used to specify that there is no upper bound. This method should only be called if getObjectValueType returns VALUE_LIST.

Parameters:
elementName - the name of the element being queried.
Returns:
the largest valid array length for the Object reference.
Throws:
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if elementName is null or is not a legal element name for this format.
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the named element cannot contain an object value (i.e., if getObjectValueType(elementName) == VALUE_NONE).
IllegalArgumentException sample code for java.lang.IllegalArgumentException definition code for java.lang.IllegalArgumentException - if the Object is not an array.