- class GES.Group(**kwargs)¶
GES.Groupcontrols one or more
GES.Clip-s, but it can also control other
GES.Group-s). Its children must share the same
GES.Timeline, but can otherwise lie in separate
GES.Layer-s and have different timings.
A group will maintain the relative
:starttimes of its children, as well as their relative layer
:priority. Therefore, if one of its children has its
:startset, all other children will have their
:startshifted by the same amount. Similarly, if one of its children moves to a new layer, the other children will also change layers to maintain the difference in their layer priorities. For example, if a child moves from a layer with
:priority1 to a layer with priority 3, then another child that was in a layer with priority 0 will move to the layer with priority 2.
:startof a group refers to the earliest start time of its children. If the group’s
:startis set, all the children will be shifted equally such that the earliest start time will match the set value. The
:durationof a group is the difference between the earliest start time and latest end time of its children. If the group’s
:durationis increased, the children whose end time matches the end of the group will be extended accordingly. If it is decreased, then any child whose end time exceeds the new end time will also have their duration decreased accordingly.
A group may span several layers, but for methods such as
GES.TimelineElement.edit() a group is considered to have a layer priority that is the highest
:priority(numerically, the smallest) of all the layers it spans.