Added Track object

Minor updates, throughout.

5 - Sequence object/sequence.rst

@@ -201,6 +201,7 @@ Set the starting time of the sequence.
 **Parameters**
 
 An integer, specifying the new zero point, in Ticks.
+
 **Type**
 
 Integer; read-only.

6 - Track object/track.rst

@@ -0,0 +1,194 @@
+.. highlight:: javascript
+
+.. _track:
+
+Track object
+===================
+
+``Track``
+
+**Description**
+
+The **Track** object represents a video or audio track, within a sequence.
+
+----
+
+==========
+Attributes
+==========
+
+.. _track.name:
+
+name
+*********************************************
+
+``track.name``
+
+**Description**
+
+The name of the track.
+
+**Type**
+
+String; read-only.
+
+
+----
+
+.. _track.id:
+
+id
+*********************************************
+
+``track.id``
+
+**Description**
+
+This is the ordinal assigned to the track, upon creation.
+
+**Type**
+
+Integer, read-only.
+
+----
+
+.. _track.mediaType:
+
+mediaType
+*********************************************
+
+``track.mediaType``
+
+**Description**
+
+The type of media, contained in this track. 
+
+**Type**
+
+String, read-only; valid values are ``Audio`` and ``Video``.
+
+
+----
+
+.. _track.clips:
+
+clips
+*********************************************
+
+``track.clips``
+
+**Description**
+
+An array of clip objects, contained within the track, in temporal order.
+
+**Type**
+
+Array; read-only.
+
+----
+
+.. _track.transitions:
+
+transitions
+*********************************************
+
+``track.transitions``
+
+**Description**
+
+An array of transitions objects, contained within the track, in temporal order.
+
+**Type**
+
+Array; read-only.
+
+
+
+
+=======
+Methods
+=======
+
+
+.. _track.isMuted:
+
+isMuted()
+*********************************************
+
+``track.isMuted()``
+
+**Description**
+
+Retrieves the current mute state, of the track.
+
+**Parameters**
+
+None.
+
+**Returns**
+
+Returns **true** if track is currently muted; **false** if not.
+
+----
+
+
+.. _track.setMute:
+
+setMute()
+*********************************************
+
+``track.setMute(isMuted)``
+
+**Description**
+
+Sets the mute state, of the track.
+
+**Parameters**
+
+Integer; if **1**, mute the track. If ``isMuted`` is **0**, the track will be unmuted.
+
+**Returns**
+
+Returns 0 if successful.
+
+----
+
+.. _track.insertClip:
+
+insertClip()
+*********************************************
+
+``track.insertClip(srcProjectItem, time)``
+
+**Description**
+
+Adds a 'clip' (media segment from a projectItem) to the track, at the specified time. Media will be inserted, at that time.
+
+**Parameters**
+
+A ``projectItem`` from which to get media, and the time at which to add it, in Ticks.
+
+**Returns**
+
+Returns 0 if successful.
+
+----
+
+.. _track.overwriteClip:
+
+overwriteClip()
+*********************************************
+
+``track.overwriteClip(srcProjectItem, time)``
+
+**Description**
+
+Adds a 'clip' (media segment from a projectItem) to the track, at the specified time. This will overwrite any existing media, at that time.
+
+**Parameters**
+
+A ``projectItem`` from which to get media, and the time at which to add it, in Ticks.
+
+**Returns**
+
+Returns 0 if successful.

index.rst

@@ -33,3 +33,9 @@ Welcome to the Premiere Scripting Guide!
     :caption: Chapter 5 - Sequence object
 
     5 - Sequence object/sequence
+
+.. toctree::
+    :maxdepth: 2
+    :caption: Chapter 6 - Track object
+
+    6 - Track object/track