|
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
tv.amwa.maj.entity.AAFFileDescriptor
tv.amwa.maj.entity.MultipleDescriptor
@AAFClass(uuid1=218169601, uuid2=257, uuid3=17408, uuid4={6,14,43,52,2,6,1,1}, definedName="MultipleDescriptor", description="Describes the format of the content data associated with a file source mob containing multiple tracks of essence.") public class MultipleDescriptor
Implements the description of content data associated with a single file source mob that contains multiple tracks of essence. Each file descriptor within a multiple descriptor should set the linked slot property that links it to the source mob slot that it describes.
THE COMMENTS FOR THIS CLASS ARE INCOMPLETE.
Nested Class Summary | |
---|---|
static class |
MultipleDescriptor.FileDescriptorsXMLHandler
|
static class |
MultipleDescriptor.XMLHandler
|
Nested classes/interfaces inherited from class tv.amwa.maj.entity.AAFFileDescriptor |
---|
AAFFileDescriptor.FileDescriptorXMLHandler |
Nested classes/interfaces inherited from class tv.amwa.maj.entity.EssenceDescriptor |
---|
EssenceDescriptor.EssenceDescriptorXMLHandler, EssenceDescriptor.LocatorXMLHandler, EssenceDescriptor.SubDescriptorXMLHandler |
Nested classes/interfaces inherited from class tv.amwa.maj.entity.InterchangeObject |
---|
InterchangeObject.InterchangeObjectXMLHandler |
Field Summary | |
---|---|
static String |
MULTIPLEDESCRIPTOR_TAG
|
Fields inherited from class tv.amwa.maj.entity.AAFFileDescriptor |
---|
FILEDESCRIPTOR_ITEM |
Fields inherited from class tv.amwa.maj.entity.EssenceDescriptor |
---|
ESSENCEDESCRIPTOR_ITEM |
Constructor Summary | |
---|---|
MultipleDescriptor()
Creates and initializes a new multiple descriptor for static essence, which describes the format of the content data associated with a file source mob
containing multiple tracks of essence. |
|
MultipleDescriptor(Rational sampleRate,
long length)
Creates and initializes a new multiple descriptor for time varying essence, which describes the format of the content data associated with a file source mob
containing multiple tracks of essence. |
Method Summary | |
---|---|
void |
appendFileDescriptor(AAFFileDescriptor fileDescriptor)
Appends a file descriptor to the list of file descriptors of this multiple descriptor. |
void |
appendXMLChildren(Node parent)
Append child elements to the given parent node to serialize the value of an object to an XML fragment. |
MultipleDescriptor |
clone()
Creates a cloned copy of this entity. |
int |
countFileDescriptors()
Returns the number of file descriptors of this multiple descriptor. |
boolean |
equals(Object o)
Tests to see if the given object is equal to this interchange object. |
AAFFileDescriptor |
getFileDescriptorAt(int index)
Returns the file descriptor at the given index through the list of file descriptors of this multiple descriptor. |
List<AAFFileDescriptor> |
getFileDescriptors()
Returns a copy of the list of file descriptors of this multiple descriptor. |
int |
hashCode()
Returns a hash code value for this interchange object. |
void |
insertFileDescriptorAt(int index,
AAFFileDescriptor fileDescriptor)
Insert a file descriptor into the list of file descriptors of this multiple descriptor at the given index. |
void |
prependFileDescriptor(AAFFileDescriptor fileDescriptor)
Prepends a file descriptor to the list of file descriptors of this multiple essence descriptor. |
void |
removeFileDescriptorAt(int index)
Removes the file descriptor at the given index from the list of file descriptors of this multiple descriptor. |
void |
setPropertiesFromInterface(MultipleDescriptor castFrom)
|
Methods inherited from class tv.amwa.maj.entity.AAFFileDescriptor |
---|
describesStaticEssence, getCodecDefinition, getContainerFormat, getLength, getLinkedSlotID, getSampleRate, setCodecDefinition, setContainerFormat, setDescribesStaticEssence, setDescribesTimeVaryingEssence, setLength, setLinkedSlotID, setPropertiesFromInterface, setSampleRate |
Methods inherited from class tv.amwa.maj.entity.EssenceDescriptor |
---|
appendLocator, appendSubDescriptor, countLocators, countSubDescriptors, getLocatorAt, getLocators, getSubDescriptorAt, getSubDescriptors, insertLocatorAt, insertSubDescriptorAt, prependLocator, prependSubDescriptor, removeLocatorAt, removeSubDescriptorAt, setPropertiesFromInterface |
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.AAFFileDescriptor |
---|
getCodecDefinition, getContainerFormat, getLength, getLinkedSlotID, getSampleRate, setCodecDefinition, setContainerFormat, setLength, setLinkedSlotID, setSampleRate |
Methods inherited from interface tv.amwa.maj.iface.EssenceDescriptor |
---|
appendLocator, appendSubDescriptor, countLocators, countSubDescriptors, getLocatorAt, getLocators, getSubDescriptorAt, getSubDescriptors, insertLocatorAt, insertSubDescriptorAt, prependLocator, prependSubDescriptor, removeLocatorAt, removeSubDescriptorAt |
Methods inherited from interface tv.amwa.maj.iface.InterchangeObject |
---|
countProperties, createOptionalPropertyValue, disableGenerationTracking, enableGenerationTracking, getDefinition, getGeneration, getGenerationAUID, getProperties, getPropertyValue, isGenerationTracked, isPropertyPresent, omitOpionalProperty, setPropertyValue |
Methods inherited from interface tv.amwa.maj.entity.MAJCommon |
---|
toString |
Field Detail |
---|
public static final String MULTIPLEDESCRIPTOR_TAG
Constructor Detail |
---|
public MultipleDescriptor()
Creates and initializes a new multiple descriptor for static essence, which describes
the format of the content data associated with a file source mob
containing multiple tracks of essence. File descriptors for each of the tracks
of data can then be added using the
append,
insert
and
prepend
methods.
public MultipleDescriptor(Rational sampleRate, @LengthType long length) throws NullPointerException, IllegalArgumentException
Creates and initializes a new multiple descriptor for time varying essence, which describes
the format of the content data associated with a file source mob
containing multiple tracks of essence. File descriptors for each of the tracks
of data can then be added using the
append,
insert
and
prepend
methods.
sampleRate
- Sample rate for the content represented by this multiple descriptor.length
- Length of content represented by this multiple descriptor.
NullPointerException
- The sample rate argument is null
.
IllegalArgumentException
- The length of the multiple descriptor cannot be a
negative value.Method Detail |
---|
public final void setPropertiesFromInterface(MultipleDescriptor castFrom)
InterchangeObject.setPropertiesFromInterface(tv.amwa.maj.iface.InterchangeObject)
@AAFProperty(uuid1=100729092, uuid2=1547, uuid3=0, uuid4={6,14,43,52,1,1,1,4}, definedName="FileDescriptors", typeName="StrongReferenceVector of FileDescriptor", optional=false, uniqueIdentifier=false, pid=16129) public List<AAFFileDescriptor> getFileDescriptors()
MultipleDescriptor
Returns a copy of the list of file descriptors of this multiple descriptor.
getFileDescriptors
in interface MultipleDescriptor
public void appendFileDescriptor(AAFFileDescriptor fileDescriptor) throws NullPointerException
MultipleDescriptor
Appends a file descriptor to the list of file descriptors of this multiple
descriptor. Use this function to add a file descriptor
to
the end of the interleave pattern.
appendFileDescriptor
in interface MultipleDescriptor
fileDescriptor
- File descriptor to append to this multiple descriptor.
NullPointerException
- The given file descriptor is null
.public int countFileDescriptors()
MultipleDescriptor
Returns the number of file descriptors of this multiple descriptor.
countFileDescriptors
in interface MultipleDescriptor
public AAFFileDescriptor getFileDescriptorAt(int index) throws IndexOutOfBoundsException
MultipleDescriptor
Returns the file descriptor at the given index through the list of file descriptors of this multiple descriptor.
getFileDescriptorAt
in interface MultipleDescriptor
index
- Index of the file descriptor to retrieve.
IndexOutOfBoundsException
- The given index is outside the acceptable range for
the current list of file descriptors.public void insertFileDescriptorAt(int index, AAFFileDescriptor fileDescriptor) throws NullPointerException, IndexOutOfBoundsException
MultipleDescriptor
Insert a file descriptor into the list of file descriptors of this multiple descriptor at the given index. Other indices will be adjusted upwards to accommodate the new item.
insertFileDescriptorAt
in interface MultipleDescriptor
index
- Index at which the given file descriptor is to be inserted.fileDescriptor
- File descriptor to insert.
NullPointerException
- The file descriptor argument is null
.
IndexOutOfBoundsException
- The given index is outside the acceptable range for
the current list of file descriptors.public void prependFileDescriptor(AAFFileDescriptor fileDescriptor) throws NullPointerException
MultipleDescriptor
Prepends a file descriptor to the list of file descriptors of this multiple
essence descriptor. Use this method to add a file descriptor
to to the beginning of the interleave pattern.
prependFileDescriptor
in interface MultipleDescriptor
fileDescriptor
- File descriptor to prepend to this multiple descriptor.
NullPointerException
- The file descriptor argument is null
.public void removeFileDescriptorAt(int index) throws IndexOutOfBoundsException
MultipleDescriptor
Removes the file descriptor at the given index from the list of file descriptors of this multiple descriptor. Indices of other items in the list will be adjusted to a lower value to fill the gap left after the removal.
removeFileDescriptorAt
in interface MultipleDescriptor
index
- Index of the file descriptor to remove.
IndexOutOfBoundsException
- The given index is outside the acceptable range for
the current list of file descriptors.public boolean equals(Object o)
MAJCommon
Tests to see if the given object is equal to this interchange object. To be equal, the given value must be not null, share the same interface to its value and each of the properties of the value must each be equal.
equals
in interface MAJCommon
equals
in class AAFFileDescriptor
o
- Object to test for equality with.
Object.equals(Object)
public int hashCode()
MAJCommon
Returns a hash code value for this interchange object.
hashCode
in interface MAJCommon
hashCode
in class AAFFileDescriptor
Object.hashCode()
public MultipleDescriptor clone()
MAJCommon
Creates a cloned copy of this entity. The clone will be initialized to have the same value as this value but exists independently from then on. Changes to this value will not effect the clone and changes to the clone will not effect this. MAJ API clones are true deep clones with no shared references to areas of memory within the original.
This method does not throw a CloneNotSupportedException
as all
entity values must implement the Cloneable
interface. If a cloning
error does occur, a null
value will be returned but this is very unlikely
to happen.
clone
in interface MAJCommon
clone
in class EssenceDescriptor
Object.clone()
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 AAFFileDescriptor
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 |