|
Media Authoring with Java API |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objecttv.amwa.maj.entity.InterchangeObject
tv.amwa.maj.entity.EssenceDescriptor
@AAFClass(uuid1=218169601, uuid2=257, uuid3=9216, uuid4={6,14,43,52,2,6,1,1}, definedName="EssenceDescriptor", description="The EssenceDescriptor class describes the format of the essence associated with a file SourceMob or of the media associated with a physical SourceMob.") public abstract class EssenceDescriptor
Implements the description of the format of the content data associated with a file source mob or of the media associated with a physical source mob.
THE COMMENTS FOR THIS CLASS ARE INCOMPLETE.
Nested Class Summary | |
---|---|
static class |
EssenceDescriptor.EssenceDescriptorXMLHandler
|
static class |
EssenceDescriptor.LocatorXMLHandler
|
static class |
EssenceDescriptor.SubDescriptorXMLHandler
|
Nested classes/interfaces inherited from class tv.amwa.maj.entity.InterchangeObject |
---|
InterchangeObject.InterchangeObjectXMLHandler |
Field Summary | |
---|---|
static String |
ESSENCEDESCRIPTOR_ITEM
|
Constructor Summary | |
---|---|
EssenceDescriptor()
|
Method Summary | |
---|---|
void |
appendLocator(Locator locator)
Append a locator to the list of locators of this essence descriptors, with each locator having operating-system-dependent data or text information that provide hints for finding files or physical media. |
void |
appendSubDescriptor(SubDescriptor subDescriptor)
Append a sub descriptor to the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. |
void |
appendXMLChildren(Node parent)
Append child elements to the given parent node to serialize the value of an object to an XML fragment. |
EssenceDescriptor |
clone()
|
int |
countLocators()
Return the number of locators attached to this essence descriptor, which each have operating-system-dependent data or text information that provide hints for finding files or physical media. |
int |
countSubDescriptors()
Returns the number of sub descriptors attached to this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. |
boolean |
equals(Object o)
|
Locator |
getLocatorAt(int index)
Retrieves the locator at the given index, where each locator has operating-system-dependent data or text information that provide hints for finding files or physical media. |
List<Locator> |
getLocators()
Returns a list of all the locators in this essence descriptors, where each locator has operating-system-dependent data or text information that provide hints for finding files or physical media. |
SubDescriptor |
getSubDescriptorAt(int index)
Returns the sub descriptor at the given index through the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. |
List<SubDescriptor> |
getSubDescriptors()
Returns the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. |
int |
hashCode()
|
void |
insertLocatorAt(int index,
Locator locator)
Inserts a locator into the list of locators of this essence descriptors at the given index. |
void |
insertSubDescriptorAt(int index,
SubDescriptor subDescriptor)
Inserts the given sub descriptor into the list of sub descriptors of this essence descriptor at the given index. |
void |
prependLocator(Locator locator)
Prepend a locator to the list of locators of this essence descriptor, with each locator having operating-system-dependent data or text information that provide hints for finding files or physical media. |
void |
prependSubDescriptor(SubDescriptor subDescriptor)
Prepend a sub descriptor to the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. |
void |
removeLocatorAt(int index)
Removes the locator at the given index, where each locator has operating-system-dependent data or text information that provide hints for finding files or physical media. |
void |
removeSubDescriptorAt(int index)
Removes the sub descriptor at the given index through the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. |
void |
setPropertiesFromInterface(EssenceDescriptor castFrom)
|
Methods inherited from class tv.amwa.maj.entity.InterchangeObject |
---|
castFromInterface, countProperties, createOptionalPropertyValue, disableGenerationTracking, enableGenerationTracking, getDefinition, getGeneration, getGenerationAUID, getProperties, getPropertyValue, isGenerationTracked, isPropertyPresent, omitOpionalProperty, registerImplementation, setPropertiesFromInterface, setPropertyValue, toString |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, wait, wait, wait |
Methods inherited from interface tv.amwa.maj.iface.InterchangeObject |
---|
countProperties, createOptionalPropertyValue, disableGenerationTracking, enableGenerationTracking, getDefinition, getGeneration, getGenerationAUID, getProperties, getPropertyValue, isGenerationTracked, isPropertyPresent, omitOpionalProperty, setPropertyValue |
Field Detail |
---|
public static final String ESSENCEDESCRIPTOR_ITEM
Constructor Detail |
---|
public EssenceDescriptor()
Method Detail |
---|
public final void setPropertiesFromInterface(EssenceDescriptor castFrom)
InterchangeObject.setPropertiesFromInterface(tv.amwa.maj.iface.InterchangeObject)
public void appendLocator(Locator locator) throws NullPointerException
EssenceDescriptor
Append a locator to the list of locators of this essence descriptors, with each locator having operating-system-dependent data or text information that provide hints for finding files or physical media. Use this function to add a locator to be scanned last when searching for the essence, providing a secondary location for the essence.
appendLocator
in interface EssenceDescriptor
locator
- Locator to append to the list of locators in this essence descriptor.
NullPointerException
- The given locator is null
.public int countLocators()
EssenceDescriptor
Return the number of locators attached to this essence descriptor, which each have operating-system-dependent data or text information that provide hints for finding files or physical media. The number of locators may be zero if the essence is located within the current file.
countLocators
in interface EssenceDescriptor
public Locator getLocatorAt(int index) throws IndexOutOfBoundsException
EssenceDescriptor
Retrieves the locator at the given index, where each locator has operating-system-dependent data or text information that provide hints for finding files or physical media.
getLocatorAt
in interface EssenceDescriptor
index
- Index of locator to retrieve from the list of locators of the essence descriptor.
IndexOutOfBoundsException
- The given index is outside the acceptable range for the
current list of essence descriptors.@AAFProperty(uuid1=100729092, uuid2=1539, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="Locator", typeName="StrongReferenceVector of Locator", optional=true, uniqueIdentifier=false, pid=12033) public List<Locator> getLocators()
EssenceDescriptor
Returns a list of all the locators in this essence descriptors, where each locator has operating-system-dependent data or text information that provide hints for finding files or physical media. The number of locators may be zero if the essence is in the current file.
getLocators
in interface EssenceDescriptor
public void insertLocatorAt(int index, Locator locator) throws NullPointerException, IndexOutOfBoundsException
EssenceDescriptor
Inserts a locator into the list of locators of this essence descriptors at the given index. Each locator has operating-system-dependent data or text information that provide hints for finding files or physical media. The locators already existing at the given and higher indices will be moved to the next higher index to accommodate.
insertLocatorAt
in interface EssenceDescriptor
index
- Index at which locator is to be insertedlocator
- Locator to insert.
NullPointerException
- Argument is null.
IndexOutOfBoundsException
- The given index is outside the acceptable range for the
current list of essence descriptors.public void prependLocator(Locator locator) throws NullPointerException
EssenceDescriptor
Prepend a locator to the list of locators of this essence descriptor, with each locator having operating-system-dependent data or text information that provide hints for finding files or physical media. Use this function to add a locator to be scanned first when searching for the essence, providing a new primary location for the essence.
prependLocator
in interface EssenceDescriptor
locator
- Locator to prepend to the list of locators in this essence descriptor.
NullPointerException
public void removeLocatorAt(int index) throws IndexOutOfBoundsException
EssenceDescriptor
Removes the locator at the given index, where each locator has operating-system-dependent data or text information that provide hints for finding files or physical media. Locators already existing at indices higher than the given index will be moved to the next lower index to accommodate.
removeLocatorAt
in interface EssenceDescriptor
index
- Index of locator to remove from the list of locators of this essence descriptor.
IndexOutOfBoundsException
- The given index is outside the acceptable range for the
current list of essence descriptors.@AAFProperty(uuid1=100729092, uuid2=1552, uuid3=0, uuid4={6,14,43,52,1,1,1,9}, definedName="SubDescriptors", typeName="StrongReferenceVector of SubDescriptor", optional=true, uniqueIdentifier=false, pid=12034) public List<SubDescriptor> getSubDescriptors()
EssenceDescriptor
Returns the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. The sub descriptor list may be empty.
getSubDescriptors
in interface EssenceDescriptor
public int countSubDescriptors()
EssenceDescriptor
Returns the number of sub descriptors attached to this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. This list of sub-descriptors may be empty.
countSubDescriptors
in interface EssenceDescriptor
public void appendSubDescriptor(SubDescriptor subDescriptor) throws NullPointerException
EssenceDescriptor
Append a sub descriptor to the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy.
appendSubDescriptor
in interface EssenceDescriptor
subDescriptor
- Sub descriptor to append to the list of sub descriptors for this essence descriptor.
NullPointerException
- The given sub descriptor is null
.public SubDescriptor getSubDescriptorAt(@UInt32 int index) throws IndexOutOfBoundsException
EssenceDescriptor
Returns the sub descriptor at the given index through the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy.
getSubDescriptorAt
in interface EssenceDescriptor
index
- Index of the sub descriptor value to retrieve.
IndexOutOfBoundsException
- The given index is outside the acceptable range
for the current list of sub descriptors.public void prependSubDescriptor(SubDescriptor subDescriptor)
EssenceDescriptor
Prepend a sub descriptor to the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy.
prependSubDescriptor
in interface EssenceDescriptor
subDescriptor
- Sub descriptor to prepend to the list of sub descriptors for this essence descriptor.public void insertSubDescriptorAt(@UInt32 int index, SubDescriptor subDescriptor) throws NullPointerException, IndexOutOfBoundsException
EssenceDescriptor
Inserts the given sub descriptor into the list of sub descriptors of this essence descriptor at the given index. Sub descriptors specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy.
insertSubDescriptorAt
in interface EssenceDescriptor
index
- Index at which the sub descriptor should be inserted into the list of sub
descriptors of this essence descriptor.subDescriptor
- Sub descriptor to insert.
NullPointerException
- The sub descriptor argument is null
.
IndexOutOfBoundsException
- The given index is outside the acceptable range
for the list of sub descriptors of this essence descriptor.public void removeSubDescriptorAt(@UInt32 int index) throws IndexOutOfBoundsException
EssenceDescriptor
Removes the sub descriptor at the given index through the list of sub descriptors of this essence descriptor, which specify additional descriptor metadata that is not included in the main essence descriptor class hierarchy. Sub descriptors at higher indices will be moved to fill the gap made by the removal.
removeSubDescriptorAt
in interface EssenceDescriptor
index
- Index of the sub descriptor to remove.
IndexOutOfBoundsException
- The given index is outside the acceptable range
for the current list of sub descriptors.public boolean equals(Object o)
equals
in class Object
public int hashCode()
hashCode
in class Object
public EssenceDescriptor clone()
clone
in class Object
public void appendXMLChildren(Node parent)
XMLSerializable
Append child elements to the given parent node to serialize the value of an object
to an XML fragment. Methods of the XMLBuilder
class are provided to help with this
process.
appendXMLChildren
in interface XMLSerializable
appendXMLChildren
in class InterchangeObject
parent
- XML parent element to append child nodes to.
|
Media Authoring with Java API |
|||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |