find_track_elements
Description:
Finds the TrackElement-s controlled by the clip that match the given criteria.
If track
is given as null and track_type
is given as
UNKNOWN, then the search will match all elements in any
track, including those with no track, and of any
track_type. Otherwise, if track
is not null, but track_type
is
UNKNOWN, then only the track elements in track
are searched for. Otherwise, if track_type
is not
UNKNOWN, but track
is
null, then only the track elements whose
track_type matches track_type
are
searched for. Otherwise, when both are given, the track elements that match **either** criteria are searched for. Therefore, if you wish to only
find elements in a specific track, you should give the track as track
, but you should not give the track's
track_type as track_type
because this would also
select elements from other tracks of the same type.
You may also give type
to _further_ restrict the search to track elements of the given type
.
Parameters:
this |
A Clip |
track |
The track to search in, or null to search in all tracks |
track_type |
The track-type of the track element to search for, or UNKNOWN to match any track type |
type |
The type of track element to search for, or g_type_none to match any type |
Returns:
A list of all the TrackElement-s controlled by
this, in |