TrackElement

Object Hierarchy:

Description:

[ CCode ( type_id = "ges_track_element_get_type ()" ) ]
public abstract class TrackElement : TimelineElement, Extractable, MetaContainer

A TrackElement is a TimelineElement that specifically belongs to a single Track of its timeline.

Its start and duration specify its temporal extent in the track. Specifically, a track element wraps some nleobject, such as an nlesource or nleoperation, which can be retrieved with get_nleobject, and its start, duration, in_point, priority and active properties expose the corresponding nleobject properties. When a track element is added to a track, its nleobject is added to the corresponding nlecomposition that the track wraps.

Most users will not have to work directly with track elements since a Clip will automatically create track elements for its timeline's tracks and take responsibility for updating them. The only track elements that are not automatically created by clips, but a user is likely to want to create, are Effect-s.

Control Bindings for Children Properties

You can set up control bindings for a track element child property using set_control_source. A GstTimedValueControlSource should specify the timed values using the internal source coordinates (see TimelineElement). By default, these will be updated to lie between the in_point and out-point of the element. This can be switched off by setting auto_clamp_control_sources to false.

All known sub-classes:

Namespace: GES

Package: gst-editing-services-1.0

Content:

Properties:

public bool active { get; set; }
Whether the effect of the element should be applied in its track.
public bool auto_clamp_control_sources { get; set; }
Whether the control sources on the element (see set_control_source) will be automatically updated whenever the in_point or out-point of the element change in value.
public bool has_internal_source { get; set; }
This property is used to determine whether the 'internal time' properties of the element have any meaning.
public Track track { get; }
The track that this element belongs to, or null if it does not belong to a track.
public TrackType track_type { get; set construct; }
The track type of the element, which determines the type of track the element can be added to (see track_type).

Creation methods:

protected TrackElement ()

Methods:

public virtual void active_changed (bool active)
Notify when the active property changes
public void add_children_props (Element element, string[]? wanted_categories, string[]? blacklist, string[]? whitelist)
Adds all the properties of a Element that match the criteria as children properties of the track element.
public virtual void changed ()
public void clamp_control_source (string property_name)
Clamp the GstTimedValueControlSource for the specified child property to lie between the in_point and out-point of the element.
public virtual unowned Element create_element ()
public virtual unowned Element create_gnl_object ()
public bool edit (List<Layer>? layers, EditMode mode, Edge edge, uint64 position)
Edits the element within its track.
public unowned HashTable<string,ControlBinding> get_all_control_bindings ()
Get all the control bindings that have been created for the children properties of the track element using set_control_source.
public bool get_auto_clamp_control_sources ()
Gets auto_clamp_control_sources.
public unowned ControlBinding? get_control_binding (string property_name)
Gets the control binding that was created for the specified child property of the track element using set_control_source .
public unowned Element? get_element ()
Get the Element that the track element's underlying nleobject controls.
public unowned Element get_gnlobject ()
Get the GNonLin object this object is controlling.
public unowned Element get_nleobject ()
Get the nleobject that this element wraps.
public unowned Track? get_track ()
Get the track for the element.
public TrackType get_track_type ()
Gets the track_type for the element.
public bool is_active ()
Gets active for the element.
public bool is_core ()
Get whether the given track element is a core track element.
public ParamSpec[] list_children_properties ()
Gets an array of ParamSpec* for all configurable properties of the children of this.
public virtual bool lookup_child (string prop_name, out Element element, out ParamSpec pspec)
Looks up which element and pspec would be effected by the given name.
public bool remove_control_binding (string property_name)
Removes the ControlBinding that was created for the specified child property of the track element using set_control_source .
public bool set_active (bool active)
Sets active for the element.
public void set_auto_clamp_control_sources (bool auto_clamp)
Sets auto_clamp_control_sources.
public bool set_control_source (ControlSource source, string property_name, string binding_type)
Creates a ControlBinding for the specified child property of the track element using the given control source.
public bool set_has_internal_source (bool has_internal_source)
Sets has_internal_source for the element.
public void set_track_type (TrackType type)
Sets the track_type for the element.

Signals:

public signal void control_binding_added (ControlBinding control_binding)
This is emitted when a control binding is added to a child property of the track element.
public signal void control_binding_removed (ControlBinding control_binding)
This is emitted when a control binding is removed from a child property of the track element.

Inherited Members:

All known members inherited from class GES.TimelineElement

All known members inherited from class GLib.Object

All known members inherited from interface GES.Extractable

set_asset

set_asset_full

All known members inherited from interface GES.MetaContainer