ges: Add a ges_timeline_append_layer convenience method

API: ges_timeline_append_layer

diff --git a/docs/libs/ges-sections.txt b/docs/libs/ges-sections.txt
index 8269560..3b11320 100644 (file)
--- a/docs/libs/ges-sections.txt
+++ b/docs/libs/ges-sections.txt
@@ -236,6 +236,7 @@ ges_timeline_new
 ges_timeline_new_audio_video
 ges_timeline_new_from_uri
 ges_timeline_add_layer
+ges_timeline_append_layer
 ges_timeline_remove_layer
 ges_timeline_add_track
 ges_timeline_remove_track

diff --git a/ges/ges-timeline.c b/ges/ges-timeline.c
index eb8c9f7..d882108 100644 (file)
--- a/ges/ges-timeline.c
+++ b/ges/ges-timeline.c
@@ -697,6 +697,31 @@ layer_object_removed_cb (GESTimelineLayer * layer, GESTimelineObject * object,
 }
 
 /**
+ * ges_timeline_append_layer:
+ * @timeline: a #GESTimeline
+ * @layer: the #GESTimelineLayer to add
+ *
+ * Convenience method to append @layer to @timeline which means that the
+ * priority of @layer is changed to correspond to the last layer of @timeline.
+ * The reference to the @layer will be stolen by @timeline.
+ *
+ * Returns: TRUE if the layer was properly added, else FALSE.
+ */
+gboolean
+ges_timeline_append_layer (GESTimeline * timeline, GESTimelineLayer * layer)
+{
+  guint32 priority;
+  GESTimelinePrivate *priv = timeline->priv;
+
+  GST_DEBUG ("Appending layer to layer:%p, timeline:%p", timeline, layer);
+  priority = g_list_length (priv->layers);
+
+  ges_timeline_layer_set_priority (layer, priority);
+
+  return ges_timeline_add_layer (timeline, layer);
+}
+
+/**
  * ges_timeline_add_layer:
  * @timeline: a #GESTimeline
  * @layer: the #GESTimelineLayer to add

diff --git a/ges/ges-timeline.h b/ges/ges-timeline.h
index 376a4a0..101addd 100644 (file)
--- a/ges/ges-timeline.h
+++ b/ges/ges-timeline.h
@@ -89,6 +89,7 @@ gboolean ges_timeline_load_from_uri (GESTimeline *timeline, const gchar *uri);
 gboolean ges_timeline_save_to_uri (GESTimeline *timeline, const gchar *uri);
 
 gboolean ges_timeline_add_layer (GESTimeline *timeline, GESTimelineLayer *layer);
+gboolean ges_timeline_append_layer (GESTimeline * timeline, GESTimelineLayer * layer);
 gboolean ges_timeline_remove_layer (GESTimeline *timeline, GESTimelineLayer *layer);
 GList* ges_timeline_get_layers (GESTimeline *timeline);