gstreamer/ges/ges-layer.c

883 lines
26 KiB
C
Raw Normal View History

2009-08-04 15:13:11 +00:00
/* GStreamer Editing Services
2009-11-30 14:14:25 +00:00
* Copyright (C) 2009 Edward Hervey <edward.hervey@collabora.co.uk>
* 2009 Nokia Corporation
2011-12-22 20:21:37 +00:00
* 2011 Mathieu Duponchelle <mathieu.duponchelle@epitech.eu>
* 2013 Thibault Saunier <thibault.saunier@collabora.com>
2009-08-04 15:13:11 +00:00
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
2012-11-04 00:25:20 +00:00
* Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
2009-08-04 15:13:11 +00:00
*/
/**
* SECTION:geslayer
* @title: GESLayer
2019-12-18 20:33:45 +00:00
* @short_description: Non-overlapping sequence of #GESClip
*
* #GESLayer-s are responsible for collecting and ordering #GESClip-s.
*
* A layer within a timeline will have an associated priority,
* corresponding to their index within the timeline. A layer with the
* index/priority 0 will have the highest priority and the layer with the
* largest index will have the lowest priority (the order of priorities,
* in this sense, is the _reverse_ of the numerical ordering of the
* indices). ges_timeline_move_layer() should be used if you wish to
* change how layers are prioritised in a timeline.
*
* Layers with higher priorities will have their content priorities
* over content from lower priority layers, similar to how layers are
* used in image editing. For example, if two separate layers both
* display video content, then the layer with the higher priority will
* have its images shown first. The other layer will only have its image
* shown if the higher priority layer has no content at the given
* playtime, or is transparent in some way. Audio content in separate
* layers will simply play in addition.
2009-08-04 15:13:11 +00:00
*/
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
2009-08-04 15:13:11 +00:00
#include "ges-internal.h"
2013-04-23 23:04:04 +00:00
#include "ges-layer.h"
#include "ges.h"
#include "ges-source-clip.h"
static void ges_meta_container_interface_init
(GESMetaContainerInterface * iface);
2013-04-23 23:04:04 +00:00
struct _GESLayerPrivate
2010-12-04 18:54:13 +00:00
{
/*< private > */
GList *clips_start; /* The Clips sorted by start and
* priority */
2012-04-08 01:24:18 +00:00
guint32 priority; /* The priority of the layer within the
* containing timeline */
gboolean auto_transition;
2010-12-04 18:54:13 +00:00
};
typedef struct
{
GESClip *clip;
2013-04-23 23:04:04 +00:00
GESLayer *layer;
} NewAssetUData;
enum
{
PROP_0,
PROP_PRIORITY,
PROP_AUTO_TRANSITION,
PROP_LAST
};
enum
{
OBJECT_ADDED,
OBJECT_REMOVED,
LAST_SIGNAL
};
2013-04-23 23:04:04 +00:00
static guint ges_layer_signals[LAST_SIGNAL] = { 0 };
G_DEFINE_TYPE_WITH_CODE (GESLayer, ges_layer,
2019-08-17 15:59:02 +00:00
G_TYPE_INITIALLY_UNOWNED, G_ADD_PRIVATE (GESLayer)
G_IMPLEMENT_INTERFACE (GES_TYPE_EXTRACTABLE, NULL)
G_IMPLEMENT_INTERFACE (GES_TYPE_META_CONTAINER,
ges_meta_container_interface_init));
2012-04-08 01:24:18 +00:00
/* GObject standard vmethods */
static void
2013-04-23 23:04:04 +00:00
ges_layer_get_property (GObject * object, guint property_id,
2009-08-04 15:16:31 +00:00
GValue * value, GParamSpec * pspec)
2009-08-04 15:13:11 +00:00
{
2013-04-23 23:04:04 +00:00
GESLayer *layer = GES_LAYER (object);
2009-08-04 15:13:11 +00:00
switch (property_id) {
case PROP_PRIORITY:
g_value_set_uint (value, layer->priv->priority);
break;
case PROP_AUTO_TRANSITION:
g_value_set_boolean (value, layer->priv->auto_transition);
break;
2009-08-04 15:16:31 +00:00
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
2009-08-04 15:13:11 +00:00
}
}
static void
2013-04-23 23:04:04 +00:00
ges_layer_set_property (GObject * object, guint property_id,
2009-08-04 15:16:31 +00:00
const GValue * value, GParamSpec * pspec)
2009-08-04 15:13:11 +00:00
{
2013-04-23 23:04:04 +00:00
GESLayer *layer = GES_LAYER (object);
2009-08-04 15:13:11 +00:00
switch (property_id) {
case PROP_PRIORITY:
GST_FIXME ("Deprecated, use ges_timeline_move_layer instead");
layer_set_priority (layer, g_value_get_uint (value), FALSE);
break;
case PROP_AUTO_TRANSITION:
2013-04-23 23:04:04 +00:00
ges_layer_set_auto_transition (layer, g_value_get_boolean (value));
break;
2009-08-04 15:16:31 +00:00
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);
2009-08-04 15:13:11 +00:00
}
}
static void
2013-04-23 23:04:04 +00:00
ges_layer_dispose (GObject * object)
2009-08-04 15:13:11 +00:00
{
2013-04-23 23:04:04 +00:00
GESLayer *layer = GES_LAYER (object);
GESLayerPrivate *priv = layer->priv;
GST_DEBUG ("Disposing layer");
while (priv->clips_start)
2013-04-23 23:04:04 +00:00
ges_layer_remove_clip (layer, (GESClip *) priv->clips_start->data);
2013-04-23 23:04:04 +00:00
G_OBJECT_CLASS (ges_layer_parent_class)->dispose (object);
2009-08-04 15:13:11 +00:00
}
static gboolean
_register_metas (GESLayer * layer)
{
ges_meta_container_register_meta_float (GES_META_CONTAINER (layer),
GES_META_READ_WRITE, GES_META_VOLUME, 1.0);
return TRUE;
}
static void
ges_meta_container_interface_init (GESMetaContainerInterface * iface)
{
}
2009-08-04 15:13:11 +00:00
static void
2013-04-23 23:04:04 +00:00
ges_layer_class_init (GESLayerClass * klass)
2009-08-04 15:13:11 +00:00
{
GObjectClass *object_class = G_OBJECT_CLASS (klass);
2013-04-23 23:04:04 +00:00
object_class->get_property = ges_layer_get_property;
object_class->set_property = ges_layer_set_property;
object_class->dispose = ges_layer_dispose;
/**
2013-04-23 23:04:04 +00:00
* GESLayer:priority:
*
* The priority of the layer in the #GESTimeline. 0 is the highest
2019-12-18 20:33:45 +00:00
* priority. Conceptually, a timeline is a stack of layers,
2010-05-31 16:59:12 +00:00
* and the priority of the layer represents its position in the stack. Two
* layers should not have the same priority within a given GESTimeline.
2015-05-19 16:18:30 +00:00
*
2019-12-18 20:33:45 +00:00
* Note that the timeline needs to be committed (with #ges_timeline_commit)
2015-05-19 16:18:30 +00:00
* for the change to be taken into account.
*
* Deprecated:1.16.0: use #ges_timeline_move_layer instead. This deprecation means
* that you will not need to handle layer priorities at all yourself, GES
* will make sure there is never 'gaps' between layer priorities.
*/
g_object_class_install_property (object_class, PROP_PRIORITY,
g_param_spec_uint ("priority", "Priority",
"The priority of the layer", 0, G_MAXUINT, 0, G_PARAM_READWRITE));
/**
2013-04-23 23:04:04 +00:00
* GESLayer:auto-transition:
*
2019-12-18 20:33:45 +00:00
* Whether to automatically create a #GESTransitionClip whenever two
* #GESClip-s overlap in the layer. Specifically, if this is set to
* %TRUE, then wherever two #GESSource-s (that belong to some clip in
* the layer) share the same #GESTrackElement:track and the end time of
* one source exceeds the #GESTimelineElement:start time of the other,
* there will exist a corresponding #GESTransitionClip in the same
* layer. These automatic transitions will be created and removed
* accordingly. Their temporal extent will cover the overlap of the
* two sources (their #GESTimelineElement:start will be set to the
* #GESTimelineElement:start of the later source, and their
* #GESTimelineElement:duration will be the difference between the
* #GESTimelineElement:start of the later source, and the end time of
* the earlier source).
*
* It may be difficult to use this feature if your timeline has multiple
* tracks of the same #GESTrack:track-type and you use the
* #GESTimeline::select-tracks-for-object signal. You will have to
* ensure that any #GESTransition that belongs to a newly created
* transition clip is able to arrive in the correct track.
*
* When a layer is added to a #GESTimeline, if this property is left as
* %FALSE, but the timeline's #GESTimeline:auto-transition is %TRUE, it
* will be set to %TRUE as well.
*/
g_object_class_install_property (object_class, PROP_AUTO_TRANSITION,
g_param_spec_boolean ("auto-transition", "Auto-Transition",
"whether the transitions are added", FALSE, G_PARAM_READWRITE));
2009-09-16 10:37:45 +00:00
/**
2013-04-23 23:04:04 +00:00
* GESLayer::clip-added:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @clip: The clip that was added
2009-09-16 10:37:45 +00:00
*
2019-12-18 20:33:45 +00:00
* Will be emitted after the clip is added to the layer.
2009-09-16 10:37:45 +00:00
*/
2013-04-23 23:04:04 +00:00
ges_layer_signals[OBJECT_ADDED] =
g_signal_new ("clip-added", G_TYPE_FROM_CLASS (klass),
2013-04-23 23:04:04 +00:00
G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GESLayerClass, object_added),
NULL, NULL, NULL, G_TYPE_NONE, 1, GES_TYPE_CLIP);
2009-09-16 10:37:45 +00:00
/**
2013-04-23 23:04:04 +00:00
* GESLayer::clip-removed:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @clip: The clip that was removed
2009-09-16 10:37:45 +00:00
*
2019-12-18 20:33:45 +00:00
* Will be emitted after the clip is removed from the layer.
2009-09-16 10:37:45 +00:00
*/
2013-04-23 23:04:04 +00:00
ges_layer_signals[OBJECT_REMOVED] =
g_signal_new ("clip-removed", G_TYPE_FROM_CLASS (klass),
2013-04-23 23:04:04 +00:00
G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GESLayerClass,
object_removed), NULL, NULL, NULL, G_TYPE_NONE, 1, GES_TYPE_CLIP);
2009-08-04 15:13:11 +00:00
}
static void
2013-04-23 23:04:04 +00:00
ges_layer_init (GESLayer * self)
2009-08-04 15:13:11 +00:00
{
self->priv = ges_layer_get_instance_private (self);
2010-12-04 18:54:13 +00:00
self->priv->priority = 0;
self->priv->auto_transition = FALSE;
Cleanup import of GNL and rename gnl to nle for Non Linear Engine Conflicts: ges/ges-track-element.c gnl/Makefile.am gnl/common Conflicts: ges/ges-internal.h ges/ges-track.c ges/ges-utils.c ges/nle/.gitignore ges/nle/gnlmarshal.list ges/nle/nle.h ges/nle/nlecomposition.c ges/nle/nlecomposition.h ges/nle/nleghostpad.c ges/nle/nleghostpad.h ges/nle/nleobject.c ges/nle/nleoperation.c ges/nle/nleoperation.h ges/nle/nlesource.c ges/nle/nlesource.h ges/nle/nletypes.h ges/nle/nleurisource.c ges/nle/nleurisource.h gnl/Makefile.am gnl/gnl.c gnl/gnl.h gnl/gnl/gnl.h gnl/gnl/gnlcomposition.c gnl/gnl/gnlcomposition.h gnl/gnl/gnlghostpad.c gnl/gnl/gnlghostpad.h gnl/gnl/gnlmarshal.list gnl/gnl/gnlobject.c gnl/gnl/gnloperation.c gnl/gnl/gnloperation.h gnl/gnl/gnlsource.c gnl/gnl/gnlsource.h gnl/gnl/gnltypes.h gnl/gnl/gnlurisource.c gnl/gnl/gnlurisource.h gnl/gnlcomposition.c gnl/gnlcomposition.h gnl/gnlghostpad.c gnl/gnlghostpad.h gnl/gnlmarshal.list gnl/gnlobject.c gnl/gnlobject.h gnl/gnloperation.c gnl/gnloperation.h gnl/gnlsource.c gnl/gnlsource.h gnl/gnltypes.h gnl/gnlurisource.c gnl/gnlurisource.h gnl/tests/check/gnl/common.c gnl/tests/check/gnl/common.h gnl/tests/check/gnl/complex.c gnl/tests/check/gnl/gnlcomposition.c gnl/tests/check/gnl/gnloperation.c gnl/tests/check/gnl/gnlsource.c gnl/tests/check/gnl/seek.c gnl/tests/check/gnl/simple.c tests/check/gnl/common.c tests/check/gnl/common.h tests/check/gnl/complex.c tests/check/gnl/gnlcomposition.c tests/check/gnl/gnloperation.c tests/check/gnl/gnlsource.c tests/check/gnl/seek.c tests/check/gnl/simple.c tests/check/nle/common.c tests/check/nle/common.h tests/check/nle/complex.c tests/check/nle/nlecomposition.c tests/check/nle/nleoperation.c tests/check/nle/nlesource.c tests/check/nle/seek.c tests/check/nle/simple.c
2014-08-15 13:48:14 +00:00
self->min_nle_priority = MIN_NLE_PRIO;
self->max_nle_priority = LAYER_HEIGHT + MIN_NLE_PRIO;
_register_metas (self);
}
static gint
ges_layer_resync_priorities_by_type (GESLayer * layer,
gint starting_priority, GType type)
2012-04-08 01:24:18 +00:00
{
GstClockTime next_reset = 0;
gint priority = starting_priority, max_priority = priority;
2012-04-08 01:24:18 +00:00
GList *tmp;
GESTimelineElement *element;
layer->priv->clips_start =
g_list_sort (layer->priv->clips_start,
(GCompareFunc) element_start_compare);
for (tmp = layer->priv->clips_start; tmp; tmp = tmp->next) {
element = GES_TIMELINE_ELEMENT (tmp->data);
if (GES_IS_TRANSITION_CLIP (element)) {
/* Blindly set transitions priorities to 0 */
_set_priority0 (element, 0);
continue;
} else if (!g_type_is_a (G_OBJECT_TYPE (element), type))
continue;
if (element->start > next_reset) {
priority = starting_priority;
next_reset = 0;
}
if (element->start + element->duration > next_reset)
next_reset = element->start + element->duration;
_set_priority0 (element, priority);
priority = priority + GES_CONTAINER_HEIGHT (element);
if (priority > max_priority)
max_priority = priority;
}
return max_priority;
}
/**
* ges_layer_resync_priorities:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
*
* Resyncs the priorities of the clips controlled by @layer.
*/
gboolean
ges_layer_resync_priorities (GESLayer * layer)
{
gint min_source_prios;
g_return_val_if_fail (GES_IS_LAYER (layer), FALSE);
GST_INFO_OBJECT (layer, "Resync priorities (prio: %d)",
layer->priv->priority);
min_source_prios = ges_layer_resync_priorities_by_type (layer, 1,
GES_TYPE_OPERATION_CLIP);
ges_layer_resync_priorities_by_type (layer, min_source_prios,
GES_TYPE_SOURCE_CLIP);
2012-04-08 01:24:18 +00:00
return TRUE;
}
void
layer_set_priority (GESLayer * layer, guint priority, gboolean emit)
{
GST_DEBUG ("layer:%p, priority:%d", layer, priority);
if (priority != layer->priv->priority) {
layer->priv->priority = priority;
layer->min_nle_priority = (priority * LAYER_HEIGHT) + MIN_NLE_PRIO;
layer->max_nle_priority = ((priority + 1) * LAYER_HEIGHT) + MIN_NLE_PRIO;
ges_layer_resync_priorities (layer);
}
if (emit)
g_object_notify (G_OBJECT (layer), "priority");
}
static void
new_asset_cb (GESAsset * source, GAsyncResult * res, NewAssetUData * udata)
{
GError *error = NULL;
GESAsset *asset = ges_asset_request_finish (res, &error);
GST_DEBUG_OBJECT (udata->layer, "%" GST_PTR_FORMAT " Asset loaded, "
"setting its asset", udata->clip);
if (error) {
GESProject *project = udata->layer->timeline ?
GES_PROJECT (ges_extractable_get_asset (GES_EXTRACTABLE
(udata->layer->timeline))) : NULL;
if (project) {
gchar *possible_id;
possible_id = ges_project_try_updating_id (project, source, error);
if (possible_id) {
ges_asset_request_async (ges_asset_get_extractable_type (source),
possible_id, NULL, (GAsyncReadyCallback) new_asset_cb, udata);
g_free (possible_id);
return;
}
}
GST_ERROR ("Asset could not be created for uri %s, error: %s",
ges_asset_get_id (asset), error->message);
} else {
GESProject *project = udata->layer->timeline ?
GES_PROJECT (ges_extractable_get_asset (GES_EXTRACTABLE
(udata->layer->timeline))) : NULL;
ges_extractable_set_asset (GES_EXTRACTABLE (udata->clip), asset);
ges_project_add_asset (project, asset);
/* clip was already ref-sinked when creating udata,
* gst_layer_add_clip() creates a new ref as such and
* below we unref the ref from udata */
2013-04-23 23:04:04 +00:00
ges_layer_add_clip (udata->layer, udata->clip);
}
gst_object_unref (asset);
gst_object_unref (udata->clip);
g_slice_free (NewAssetUData, udata);
}
/**
* ges_layer_get_duration:
2019-12-18 20:33:45 +00:00
* @layer: The layer to get the duration from
*
2019-12-18 20:33:45 +00:00
* Retrieves the duration of the layer, which is the difference
* between the start of the layer (always time 0) and the end (which will
* be the end time of the final clip).
*
2019-12-18 20:33:45 +00:00
* Returns: The duration of @layer.
*/
GstClockTime
ges_layer_get_duration (GESLayer * layer)
{
GList *tmp;
GstClockTime duration = 0;
g_return_val_if_fail (GES_IS_LAYER (layer), 0);
for (tmp = layer->priv->clips_start; tmp; tmp = tmp->next) {
duration = MAX (duration, _END (tmp->data));
}
return duration;
}
static gboolean
ges_layer_remove_clip_internal (GESLayer * layer, GESClip * clip,
gboolean emit_removed)
{
2013-04-23 23:04:04 +00:00
GESLayer *current_layer;
GST_DEBUG ("layer:%p, clip:%p", layer, clip);
current_layer = ges_clip_get_layer (clip);
if (G_UNLIKELY (current_layer != layer)) {
2013-01-20 15:42:29 +00:00
GST_WARNING ("Clip doesn't belong to this layer");
if (current_layer != NULL)
gst_object_unref (current_layer);
return FALSE;
}
gst_object_unref (current_layer);
/* Remove it from our list of controlled objects */
layer->priv->clips_start = g_list_remove (layer->priv->clips_start, clip);
if (emit_removed) {
/* emit 'clip-removed' */
g_signal_emit (layer, ges_layer_signals[OBJECT_REMOVED], 0, clip);
}
/* inform the clip it's no longer in a layer */
ges_clip_set_layer (clip, NULL);
/* so neither in a timeline */
if (layer->timeline)
ges_timeline_element_set_timeline (GES_TIMELINE_ELEMENT (clip), NULL);
/* Remove our reference to the clip */
gst_object_unref (clip);
return TRUE;
}
/* Public methods */
/**
* ges_layer_remove_clip:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @clip: The clip to remove
*
2019-12-18 20:33:45 +00:00
* Removes the given clip from the layer.
*
2019-12-18 20:33:45 +00:00
* Returns: %TRUE if @clip was removed from @layer, or %FALSE if the
* operation failed.
*/
gboolean
ges_layer_remove_clip (GESLayer * layer, GESClip * clip)
{
g_return_val_if_fail (GES_IS_LAYER (layer), FALSE);
g_return_val_if_fail (GES_IS_CLIP (clip), FALSE);
return ges_layer_remove_clip_internal (layer, clip, TRUE);
}
2010-07-06 14:27:08 +00:00
/**
2013-04-23 23:04:04 +00:00
* ges_layer_set_priority:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @priority: The priority to set
2010-07-06 14:27:08 +00:00
*
2019-12-18 20:33:45 +00:00
* Sets the layer to the given priority. See #GESLayer:priority.
*
* Deprecated:1.16.0: use #ges_timeline_move_layer instead. This deprecation means
* that you will not need to handle layer priorities at all yourself, GES
* will make sure there is never 'gaps' between layer priorities.
2010-07-06 14:27:08 +00:00
*/
void
2013-04-23 23:04:04 +00:00
ges_layer_set_priority (GESLayer * layer, guint priority)
{
2013-04-23 23:04:04 +00:00
g_return_if_fail (GES_IS_LAYER (layer));
GST_FIXME ("Deprecated, use ges_timeline_move_layer instead");
2013-04-30 17:19:39 +00:00
layer_set_priority (layer, priority, TRUE);
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_get_auto_transition:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
*
2019-12-18 20:33:45 +00:00
* Gets the #GESLayer:auto-transition of the layer.
*
2019-12-18 20:33:45 +00:00
* Returns: %TRUE if transitions are automatically added to @layer.
*/
gboolean
2013-04-23 23:04:04 +00:00
ges_layer_get_auto_transition (GESLayer * layer)
{
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), 0);
return layer->priv->auto_transition;
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_set_auto_transition:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @auto_transition: Whether transitions should be automatically added to
* the layer
*
* Sets #GESLayer:auto-transition for the layer. Use
* ges_timeline_set_auto_transition() if you want all layers within a
* #GESTimeline to have #GESLayer:auto-transition set to %TRUE. Use this
* method if you want different values for different layers (and make sure
* to keep #GESTimeline:auto-transition as %FALSE for the corresponding
* timeline).
*/
void
2013-04-23 23:04:04 +00:00
ges_layer_set_auto_transition (GESLayer * layer, gboolean auto_transition)
{
2011-11-02 16:51:36 +00:00
2013-04-23 23:04:04 +00:00
g_return_if_fail (GES_IS_LAYER (layer));
if (layer->priv->auto_transition == auto_transition)
return;
layer->priv->auto_transition = auto_transition;
g_object_notify (G_OBJECT (layer), "auto-transition");
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_get_priority:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
*
2019-12-18 20:33:45 +00:00
* Get the priority of the layer. When inside a timeline, this is its
* index in the timeline. See ges_timeline_move_layer().
*
2019-12-18 20:33:45 +00:00
* Returns: The priority of @layer within its timeline.
*/
guint
2013-04-23 23:04:04 +00:00
ges_layer_get_priority (GESLayer * layer)
{
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), 0);
return layer->priv->priority;
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_get_clips:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
*
2019-12-18 20:33:45 +00:00
* Get the #GESClip-s contained in this layer.
*
2019-12-18 20:33:45 +00:00
* Returns: (transfer full) (element-type GESClip): A list of clips in
* @layer.
*/
GList *
2013-04-23 23:04:04 +00:00
ges_layer_get_clips (GESLayer * layer)
{
2013-04-23 23:04:04 +00:00
GESLayerClass *klass;
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), NULL);
2013-04-23 23:04:04 +00:00
klass = GES_LAYER_GET_CLASS (layer);
if (klass->get_objects) {
return klass->get_objects (layer);
}
return g_list_sort (g_list_copy_deep (layer->priv->clips_start,
(GCopyFunc) gst_object_ref, NULL),
(GCompareFunc) element_start_compare);
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_is_empty:
* @layer: The #GESLayer to check
*
2019-12-18 20:33:45 +00:00
* Convenience method to check if the layer is empty (doesn't contain
* any #GESClip), or not.
*
2019-12-18 20:33:45 +00:00
* Returns: %TRUE if @layer is empty, %FALSE if it contains at least
* one clip.
*/
gboolean
2013-04-23 23:04:04 +00:00
ges_layer_is_empty (GESLayer * layer)
{
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), FALSE);
return (layer->priv->clips_start == NULL);
}
2012-04-08 01:24:18 +00:00
/**
2013-04-23 23:04:04 +00:00
* ges_layer_add_clip:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @clip: (transfer floating): The clip to add
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* Adds the given clip to the layer. If the method succeeds, the layer
* will take ownership of the clip.
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* This method will fail and return %FALSE if @clip already resides in
* some layer. It can also fail if the additional clip breaks some
* compositional rules (see #GESTimelineElement).
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* Returns: %TRUE if @clip was properly added to @layer, or %FALSE
* if @layer refused to add @clip.
2012-04-08 01:24:18 +00:00
*/
gboolean
2013-04-23 23:04:04 +00:00
ges_layer_add_clip (GESLayer * layer, GESClip * clip)
2012-04-08 01:24:18 +00:00
{
GESAsset *asset;
2013-04-23 23:04:04 +00:00
GESLayerPrivate *priv;
GESLayer *current_layer;
2012-04-08 01:24:18 +00:00
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), FALSE);
g_return_val_if_fail (GES_IS_CLIP (clip), FALSE);
2012-04-08 01:24:18 +00:00
GST_DEBUG_OBJECT (layer, "adding clip:%p", clip);
2012-04-08 01:24:18 +00:00
priv = layer->priv;
current_layer = ges_clip_get_layer (clip);
if (G_UNLIKELY (current_layer)) {
GST_WARNING ("Clip %p already belongs to another layer", clip);
2019-12-18 20:33:45 +00:00
/* FIXME: why are we reffing the clip if it belongs to another
* layer? */
gst_object_ref_sink (clip);
gst_object_unref (current_layer);
2012-04-08 01:24:18 +00:00
return FALSE;
}
asset = ges_extractable_get_asset (GES_EXTRACTABLE (clip));
if (asset == NULL) {
gchar *id;
NewAssetUData *mudata = g_slice_new (NewAssetUData);
mudata->clip = gst_object_ref_sink (clip);
mudata->layer = layer;
GST_DEBUG_OBJECT (layer, "%" GST_PTR_FORMAT " as no reference to any "
"assets creating a asset... trying sync", clip);
id = ges_extractable_get_id (GES_EXTRACTABLE (clip));
asset = ges_asset_request (G_OBJECT_TYPE (clip), id, NULL);
if (asset == NULL) {
GESProject *project = layer->timeline ?
GES_PROJECT (ges_extractable_get_asset (GES_EXTRACTABLE
(layer->timeline))) : NULL;
ges_asset_request_async (G_OBJECT_TYPE (clip),
id, NULL, (GAsyncReadyCallback) new_asset_cb, mudata);
if (project)
ges_project_add_loading_asset (project, G_OBJECT_TYPE (clip), id);
g_free (id);
GST_LOG_OBJECT (layer, "Object added async");
return TRUE;
}
g_free (id);
ges_extractable_set_asset (GES_EXTRACTABLE (clip), asset);
g_slice_free (NewAssetUData, mudata);
2019-01-26 10:50:48 +00:00
gst_clear_object (&asset);
} else {
gst_object_ref_sink (clip);
}
/* Take a reference to the clip and store it stored by start/priority */
priv->clips_start = g_list_insert_sorted (priv->clips_start, clip,
(GCompareFunc) element_start_compare);
2012-04-08 01:24:18 +00:00
/* Inform the clip it's now in this layer */
ges_clip_set_layer (clip, layer);
2012-04-08 01:24:18 +00:00
GST_DEBUG ("current clip priority : %d, Height: %d", _PRIORITY (clip),
LAYER_HEIGHT);
2012-04-08 01:24:18 +00:00
/* Set the priority. */
if (_PRIORITY (clip) > LAYER_HEIGHT) {
GST_WARNING_OBJECT (layer,
"%p is out of the layer space, setting its priority to "
"%d, setting it to the maximum priority of the layer: %d", clip,
_PRIORITY (clip), LAYER_HEIGHT - 1);
_set_priority0 (GES_TIMELINE_ELEMENT (clip), LAYER_HEIGHT - 1);
2012-04-08 01:24:18 +00:00
}
2013-04-23 23:04:04 +00:00
ges_layer_resync_priorities (layer);
ges_timeline_element_set_timeline (GES_TIMELINE_ELEMENT (clip),
layer->timeline);
2012-04-08 01:24:18 +00:00
/* emit 'clip-added' */
2019-12-18 20:33:45 +00:00
/* FIXME: we are emitting the 'clip-added' signal even though we still
* might fail. This is because the timeline uses this signal to create
* the auto-transitions etc needed for timeline_tree_can_move_element
* below, which checks whether the added clip is in a legal position.
* However, we should have a way to check that adding a clip will be
* legal **before** we actually add it!
* A user connecting to 'clip-added' in such a case would receive a
* signal saying that the clip was added, but a return value that says
* something else! */
2013-04-23 23:04:04 +00:00
g_signal_emit (layer, ges_layer_signals[OBJECT_ADDED], 0, clip);
2012-04-08 01:24:18 +00:00
if (!ELEMENT_FLAG_IS_SET (clip, GES_CLIP_IS_MOVING) && layer->timeline
&& !timeline_tree_can_move_element (timeline_get_tree (layer->timeline),
GES_TIMELINE_ELEMENT (clip),
GES_TIMELINE_ELEMENT_LAYER_PRIORITY (clip),
GES_TIMELINE_ELEMENT_START (clip),
GES_TIMELINE_ELEMENT_DURATION (clip), NULL)) {
GST_INFO_OBJECT (layer, "Clip %" GES_FORMAT, GES_ARGS (clip));
ges_layer_remove_clip_internal (layer, clip, TRUE);
return FALSE;
}
2012-04-08 01:24:18 +00:00
return TRUE;
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_add_asset:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @asset: The asset to extract the new clip from
* @start: The #GESTimelineElement:start value to set on the new clip
* If `start == #GST_CLOCK_TIME_NONE`, it will be added to the end
* of @layer, i.e. it will be set to @layer's duration
* @inpoint: The #GESTimelineElement:in-point value to set on the new
* clip
* @duration: The #GESTimelineElement:duration value to set on the new
* clip
* @track_types: The #GESClip:supported-formats to set on the the new
* clip, or #GES_TRACK_TYPE_UNKNOWN to use the default
*
* Extracts a new clip from an asset and adds it to the layer with
* the given properties.
*
* Returns: (transfer none): The newly created clip.
2012-12-29 21:24:05 +00:00
*/
2013-01-20 15:42:29 +00:00
GESClip *
2013-04-23 23:04:04 +00:00
ges_layer_add_asset (GESLayer * layer,
GESAsset * asset, GstClockTime start, GstClockTime inpoint,
GstClockTime duration, GESTrackType track_types)
{
2013-01-20 15:42:29 +00:00
GESClip *clip;
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), NULL);
g_return_val_if_fail (GES_IS_ASSET (asset), NULL);
g_return_val_if_fail (g_type_is_a (ges_asset_get_extractable_type
2013-01-20 15:42:29 +00:00
(asset), GES_TYPE_CLIP), NULL);
2013-01-10 15:41:13 +00:00
GST_DEBUG_OBJECT (layer, "Adding asset %s with: start: %" GST_TIME_FORMAT
" inpoint: %" GST_TIME_FORMAT " duration: %" GST_TIME_FORMAT
2013-01-10 15:41:13 +00:00
" track types: %d (%s)", ges_asset_get_id (asset), GST_TIME_ARGS (start),
GST_TIME_ARGS (inpoint), GST_TIME_ARGS (duration), track_types,
2013-01-10 15:41:13 +00:00
ges_track_type_name (track_types));
2013-01-20 15:42:29 +00:00
clip = GES_CLIP (ges_asset_extract (asset, NULL));
if (!GST_CLOCK_TIME_IS_VALID (start)) {
start = ges_layer_get_duration (layer);
GST_DEBUG_OBJECT (layer,
"No start specified, setting it to %" GST_TIME_FORMAT,
GST_TIME_ARGS (start));
}
2013-01-20 15:42:29 +00:00
_set_start0 (GES_TIMELINE_ELEMENT (clip), start);
_set_inpoint0 (GES_TIMELINE_ELEMENT (clip), inpoint);
if (track_types != GES_TRACK_TYPE_UNKNOWN)
2013-01-20 15:42:29 +00:00
ges_clip_set_supported_formats (clip, track_types);
if (GST_CLOCK_TIME_IS_VALID (duration)) {
2013-01-20 15:42:29 +00:00
_set_duration0 (GES_TIMELINE_ELEMENT (clip), duration);
}
2013-04-23 23:04:04 +00:00
if (!ges_layer_add_clip (layer, clip)) {
return NULL;
}
2013-01-20 15:42:29 +00:00
return clip;
}
2012-04-08 01:24:18 +00:00
/**
2013-04-23 23:04:04 +00:00
* ges_layer_new:
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* Creates a new layer.
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* Returns: (transfer floating): A new layer.
2012-04-08 01:24:18 +00:00
*/
2013-04-23 23:04:04 +00:00
GESLayer *
ges_layer_new (void)
2012-04-08 01:24:18 +00:00
{
2013-04-23 23:04:04 +00:00
return g_object_new (GES_TYPE_LAYER, NULL);
2012-04-08 01:24:18 +00:00
}
/**
2013-04-23 23:04:04 +00:00
* ges_layer_get_timeline:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* Gets the timeline that the layer is a part of.
2012-04-08 01:24:18 +00:00
*
2019-12-18 20:33:45 +00:00
* Returns: (transfer none) (nullable): The timeline that @layer
* is currently part of, or %NULL if it is not associated with any
* timeline.
2012-04-08 01:24:18 +00:00
*/
GESTimeline *
2013-04-23 23:04:04 +00:00
ges_layer_get_timeline (GESLayer * layer)
2012-04-08 01:24:18 +00:00
{
2013-04-23 23:04:04 +00:00
g_return_val_if_fail (GES_IS_LAYER (layer), NULL);
2012-04-08 01:24:18 +00:00
return layer->timeline;
}
void
2013-04-23 23:04:04 +00:00
ges_layer_set_timeline (GESLayer * layer, GESTimeline * timeline)
2012-04-08 01:24:18 +00:00
{
GList *tmp;
g_return_if_fail (GES_IS_LAYER (layer));
2012-04-08 01:24:18 +00:00
GST_DEBUG ("layer:%p, timeline:%p", layer, timeline);
for (tmp = layer->priv->clips_start; tmp; tmp = tmp->next) {
ges_timeline_element_set_timeline (tmp->data, timeline);
}
layer->timeline = timeline;
2012-04-08 01:24:18 +00:00
}
/**
* ges_layer_get_clips_in_interval:
2019-12-18 20:33:45 +00:00
* @layer: The #GESLayer
* @start: Start of the interval
* @end: End of the interval
*
2019-12-18 20:33:45 +00:00
* Gets the clips within the layer that appear between @start and @end.
*
2019-12-18 20:33:45 +00:00
* Returns: (transfer full) (element-type GESClip): A list of #GESClip-s
* that intersect the interval `[start, end)` in @layer.
*/
GList *
ges_layer_get_clips_in_interval (GESLayer * layer, GstClockTime start,
GstClockTime end)
{
GList *tmp;
GList *intersecting_clips = NULL;
GstClockTime clip_start, clip_end;
gboolean clip_intersects;
g_return_val_if_fail (GES_IS_LAYER (layer), NULL);
layer->priv->clips_start =
g_list_sort (layer->priv->clips_start,
(GCompareFunc) element_start_compare);
for (tmp = layer->priv->clips_start; tmp; tmp = tmp->next) {
clip_intersects = FALSE;
clip_start = ges_timeline_element_get_start (tmp->data);
clip_end = clip_start + ges_timeline_element_get_duration (tmp->data);
if (start <= clip_start && clip_start < end)
clip_intersects = TRUE;
else if (start < clip_end && clip_end <= end)
clip_intersects = TRUE;
else if (clip_start < start && clip_end > end)
clip_intersects = TRUE;
if (clip_intersects)
intersecting_clips =
g_list_insert_sorted (intersecting_clips,
gst_object_ref (tmp->data), (GCompareFunc) element_start_compare);
}
return intersecting_clips;
}