edit_full

Description:

[ Version ( since = "1.18" ) ]
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.