edit_full
Description:
public bool edit_full (int64 new_layer_priority, EditMode mode, Edge edge, uint64 position) throws Error
Edits the element within its timeline by adjusting its start, duration or in_point, and potentially doing the same for other elements in the timeline.
See EditMode for details about each edit mode. An edit may fail if it would place one of these properties out of bounds, or if it would place the timeline in an unsupported configuration.
Note that if you act on a TrackElement, this will edit its
parent Clip instead. Moreover, for any
TimelineElement, if you select
NONE for
NORMAL or
RIPPLE, this will edit the toplevel instead, but still in
such a way as to make the start of
this reach the edit position.
Note that if the element's timeline has a snapping_distance set, then the edit position may be snapped to the edge of some element under the edited element.
new_layer_priority can be used to switch this, and other elements moved by the edit, to a new
layer. New layers may be be created if the the corresponding layer priority/index does not yet exist for the timeline.
Parameters:
| this |
The TimelineElement to edit |
| new_layer_priority |
The priority/index of the layer this should be moved to. -1 means no move |
| mode |
The edit mode |
| edge |
The edge of this where the edit should occur |
| position |
The edit position: a new location for the edge of this (in nanoseconds) in the timeline coordinates |
Returns:
|
true if the edit of this completed, false on failure. |