[ Version ( since = "1.18" ) ]
public unowned TrackElement add_child_to_track (TrackElement child, Track track) throws Error
Adds the track element child of the clip to a specific track.
If the given child is already in another track, this will create a copy of the child, add it to the clip, and add this copy to the track.
You should only call this whilst a clip is part of a Timeline, and for tracks that are in the same timeline.
This method is an alternative to using the select_tracks_for_object signal, but can be used to complement it when, say, you wish to copy a clip's children from one track into a new one.
When the child is a core child, it must be added to a track that does not already contain another core child of the same clip. If it is not a core child (an additional effect), then it must be added to a track that already contains one of the core children of the same clip.
This method can also fail if the adding the track element to the track would break a configuration rule of the corresponding Timeline, such as causing three sources to overlap at a single time, or causing a source to completely overlap another in the same track.
| this |
A Clip |
| child |
A child of this |
| track |
The track to add |
|
The element that was added to |