@MediaClass(uuid1=218169601, uuid2=257, uuid3=13312, uuid4={6,14,43,52,2,6,1,1}, definedName="Package", aliases="Mob", description="Specifies a package, which can describe a composition, essence, or physical media.", symbol="Package", isConcrete=false) public class PackageImpl extends InterchangeObjectImpl implements Package, Package, Serializable, Cloneable
Implements a package, which can describe a composition, essence, or physical media. A package has a unique identifier and consists of metadata.
ObjectClassPropertyID| Constructor and Description |
|---|
PackageImpl() |
| Modifier and Type | Method and Description |
|---|---|
void |
appendMobAttributeItem(TaggedValue mobAttributeItem) |
EventTrackImpl |
appendNewEventTrack(Rational editRate,
Segment segment,
int trackID,
String trackName)
Creates and returns a new event
track with the given edit rate, as well as appending it to
the list of tracks of this package.
|
StaticTrackImpl |
appendNewStaticTrack(Segment segment,
int trackID,
String trackName)
Creates and returns a new static
track with the given property values, as well as appending it to the
list of tracks of this package.
|
TimelineTrackImpl |
appendNewTimelineTrack(Rational editRate,
Segment segment,
int trackID,
String trackName,
long origin)
Creates and returns a new timeline track
with the given property values, as well as appending it to this package.
|
void |
appendPackageAttribute(String name,
String value)
Create and append a new attribute to the collection of attributes contained in this
package, which specify attributes that are under the control of the application
(for example filter control).
|
void |
appendPackageAttribute(TaggedValue packageAttribute)
Appends an existing attribute to the collection of attributes contained in this
package, which specify attributes that are under the control of the application
(for example filter control).
|
void |
appendPackageKLVData(KLVData packageKLVdata)
Appends an existing user KLV data item to the collection
of KLV data items contained in this package.
|
void |
appendPackageTrack(Track track)
Appends the given tracks to the list contained in
this package.
|
void |
appendPackageUserComment(String category,
String comment)
Creates a user-defined comment and adds it to the collection of comments
of this package, which specify user comments that are directly classified
and set up by the operator (for example Bin columns).
|
void |
appendPackageUserComment(TaggedValue packageUserComment)
Append a user comment defined by an existing tagged value
to the collection of user comments of this package, which specify user comments that are
directly classified and set up by the operator (for example Bin columns).
|
void |
changeReference(PackageID oldPackageID,
PackageID newPackageID)
Finds all source clips in this package that refer
to the specified old package and changes the references to point to the
newly specified package.
|
void |
clearMobAttributeList() |
void |
clearPackageAttributes()
Clears the list of package attributes of this package, omitting this optional
property.
|
void |
clearPackageKLVData()
Clears the list of KLV data items of this package, omitting this optional
property.
|
void |
clearPackageTracks()
Clears the list of package tracks attached to this package.
|
void |
clearPackageUserComments()
Clears the list of user comments attached to this package, omitting this
optional property.
|
Package |
clone()
Create a cloned copy of this interchange object.
|
Package |
cloneExternal(Depend resolveDependencies,
IncludedMedia includedMedia,
AAFFile file)
Clones this package, and optionally all dependent packages,
to a package that can be used in an external file, keeping the same package
id.
|
Package |
copy(String destMobName)
Creates and returns a new copy of this package in the same
AAF file.
|
int |
countMobAttributeList() |
int |
countPackageAttributes()
Returns the number of attributes in the collection of attributes contained in
this package, which specify attributes that are under the control of the application
(for example filter control).
|
int |
countPackageKLVData()
Returns the total number of KLV data items in the
collection of KLV data items contained in this package.
|
int |
countPackageTracks()
Returns the number of tracks contained in this package.
|
int |
countPackageUserComments()
Returns the total number of user comments attached to this
package, which specify user comments that are
directly classified and set up by the operator (for example Bin columns).
|
AUID |
getAUID()
TODO
|
boolean |
getConvertFrameRate() |
TimeStamp |
getCreationTime()
Returns the creation time of this package, which is the date and time when this package
was originally created.
|
String |
getCreationTimeString() |
TaggedValue |
getMobAttributeItemAt(int index) |
List<TaggedValue> |
getMobAttributeList() |
List<TaggedValue> |
getPackageAttributes()
Returns the collection of attributes contained in this package, which specify attributes
that are under the control of the application (for example filter control).
|
PackageID |
getPackageID()
Returns the unique (package identifier)
for this package.
|
String |
getPackageIDString() |
List<KLVData> |
getPackageKLVData()
Returns the collection of KLV data items contained in this
package.
|
TimeStamp |
getPackageLastModified()
Returns the modification time for this package, which is the date and time when this
package was last modified.
|
String |
getPackageLastModifiedString() |
String |
getPackageName()
Returns the name of this package, as displayed to the end user.
|
Track |
getPackageTrackAt(int index)
Returns the track at the given index through the
list of tracks contained in this package.
|
List<Track> |
getPackageTracks()
Return the list of tracks contained in this
package.
|
AUID |
getPackageUsage()
Returns the usage of this package.
|
String |
getPackageUsageString() |
List<TaggedValue> |
getPackageUserComments()
Returns the collection of all user comments attached to this package, which specify user comments that are
directly classified and set up by the operator (for example Bin columns).
|
long |
getSubclipBegin() |
long |
getSubclipFullLength() |
String |
getWeakTargetReference()
Provides a name that can be used to make a weak object reference to an
instance of the implementing class.
|
static TimeStamp |
initializeCreationTime() |
static PackageID |
initializePackageID() |
static TimeStamp |
initializePackageLastModified() |
static List<Track> |
initializePackageTracks() |
void |
insertMobAttributeItem(int index,
TaggedValue mobAttributeItem) |
void |
insertPackageTrackAt(int index,
Track track)
Inserts the given track into the list of tracks
contained in this package at the given index.
|
Track |
lookupPackageTrack(int trackID)
|
TimecodeValueImpl |
offsetToPackageTimecode(Segment tcSeg,
long offset)
Calculates the timecode at the given offset into the given timecode segment.
|
void |
prependMobAttributeItem(TaggedValue mobAttributeItem) |
void |
prependPackageAttribute(TaggedValue packageAttribute) |
void |
prependPackageKLVData(KLVData packageKLVdata) |
void |
prependPackageTrack(Track track)
Prepends the given track to the list of tracks
contained in this package.
|
void |
prependPackageUserComment(TaggedValue comment) |
void |
removeMobAttributeItemAt(int index) |
void |
removePackageAttribute(TaggedValue packageAttribute)
Removes the given attribute from the collection of attributes contained in this
package, which specify attributes that are under the control of the application
(for example filter control).
|
void |
removePackageKLVData(KLVData packageKLVdata)
Removes the given item of KLV data from the
collection of KLV data items of this package.
|
void |
removePackageTrackAt(int index)
Removes the track at the given index from the list
of tracks contained in this package.
|
void |
removePackageUserComment(TaggedValue packageUserComment)
Removes the given user comment from the collection of user comments of
this package, which specify user comments that are
directly classified and set up by the operator (for example Bin columns).
|
void |
setConvertFrameRate(Boolean convertFrameRate) |
void |
setCreationTime(TimeStamp createTime)
Sets the creation time of this package, which is the date and time when this package
was originally created.
|
void |
setCreationTimeString(String creationTime) |
void |
setPackageID(PackageID packageID)
Sets the unique (package identifier)
for this package.
|
void |
setPackageIDString(String packageID) |
void |
setPackageLastModified(TimeStamp modTime)
Sets the modification time for this package, which is the date and time when this
package was last modified.
|
void |
setPackageLastModifiedString(String packageLastModified) |
void |
setPackageName(String packageName)
Sets the name of this package, as displayed to the end user.
|
void |
setPackageUsage(AUID packageUsage)
Sets this package's usage.
|
void |
setPackageUsageString(String packageUsage) |
void |
setSubclipBegin(Long subclipBegin) |
void |
setSubclipFullLength(Long subclipFullLength) |
addApplicationPlugin, appendXMLChildren, clearApplicationPlugins, containsApplicationPlugin, containsApplicationPlugin, countApplicationPlugins, deepEquals, disableGenerationTracking, enableGenerationTracking, equals, getApplicationPlugins, getComment, getGeneration, getLinkedGenerationID, getLinkedGenerationIDString, getObjectClass, getPersistentID, getPersistentIndex, hashCode, isGenerationTracked, removeApplicationPlugin, removeApplicationPlugin, setLinkedGenerationID, setLinkedGenerationIDString, setObjectClass, setPersistentID, setPersistentIndex, toStringaddApplicationPlugin, clearApplicationPlugins, containsApplicationPlugin, containsApplicationPlugin, countApplicationPlugins, deepEquals, disableGenerationTracking, enableGenerationTracking, equals, getApplicationPlugins, getGeneration, getLinkedGenerationID, getObjectClass, isGenerationTracked, removeApplicationPlugin, removeApplicationPlugin, setLinkedGenerationID, setObjectClass, toStringgetPersistentID, setPersistentIndex@MediaProperty(uuid1=50397712, uuid2=1792, uuid3=0, uuid4={6,14,43,52,1,1,1,7}, definedName="PackageAttributes", aliases={"Attributes","MobAttributes"}, typeName="TaggedValueStrongReferenceVector", optional=true, uniqueIdentifier=false, pid=17417, symbol="PackageAttributes") public List<TaggedValue> getPackageAttributes() throws PropertyNotPresentException
PackageReturns the collection of attributes contained in this package, which specify attributes that are under the control of the application (for example filter control).
getPackageAttributes in interface PackagePropertyNotPresentException - No attributes are present for this package.TypeDefinitions.TaggedValueStrongReferenceVectorpublic void appendPackageAttribute(String name, String value) throws NullPointerException
PackageCreate and append a new attribute to the collection of attributes contained in this package, which specify attributes that are under the control of the application (for example filter control).
This method creates a new tagged value, initializes it with the specified attribute name/value pair, and appends it to the attribute collection.
appendPackageAttribute in interface Packagename - Name of the new attribute.value - Value of the new attribute.NullPointerException - One or both of the arguments is/are null.Package.appendPackageAttribute(TaggedValue)@MediaListAppend(value="PackageAttributes") public void appendPackageAttribute(TaggedValue packageAttribute) throws NullPointerException
PackageAppends an existing attribute to the collection of attributes contained in this package, which specify attributes that are under the control of the application (for example filter control).
appendPackageAttribute in interface PackagepackageAttribute - Attribute to append to the collection of attributes contained in this
package.NullPointerException - The given attribute is null.Package.appendPackageAttribute(String, String)@MediaListPrepend(value="PackageAttributes") public void prependPackageAttribute(TaggedValue packageAttribute) throws NullPointerException
NullPointerException@MediaPropertyCount(value="PackageAttributes") public int countPackageAttributes()
PackageReturns the number of attributes in the collection of attributes contained in this package, which specify attributes that are under the control of the application (for example filter control).
countPackageAttributes in interface Package@MediaPropertyClear(value="PackageAttributes") public void clearPackageAttributes()
PackageClears the list of package attributes of this package, omitting this optional property.
clearPackageAttributes in interface Package@MediaPropertyRemove(value="PackageAttributes") public void removePackageAttribute(TaggedValue packageAttribute) throws NullPointerException, PropertyNotPresentException, ObjectNotFoundException
PackageRemoves the given attribute from the collection of attributes contained in this package, which specify attributes that are under the control of the application (for example filter control).
removePackageAttribute in interface PackagepackageAttribute - Attribute to remove from the collection of attributes contained in
this package.NullPointerException - The given attribute is null.PropertyNotPresentException - No attributes are present for this package.ObjectNotFoundException - The given attribute could not be
found in collection of attributes contained in this package.@MediaProperty(uuid1=50462978, uuid2=3072, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="PackageUserComments", aliases={"UserComments","MobUserComments"}, typeName="TaggedValueStrongReferenceVector", optional=true, uniqueIdentifier=false, pid=17414, symbol="PackageUserComments") public List<TaggedValue> getPackageUserComments() throws PropertyNotPresentException
PackageReturns the collection of all user comments attached to this package, which specify user comments that are directly classified and set up by the operator (for example Bin columns). This is an optional property.
getPackageUserComments in interface PackagePropertyNotPresentException - No optional user comments are present for this package.TypeDefinitions.TaggedValueStrongReferenceVectorpublic void appendPackageUserComment(String category, String comment) throws NullPointerException
PackageCreates a user-defined comment and adds it to the collection of comments of this package, which specify user comments that are directly classified and set up by the operator (for example Bin columns).
This method creates a new tagged value, initializes it with the specified comment name/value pair, and appends it to the comment collection.
appendPackageUserComment in interface Packagecategory - The name associated with the new comment to create.comment - The corresponding value, or description, of the new comment.NullPointerException - One or both of the name and/or value values is/are null.@MediaListAppend(value="PackageUserComments") public void appendPackageUserComment(TaggedValue packageUserComment) throws NullPointerException
PackageAppend a user comment defined by an existing tagged value to the collection of user comments of this package, which specify user comments that are directly classified and set up by the operator (for example Bin columns).
appendPackageUserComment in interface PackagepackageUserComment - User comment to append to the collection of user comments of this component.NullPointerException - The given user comment value is null.TaggedValueDefinition@MediaListPrepend(value="PackageUserComments") public void prependPackageUserComment(TaggedValue comment) throws NullPointerException
NullPointerException@MediaPropertyCount(value="PackageUserComments") public int countPackageUserComments()
PackageReturns the total number of user comments attached to this package, which specify user comments that are directly classified and set up by the operator (for example Bin columns).
countPackageUserComments in interface Package@MediaPropertyClear(value="PackageUserComments") public void clearPackageUserComments()
PackageClears the list of user comments attached to this package, omitting this optional property.
clearPackageUserComments in interface Package@MediaPropertyRemove(value="PackageUserComments") public void removePackageUserComment(TaggedValue packageUserComment) throws NullPointerException, PropertyNotPresentException, ObjectNotFoundException
PackageRemoves the given user comment from the collection of user comments of this package, which specify user comments that are directly classified and set up by the operator (for example Bin columns).
removePackageUserComment in interface PackagepackageUserComment - User comment to remove from the collection of this package.NullPointerException - The given tagged value user comment is null.PropertyNotPresentException - No user comments are present for this package.ObjectNotFoundException - The given comment is not in the collection of user comments
of this package.@MediaProperty(uuid1=50397712, uuid2=768, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="PackageKLVData", aliases={"MobKLVData","KLVData"}, typeName="KLVDataStrongReferenceVector", optional=true, uniqueIdentifier=false, pid=17415, symbol="PackageKLVData") public List<KLVData> getPackageKLVData() throws PropertyNotPresentException
PackageReturns the collection of KLV data items contained in this package. This is an optional property.
getPackageKLVData in interface PackagePropertyNotPresentException - No KLV data values are present for this package.TypeDefinitions.KLVDataStrongReferenceVector@MediaListAppend(value="PackageKLVData") public void appendPackageKLVData(KLVData packageKLVdata) throws NullPointerException
PackageAppends an existing user KLV data item to the collection of KLV data items contained in this package.
appendPackageKLVData in interface PackagepackageKLVdata - KLV data item to add to the collection of data items contained in
this package.NullPointerException - The given KLV data item is null.KLVDataDefinition@MediaListPrepend(value="PackageKLVData") public void prependPackageKLVData(KLVData packageKLVdata) throws NullPointerException
NullPointerException@MediaPropertyCount(value="PackageKLVData") public int countPackageKLVData()
PackageReturns the total number of KLV data items in the collection of KLV data items contained in this package.
countPackageKLVData in interface Package@MediaPropertyClear(value="PackageKLVData") public void clearPackageKLVData()
PackageClears the list of KLV data items of this package, omitting this optional property.
clearPackageKLVData in interface Package@MediaPropertyRemove(value="PackageKLVData") public void removePackageKLVData(KLVData packageKLVdata) throws NullPointerException, ObjectNotFoundException
PackageRemoves the given item of KLV data from the collection of KLV data items of this package.
removePackageKLVData in interface PackagepackageKLVdata - KLV data to remove from the set of KLV data of this package.NullPointerException - Argument is null.ObjectNotFoundException - The given KLV data object could not be
found in the collection of KLV data items for this package.@MediaProperty(uuid1=100729092, uuid2=1541, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="PackageTracks", aliases={"Slots","MobSlots"}, typeName="TrackStrongReferenceVector", optional=false, uniqueIdentifier=false, pid=17411, symbol="PackageTracks") public List<Track> getPackageTracks()
PackageReturn the list of tracks contained in this package.
getPackageTracks in interface PackageTypeDefinitions.TrackStrongReferenceVectorpublic EventTrackImpl appendNewEventTrack(Rational editRate, Segment segment, int trackID, String trackName) throws NullPointerException, IllegalArgumentException, TrackExistsException
PackageCreates and returns a new event track with the given edit rate, as well as appending it to the list of tracks of this package.
appendNewEventTrack in interface PackageeditRate - Edit rate property for the new event track.segment - Segment for the new event track.trackID - Track ID for the new event track.trackName - Name for the new event track, or null
to omit this optional property.NullPointerException - One or both of the edit rate and/or segment
arguments is null.IllegalArgumentException - The track id is negative or the given segment
is not valid according to the conditional rules for event
track.TrackExistsException - A track with the given track id is already present
in this package.Package.appendPackageTrack(Track)public StaticTrackImpl appendNewStaticTrack(Segment segment, int trackID, String trackName) throws NullPointerException, IllegalArgumentException, TrackExistsException
PackageCreates and returns a new static track with the given property values, as well as appending it to the list of tracks of this package.
appendNewStaticTrack in interface Packagesegment - Segment to use to create a new static track.trackID - Track id to assign to the new static track.trackName - Name for the new static track, or null to omit
this optional property.NullPointerException - The given segment is null.IllegalArgumentException - The given track id is negative.TrackExistsException - A track with the given track id is already present
in this package.Package.appendPackageTrack(Track)public TimelineTrackImpl appendNewTimelineTrack(Rational editRate, Segment segment, @TrackID int trackID, String trackName, long origin) throws NullPointerException, IllegalArgumentException, TrackExistsException
PackageCreates and returns a new timeline track with the given property values, as well as appending it to this package.
appendNewTimelineTrack in interface PackageeditRate - Units of time for the new timeline track.segment - Value for the new timeline track.trackID - Integer to be used to refer to the track.trackName - Name of the new timeline track, or null to
omit this optional property.origin - Specifies the offset used to resolve source clip references to source material in the new timeline track, measured in
according to the edit rate of the new track. A
positive value means that the first sample of the essence is earlier than the zero
position. A negative value of origin means that the zero position is
earlier than the first sample of the essence.NullPointerException - One or more of the arguments is null.IllegalArgumentException - The given track id is negative.TrackExistsException - The given track id is already used to to identify a track
in this package.@MediaListAppend(value="PackageTracks") public void appendPackageTrack(Track track) throws NullPointerException, TrackExistsException
PackageAppends the given tracks to the list contained in this package. Note that the index of a package track in the list of package tracks is not the same as its track id.
appendPackageTrack in interface Packagetrack - Track to append to the list of tracks described by this package.NullPointerException - The given track is null.TrackExistsException - A track with the same track id as the given track
is already present in this package.@MediaPropertyCount(value="PackageTracks") public int countPackageTracks()
PackageReturns the number of tracks contained in this package.
countPackageTracks in interface Package@MediaListGetAt(value="PackageTracks") public Track getPackageTrackAt(int index) throws IndexOutOfBoundsException
PackageReturns the track at the given index through the list of tracks contained in this package.
getPackageTrackAt in interface Packageindex - Index of track to be returned.IndexOutOfBoundsException - Index is outside the acceptable range
for the list of tracks contained in this package.@MediaListInsertAt(value="PackageTracks") public void insertPackageTrackAt(int index, Track track) throws NullPointerException, IndexOutOfBoundsException, TrackExistsException
PackageInserts the given track into the list of tracks contained in this package at the given index. All existing tracks at the given and higher index will be moved up by one index to accommodate the new track. Note that the index of a track in the list of tracks is not the same as its track id.
insertPackageTrackAt in interface Packageindex - Index where the track is to be inserted.track - Track to be inserted into the list contained in this package.NullPointerException - The given track is null.IndexOutOfBoundsException - Index is outside the acceptable range
for the list of tracks contained in this package.TrackExistsException - A track with the same track id as the given track
is already present in this package.public Track lookupPackageTrack(int trackID) throws TrackNotFoundException
PackagelookupPackageTrack in interface PackagetrackID - The requested track id from the list of tracks of this package.TrackNotFoundException - A track with the given track id was not found in
this package.@MediaListPrepend(value="PackageTracks") public void prependPackageTrack(Track track) throws NullPointerException, TrackExistsException
PackagePrepends the given track to the list of tracks contained in this package. Note that the index of a package track in the list of tracks is not the same as its track id.
prependPackageTrack in interface Packagetrack - Track to prepend to the list of tracks described by this package.NullPointerException - The given track is null.TrackExistsException - A track with the same track id as the given track
is already present in this package.@MediaListRemoveAt(value="PackageTracks") public void removePackageTrackAt(int index) throws IndexOutOfBoundsException
PackageRemoves the track at the given index from the list of tracks contained in this package. All existing tracks at indices higher than the given index will be moved on one index to accommodate.
removePackageTrackAt in interface Packageindex - Index of the track to be removed from the list of tracks of this package.IndexOutOfBoundsException - Index is outside the acceptable range
for the list of tracks contained in this package.@MediaPropertyClear(value="PackageTracks") public void clearPackageTracks()
PackageClears the list of package tracks attached to this package.
clearPackageTracks in interface Package@MediaProperty(uuid1=117571856, uuid2=259, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="CreationTime", aliases={"CreateTime","CreationDate"}, typeName="TimeStamp", optional=false, uniqueIdentifier=false, pid=17413, symbol="CreationTime") public TimeStamp getCreationTime()
PackageReturns the creation time of this package, which is the date and time when this package was originally created.
getCreationTime in interface Package@MediaPropertySetter(value="CreationTime") public void setCreationTime(TimeStamp createTime) throws NullPointerException
PackageSets the creation time of this package, which is the date and time when this package was originally created. The creation time is initially set to the time that this package was created. Therefore, this method should only be called to explicitly to change the creation time.
setCreationTime in interface PackagecreateTime - The creation time for this package.NullPointerException - The given creation time is null.Forge.now(),
Forge.makeTimeStamp(java.util.Calendar)public static final TimeStamp initializeCreationTime()
@MediaProperty(uuid1=16848144, uuid2=0, uuid3=0, uuid4={6,14,43,52,1,1,1,1}, definedName="PackageID", aliases="MobID", typeName="PackageIDType", optional=false, uniqueIdentifier=true, pid=17409, symbol="PackageID") public PackageID getPackageID()
PackageReturns the unique (package identifier) for this package.
getPackageID in interface Package@MediaPropertySetter(value="PackageID") public void setPackageID(PackageID packageID) throws NullPointerException
PackageSets the unique (package identifier) for this package.
setPackageID in interface PackagepackageID - New package identifier to set for this package.NullPointerException - The given package identifier is null.Forge.makePackageID(byte[], byte, byte, byte, byte, AUID)public static final PackageID initializePackageID()
@MediaProperty(uuid1=117571856, uuid2=517, uuid3=0, uuid4={6,14,43,52,1,1,1,2}, definedName="PackageLastModified", aliases={"LastModified","MobLastModified","ModificationDate"}, typeName="TimeStamp", optional=false, uniqueIdentifier=false, pid=17412, symbol="PackageLastModified") public TimeStamp getPackageLastModified()
PackageReturns the modification time for this package, which is the date and time when this package was last modified.
getPackageLastModified in interface Package@MediaPropertySetter(value="PackageLastModified") public void setPackageLastModified(TimeStamp modTime) throws NullPointerException
PackageSets the modification time for this package, which is the date and time when this package was last modified. The modification time is initially set to the time that this package was created.
The MAJ API does not maintain the modification time every time that a package is updated. Therefore, this method should be called explicitly to change the modification time for this package.
setPackageLastModified in interface PackagemodTime - Modification time to set for this package.NullPointerException - The given modification time is null.Forge.now(),
Forge.makeTimeStamp(java.util.Calendar)public static final TimeStamp initializePackageLastModified()
@MediaProperty(uuid1=16974594, uuid2=256, uuid3=0, uuid4={6,14,43,52,1,1,1,1}, definedName="PackageName", aliases={"Name","MobName"}, typeName="UTF16String", optional=true, uniqueIdentifier=false, pid=17410, symbol="PackageName") public String getPackageName() throws PropertyNotPresentException
PackageReturns the name of this package, as displayed to the end user. This is an optional property.
getPackageName in interface PackagePropertyNotPresentException - The optional name property is not present in
this package.@MediaPropertySetter(value="PackageName") public void setPackageName(String packageName)
PackageSets the name of this package, as displayed to the end user. Set this optional
property to null to omit it.
setPackageName in interface PackagepackageName - Name of this package.@MediaProperty(uuid1=83951880, uuid2=0, uuid3=0, uuid4={6,14,43,52,1,1,1,7}, definedName="PackageUsage", aliases="UsageCode", typeName="UsageType", optional=true, uniqueIdentifier=false, pid=17416, symbol="PackageUsage") public AUID getPackageUsage() throws PropertyNotPresentException
PackageReturns the usage of this package. This is an optional property.
The built-in usage codes are specified in the AAF edit protocol.
getPackageUsage in interface PackagePropertyNotPresentException - The optional usage code property is not
present in this package.UsageType,
TypeDefinitions.UsageType@MediaPropertySetter(value="PackageUsage") public void setPackageUsage(AUID packageUsage)
PackageSets this package's usage.
Possible values include:
Set this optional property to null to omit it, which
is used to specify that a clip references only file, import, tape or
film sources.
The built-in usage codes are specified in the AAF edit protocol.
setPackageUsage in interface PackagepackageUsage - This package's usage code.UsageType,
TypeDefinitions.UsageTypepublic TimecodeValueImpl offsetToPackageTimecode(Segment tcSeg, long offset) throws NullPointerException, TimecodeNotFoundException
PackageCalculates the timecode at the given offset into the given timecode segment.
If the given timecode segment is null, the method will search for the track
containing a timecode segment in this package and will use that instead.
offsetToPackageTimecode in interface PackagetcSeg - Timecode segment to search for, or null to select
the one from this package.offset - Offset into the segment, expressed in edit unit's for the
associated track.NullPointerException - The given timecode segment is null.TimecodeNotFoundException - A timecode track was not found in this
package.public void changeReference(PackageID oldPackageID, PackageID newPackageID) throws NullPointerException
PackageFinds all source clips in this package that refer to the specified old package and changes the references to point to the newly specified package.
This method traverses through all the package reference chains of all of the tracks of this package looking for source clips. All source clips that have a source id property that matches the old package id, changes them to the new package id.
changeReference in interface PackageoldPackageID - Package id to match against the source id property of a source clip.newPackageID - If a match is found, change the package id of the source clip
to the given one.NullPointerException - One or both of the given package ids is/are null.SourceReferenceSegment.getSourcePackageID()public Package cloneExternal(Depend resolveDependencies, IncludedMedia includedMedia, AAFFile file)
PackageClones this package, and optionally all dependent packages, to a package that can be used in an external file, keeping the same package id.
The method clones the specified this package into a new destination package, with the same package id, in the given destination file. If the resolve dependencies flag is set to follow, the method also clones all packages referenced by this package.
If the include media flag is set, the method also copies the essence data associated with this package and returns the destination package, also cloning all private data. If the media data is not in the file, the function does not attempt to find it in another file and clone it. Both AAF files must be open before you call this function and both must have the same version number.
cloneExternal in interface PackageresolveDependencies - Sets whether the clone of this package also clones
all of its references.includedMedia - Sets whether any media data included with this package
should be copied into the clone or not.file - File in which to create the cloned package.public Package copy(String destMobName) throws NullPointerException
PackageCreates and returns a new copy of this package in the same AAF file. The method gives the returned new package a new package id and the given name. The method also copies all private data.
copy in interface PackagedestMobName - Name for the newly created, copied version of this package.NullPointerException - The given destination name for the new package is
null.public Package clone()
InterchangeObjectCreate a cloned copy of this interchange object.
clone in interface MediaEntityclone in interface InterchangeObjectclone in interface Packageclone in class InterchangeObjectImpl@MediaProperty(uuid1=-735822892, uuid2=322, uuid3=17813, uuid4={-88,-13,-14,-21,-91,66,68,-34}, definedName="ConvertFrameRate", typeName="Boolean", optional=true, uniqueIdentifier=false, pid=0, symbol="ConvertFrameRate", namespace="http://www.amwa.tv/is03/extensions/avid", prefix="avid") public boolean getConvertFrameRate() throws PropertyNotPresentException
PropertyNotPresentException@MediaPropertySetter(value="ConvertFrameRate") public void setConvertFrameRate(Boolean convertFrameRate)
@MediaProperty(uuid1=1620410755, uuid2=18353, uuid3=4564, uuid4={-96,28,0,4,-84,-106,-97,80}, definedName="MobAttributeList", typeName="TaggedValueStrongReferenceVector", optional=true, uniqueIdentifier=false, pid=0, symbol="MobAttributeList", namespace="http://www.amwa.tv/is03/extensions/avid", prefix="avid") public List<TaggedValue> getMobAttributeList() throws PropertyNotPresentException
PropertyNotPresentException@MediaListAppend(value="MobAttributeList") public void appendMobAttributeItem(TaggedValue mobAttributeItem) throws NullPointerException
NullPointerException@MediaListPrepend(value="MobAttributeList") public void prependMobAttributeItem(TaggedValue mobAttributeItem) throws NullPointerException
NullPointerException@MediaListInsertAt(value="MobAttributeList") public void insertMobAttributeItem(int index, TaggedValue mobAttributeItem) throws NullPointerException, IndexOutOfBoundsException
@MediaPropertyCount(value="MobAttributeList") public int countMobAttributeList()
@MediaPropertyClear(value="MobAttributeList") public void clearMobAttributeList()
@MediaListGetAt(value="MobAttributeList") public TaggedValue getMobAttributeItemAt(int index) throws IndexOutOfBoundsException
IndexOutOfBoundsException@MediaListRemoveAt(value="MobAttributeList") public void removeMobAttributeItemAt(int index) throws IndexOutOfBoundsException
IndexOutOfBoundsException@MediaProperty(uuid1=308461435, uuid2=-798, uuid3=19966, uuid4={-96,-10,-50,-20,4,124,-128,-86}, definedName="SubclipFullLength", typeName="Int64", optional=true, uniqueIdentifier=false, pid=0, symbol="SubclipFullLength1", namespace="http://www.amwa.tv/is03/extensions/avid", prefix="avid") @Int64 public long getSubclipFullLength() throws PropertyNotPresentException
PropertyNotPresentException@MediaPropertySetter(value="SubclipFullLength") public void setSubclipFullLength(@Int64 Long subclipFullLength)
@MediaProperty(uuid1=-1440434601, uuid2=-837, uuid3=18721, uuid4={-107,29,58,32,56,57,103,34}, definedName="SubclipBegin", typeName="Int64", optional=true, uniqueIdentifier=false, pid=0, symbol="SubclipBegin", namespace="http://www.amwa.tv/is03/extensions/avid", prefix="avid") @Int64 public long getSubclipBegin() throws PropertyNotPresentException
PropertyNotPresentException@MediaPropertySetter(value="SubclipBegin") public void setSubclipBegin(@Int64 Long subclipBegin)
public String getPackageUsageString()
public void setPackageUsageString(String packageUsage)
public String getPackageLastModifiedString()
public void setPackageLastModifiedString(String packageLastModified)
public String getCreationTimeString()
public void setCreationTimeString(String creationTime)
public String getPackageIDString()
public void setPackageIDString(String packageID)
public String getWeakTargetReference()
WeakReferenceTargetProvides a name that can be used to make a weak object reference to an instance of the implementing class.
getWeakTargetReference in interface WeakReferenceTargetpublic AUID getAUID()
Is this the right AUID?
getAUID in interface WeakReferenceTarget(c)2007-2016 Richard Cartwright, all rights reserved. Licensed under Apache 2 license and subject to the AMWA IPR policy.