Delay Object

Document created by DPM Admin Employee on Jul 21, 2017
Version 1Show Document
  • View in full screen mode

Represents a Delay within the Composition.

Delay Properties

  • name (string)

The name of this item.

An item’s name can be changed by setting this property, with the following restrictions:

The name can only be changed before any activity has occurred for this item. It cannot have been started playing yet, cannot have started repeating yet, no other actions for it can have occurred yet (no other properties of it can have been set).

The name must be a legal item name (255 chars max, no square brackets or slashes), and must not be the same name as another item in the same container.

  • parent (read only – object)

The parent object of this item.

  • propertyList (read only – object)

A PropertyList object that allows access to all of the Custom Properties contained in this object.

  • systemPropertyList (read only – object)

A SystemPropertyList object that allows access to all of the System Properties contained in this object.

  • type (read only – string)

The string “Delay”.

  • children (array of objects)

An array of objects representing the children of this object, if any. Null if the object has no children.

  • index (read only – integer)

Returns the position (zero-based index) of this item’s parent’s array of children.

  • nextItem (read only – object)

Returns the next item after this one in this item’s parent’s array of children, or null of this is the last item. In other words, returns the next sibling in the object hierarchy. Equivalent to:

 

item.parent.children(item.index + 1)

where item is the current item.

  • previousItem (read only – object)

Returns the previous item before this one in this item’s parent’s array of children, or null of this is the first item. In other words, returns the next sibling in the object hierarchy. . Equivalent to:

item.parent.children(item.index - 1)

where item is the current item.

  • forEachValue (read only – string, number, date/time, or null)

If this item is repeating due to a “for-each” repeat, this property contains the for-each value associated with this instance of the object. This will be a value in the array used for the for-each.

If this item is not repeating due to a “for-each” repeat, this property will be null.

  • repeatIndex (read only – integer)

Always -1 for a Delay.

  • playNumber (read only – integer)

Always 0 for a Delay.

  • playNumberBeforeRenewal (read only – integer)

If this item repeats in parallel with the “Renew parallel repeats” option enabled, this is an integer value that is the “playNumber” value of the original parallel repeat for this item if it has been renewed because a prior parallel repeat ended. If this is the original parallel repeat, the value of playNumberBeforeRenewal will be equal to the value of playNumber. If this item does not repeat in parallel, the value will be zero.

For example, if parallel repeat number 5 of the item ends, but the Renew parallel repeats checkbox is enabled, the ending repeat will be replaced with a new, replacement repeat. The new repeat will have new repeatIndex and playNumber values (according to how many other repeats have already occurred). However, the playNumberBeforeRenewal value will still be 5 in this example.

This property is always 0 for Composition, Checkpoint, Delay, and Target.

  • REPEAT_TIMING_PARALLEL (read only – integer)

A constant that can be passed in calls to the “setRepeat” method. (See the description of the “setRepeat” method.)

  • REPEAT_TIMING_SERIAL (read only – integer)

A constant that can be passed in calls to the “setRepeat” method. (See the description of the “setRepeat” method.)

  • REPEAT_TYPE_COUNT_CONSTANT (read only – integer)

A constant that can be passed in calls to the “setRepeat” method. (See the description of the “setRepeat” method.)

  • REPEAT_DISTRIBUTION_CONSTANT (read only – integer)

A constant that can be passed in calls to the “setRepeat” method. (See the description of the “setRepeat” method.)

 

Delay Methods

 

 

getChild Method

Returns a specific child object by name, or null if there is no child with the specified name.

object getChild(string childName)

getItemViaPath Method

Given a path to an item in the Composition object hierarchy, returns the object in the hierarchy that represents that item.

The “pathType” parameter value specifies the “starting point” of the path, relative to this Delay. For Delays it can be any of the following values (case is not significant):

  • “Composition”

The path is relative to the Composition as a whole.  (Therefore, the path must start with the name of a Band.)

  • “Band”

The path is relative to this Delay’s parent Band.

  • “Track”

The path is relative this Delay’s parent Track.

  • “MessageClip” or “Clip” (either one is accepted)

The path is relative this Delay’s parent Clip.

  • “Chain”

The path is relative to this Delay’s parent Chain.

  • “Group”

The path is relative to this Delay’s parent Group.

  • “Delay”

The path is relative to this Delay.
The “propertyPath” parameter contains a property path as specified for “In Situ Substitution Specifications” (see the separate document on ISSEs).

object getItemViaPath(string pathType, string path)

clearRepeat Method

Removes any current repeating specification from this item (so that it will play exactly once).

void clearRepeat()

setRepeat Method

Sets a new repeating specification for this item.

The “timingType” parameter indicates which type of repeat timing is to be used.  It must be one of the following values:

  • REPEAT_TIMING_PARALLEL
  • REPEAT_TIMING_SERIAL

The “repeatType” parameter indicates what sort of value is contained in the “control” parameter.  Currently the “repeatType” parameter must always be set to “REPEAT_TYPE_COUNT_CONSTANT”.

The “control” parameter is the count of the number of repeats to be performed.  If the value is less than or equal to zero, the item will not be played at all.

The “distributionType” parameter indicates what sort of value is contained in the “distribution” parameter.  Currently the “distributionType” parameter must always be set to “REPEAT_DISTRIBUTION_CONSTANT”.

The “distribution” parameter is a time length, in milliseconds, by which the start of each repeat is to be offset from the start of the prior repeat.  This value only applies to parallel repeats, and must be set to zero for serial repeats.

Attachments

    Outcomes