Track

Object Hierarchy:

Description:

[ CCode ( type_id = "ges_track_get_type ()" ) ]
public class Track : Bin, MetaContainer, ChildProxy

A Track acts an output source for a Timeline .

Each one essentially provides an additional Pad for the timeline, with restriction_caps capabilities. Internally, a track wraps an nlecomposition filtered by a capsfilter.

A track will contain a number of TrackElement-s, and its role is to select and activate these elements according to their timings when the timeline in played. For example, a track would activate a Source when its start is reached by outputting its data for its duration. Similarly, a Operation would be activated by applying its effect to the source data, starting from its start time and lasting for its duration.

For most users, it will usually be sufficient to add newly created tracks to a timeline, but never directly add an element to a track. Whenever a Clip is added to a timeline, the clip adds its elements to the timeline's tracks and assumes responsibility for updating them.

All known sub-classes:

AudioTrack

VideoTrack

Namespace: GES

Package: gst-editing-services-1.0

Content:

Properties:

public Caps caps { get; construct; }
The capabilities used to choose the output of the Track 's elements.
public uint64 duration { get; }
Current duration of the track
public string id { owned get; set; }
The nlecomposition:id of the underlying nlecomposition.
public bool mixing { get; set construct; }
Whether the track should support the mixing of Layer data, such as composing the video data of each layer (when part of the video data is transparent, the next layer will become visible) or adding together the audio data.
public Caps restriction_caps { owned get; set; }
The capabilities that specifies the final output format of the Track.
public TrackType track_type { get; construct; }
The track type of the track.

Creation methods:

public Track (TrackType type, owned Caps caps)
Creates a new track with the given track-type and caps.

Methods:

public bool add_element (TrackElement object)
See add_element, which also gives an error.
public bool add_element_full (TrackElement object) throws Error
Adds the given track element to the track, which takes ownership of the element.
public bool commit ()
Commits all the pending changes for the elements contained in the track.
public unowned Caps? get_caps ()
Get the caps of the track.
public List<TrackElement> get_elements ()
Gets the track elements contained in the track.
public bool get_mixing ()
Gets the mixing of the track.
public Caps? get_restriction_caps ()
Gets the restriction_caps of the track.
public unowned Timeline? get_timeline ()
Get the timeline this track belongs to.
public bool remove_element (TrackElement object)
See remove_element_full, which also returns an error.
public bool remove_element_full (TrackElement object) throws Error
Removes the given track element from the track, which revokes ownership of the element.
public void set_mixing (bool mixing)
Sets the mixing for the track.
public void set_restriction_caps (Caps caps)
Sets the restriction_caps for the track.
public void set_timeline (Timeline timeline)
Informs the track that it belongs to the given timeline.
public void update_restriction_caps (Caps caps)
Updates the restriction_caps of the track using the fields found in the given caps.

Signals:

public signal void commited ()
This signal will be emitted once the changes initiated by commit have been executed in the backend.
public signal void track_element_added (TrackElement effect)
Will be emitted after a track element is added to the track.
public signal void track_element_removed (TrackElement effect)
Will be emitted after a track element is removed from the track.

Fields:

public TrackType type

Inherited Members:

All known members inherited from class Gst.Bin

All known members inherited from class Gst.Element

All known members inherited from class Gst.Object

All known members inherited from class GLib.Object

All known members inherited from interface GES.MetaContainer

All known members inherited from interface Gst.ChildProxy