|
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()
MultipleDescriptorReturns a copy of the list of file descriptors of this multiple descriptor.
getFileDescriptors in interface MultipleDescriptor
public void appendFileDescriptor(AAFFileDescriptor fileDescriptor)
throws NullPointerException
MultipleDescriptorAppends 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 MultipleDescriptorfileDescriptor - File descriptor to append to this multiple descriptor.
NullPointerException - The given file descriptor is null.public int countFileDescriptors()
MultipleDescriptorReturns the number of file descriptors of this multiple descriptor.
countFileDescriptors in interface MultipleDescriptor
public AAFFileDescriptor getFileDescriptorAt(int index)
throws IndexOutOfBoundsException
MultipleDescriptorReturns the file descriptor at the given index through the list of file descriptors of this multiple descriptor.
getFileDescriptorAt in interface MultipleDescriptorindex - 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
MultipleDescriptorInsert 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 MultipleDescriptorindex - 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
MultipleDescriptorPrepends 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 MultipleDescriptorfileDescriptor - File descriptor to prepend to this multiple descriptor.
NullPointerException - The file descriptor argument is null.
public void removeFileDescriptorAt(int index)
throws IndexOutOfBoundsException
MultipleDescriptorRemoves 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 MultipleDescriptorindex - 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)
MAJCommonTests 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 MAJCommonequals in class AAFFileDescriptoro - Object to test for equality with.
Object.equals(Object)public int hashCode()
MAJCommonReturns a hash code value for this interchange object.
hashCode in interface MAJCommonhashCode in class AAFFileDescriptorObject.hashCode()public MultipleDescriptor clone()
MAJCommonCreates 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 MAJCommonclone in class EssenceDescriptorObject.clone()public void appendXMLChildren(Node parent)
XMLSerializableAppend 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 XMLSerializableappendXMLChildren in class AAFFileDescriptorparent - 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 | |||||||