add_top_effect

Description:

[ Version ( since = "1.18" ) ]
public bool add_top_effect (BaseEffect effect, int index) throws Error

Add a top effect to a clip at the given index.

Unlike using add, this allows you to set the index in advance. It will also check that no error occurred during the track selection for the effect.

Note, only subclasses of Clip that have GES_CLIP_CLASS_CAN_ADD_EFFECTS set to true (such as SourceClip and BaseEffectClip) can have additional top effects added.

Note, if the effect is a time effect, this may be refused if the clip would not be able to adapt itself once the effect is added.

Parameters:

this	A Clip
effect	A top effect to add
index	The index to add `effect` at, or -1 to add at the highest

Returns:

true if effect was successfully added to this at index.