mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-20 15:27:07 +00:00
378 lines
18 KiB
C
378 lines
18 KiB
C
/*
|
|
* gst-editing-services
|
|
* Copyright (C) <2013> Thibault Saunier <thibault.saunier@collabora.com>
|
|
* <2013> Collabora Ltd.
|
|
*
|
|
* gst-editing-services is free software: you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the
|
|
* Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* gst-editing-services 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 General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef _GES_TIMELINE_ELEMENT_H_
|
|
#define _GES_TIMELINE_ELEMENT_H_
|
|
|
|
#include <glib-object.h>
|
|
#include <gst/gst.h>
|
|
#include "ges-enums.h"
|
|
#include "ges-types.h"
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#define GES_TYPE_TIMELINE_ELEMENT (ges_timeline_element_get_type ())
|
|
#define GES_TIMELINE_ELEMENT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GES_TYPE_TIMELINE_ELEMENT, GESTimelineElement))
|
|
#define GES_TIMELINE_ELEMENT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GES_TYPE_TIMELINE_ELEMENT, GESTimelineElementClass))
|
|
#define GES_IS_TIMELINE_ELEMENT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GES_TYPE_TIMELINE_ELEMENT))
|
|
#define GES_IS_TIMELINE_ELEMENT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GES_TYPE_TIMELINE_ELEMENT))
|
|
#define GES_TIMELINE_ELEMENT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GES_TYPE_TIMELINE_ELEMENT, GESTimelineElementClass))
|
|
|
|
typedef struct _GESTimelineElementPrivate GESTimelineElementPrivate;
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_START:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:start of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_START(obj) (((GESTimelineElement*)obj)->start)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_END:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The end position of @obj: #GESTimelineElement:start +
|
|
* #GESTimelineElement:duration.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_END(obj) ((((GESTimelineElement*)obj)->start) + (((GESTimelineElement*)obj)->duration))
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_INPOINT:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:in-point of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_INPOINT(obj) (((GESTimelineElement*)obj)->inpoint)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_DURATION:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:duration of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_DURATION(obj) (((GESTimelineElement*)obj)->duration)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_MAX_DURATION:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:max-duration of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_MAX_DURATION(obj) (((GESTimelineElement*)obj)->maxduration)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_PRIORITY:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:priority of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_PRIORITY(obj) (((GESTimelineElement*)obj)->priority)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY:
|
|
*
|
|
* Layer priority when a timeline element is not in any layer.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY ((guint32) -1)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_LAYER_PRIORITY:
|
|
* @obj: The object to retrieve the layer priority from
|
|
*
|
|
* See #ges_timeline_element_get_layer_priority.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_LAYER_PRIORITY(obj) (ges_timeline_element_get_layer_priority(((GESTimelineElement*)obj)))
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_PARENT:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:parent of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_PARENT(obj) (((GESTimelineElement*)obj)->parent)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_TIMELINE:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:timeline of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_TIMELINE(obj) (((GESTimelineElement*)obj)->timeline)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_NAME:
|
|
* @obj: A #GESTimelineElement
|
|
*
|
|
* The #GESTimelineElement:name of @obj.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_NAME(obj) (((GESTimelineElement*)obj)->name)
|
|
|
|
/**
|
|
* GESTimelineElement:
|
|
* @parent: The #GESTimelineElement:parent of the element
|
|
* @asset: The #GESAsset from which the object has been extracted
|
|
* @start: The #GESTimelineElement:start of the element
|
|
* @inpoint: The #GESTimelineElement:in-point of the element
|
|
* @duration: The #GESTimelineElement:duration of the element
|
|
* @maxduration: The #GESTimelineElement:max-duration of the element
|
|
* @priority: The #GESTimelineElement:priority of the element
|
|
* @name: The #GESTimelineElement:name of the element
|
|
* @timeline: The #GESTimelineElement:timeline of the element
|
|
*
|
|
* All members can be read freely, but should usually not be written to.
|
|
* Subclasses may write to them, but should make sure to properly call
|
|
* g_object_notify().
|
|
*/
|
|
struct _GESTimelineElement
|
|
{
|
|
GInitiallyUnowned parent_instance;
|
|
|
|
/*< public > */
|
|
/*< read only >*/
|
|
GESTimelineElement *parent;
|
|
GESAsset *asset;
|
|
GstClockTime start;
|
|
GstClockTime inpoint;
|
|
GstClockTime duration;
|
|
GstClockTime maxduration;
|
|
guint32 priority;
|
|
GESTimeline *timeline;
|
|
gchar *name;
|
|
|
|
/*< private >*/
|
|
GESTimelineElementPrivate *priv;
|
|
|
|
/* Padding for API extension */
|
|
gpointer _ges_reserved[GES_PADDING_LARGE];
|
|
};
|
|
|
|
/**
|
|
* GESTimelineElementClass:
|
|
* @set_parent: Method called just before the #GESTimelineElement:parent
|
|
* is set.
|
|
* @set_start: Method called just before the #GESTimelineElement:start is
|
|
* set. A return of -1 means that the subclass handled emitting the notify
|
|
* signal and the base class should return %TRUE.
|
|
* @set_duration: Method called just before the
|
|
* #GESTimelineElement:duration is set. A return of -1 means that the
|
|
* subclass handled emitting the notify signal and the base class should
|
|
* return %TRUE.
|
|
* @set_inpoint: Method called just before the
|
|
* #GESTimelineElement:in-point is set. A return of -1 means that the
|
|
* subclass handled emitting the notify signal and the base class should
|
|
* return %TRUE.
|
|
* @set_max_duration: Method called just before the
|
|
* #GESTimelineElement:max-duration is set.
|
|
* @set_priority: Method called just before the
|
|
* #GESTimelineElement:in-point is set.
|
|
* @ripple_end: Method to ripple an object on its #GES_EDGE_END edge.
|
|
* @roll_start: Method to roll an object on its #GES_EDGE_START edge.
|
|
* @roll_end: Method to roll an object on its #GES_EDGE_END edge.
|
|
* @trim: Method to trim an object.
|
|
* @deep_copy: Prepare @copy for pasting as a copy of @self. At least by
|
|
* copying the children properties of @self into @copy.
|
|
* @paste: Paste @self, which is the @copy prepared by @deep_copy, into
|
|
* the timeline at the given @paste_position, with @ref_element as a
|
|
* reference, which is the @self that was passed to @deep_copy.
|
|
* @lookup-child: Method to find a child with the child property.
|
|
* @prop_name. The default vmethod will return the first child that
|
|
* matches. Overwrite this with a call to the parent vmethod if you wish
|
|
* to redirect property names. Or overwrite to change which child is
|
|
* returned if multiple children share the same child property name.
|
|
* @get_track_types: Return a the track types for the element.
|
|
* @set_child_property: Method for setting the child property given by
|
|
* @pspec on @child to @value. Default implementation will use
|
|
* g_object_set_property().
|
|
* @get_layer_priority: Get the #GESLayer:priority of the layer that this
|
|
* element is part of.
|
|
*
|
|
* The #GESTimelineElement base class. Subclasses should override at least
|
|
* @set_start @set_inpoint @set_duration @ripple @ripple_end @roll_start
|
|
* @roll_end and @trim.
|
|
*
|
|
* Vmethods in subclasses should apply all the operation they need to but
|
|
* the real method implementation is in charge of setting the proper field,
|
|
* and emitting the notify signal.
|
|
*/
|
|
struct _GESTimelineElementClass
|
|
{
|
|
GInitiallyUnownedClass parent_class;
|
|
|
|
/*< public > */
|
|
gboolean (*set_parent) (GESTimelineElement * self, GESTimelineElement *parent);
|
|
gboolean (*set_start) (GESTimelineElement * self, GstClockTime start);
|
|
gboolean (*set_inpoint) (GESTimelineElement * self, GstClockTime inpoint);
|
|
gboolean (*set_duration) (GESTimelineElement * self, GstClockTime duration);
|
|
gboolean (*set_max_duration) (GESTimelineElement * self, GstClockTime maxduration);
|
|
gboolean (*set_priority) (GESTimelineElement * self, guint32 priority); /* set_priority is now protected */
|
|
|
|
gboolean (*ripple) (GESTimelineElement *self, guint64 start);
|
|
gboolean (*ripple_end) (GESTimelineElement *self, guint64 end);
|
|
gboolean (*roll_start) (GESTimelineElement *self, guint64 start);
|
|
gboolean (*roll_end) (GESTimelineElement *self, guint64 end);
|
|
gboolean (*trim) (GESTimelineElement *self, guint64 start);
|
|
void (*deep_copy) (GESTimelineElement *self, GESTimelineElement *copy);
|
|
|
|
GESTimelineElement * (*paste) (GESTimelineElement *self,
|
|
GESTimelineElement *ref_element,
|
|
GstClockTime paste_position);
|
|
|
|
GParamSpec** (*list_children_properties) (GESTimelineElement * self, guint *n_properties);
|
|
gboolean (*lookup_child) (GESTimelineElement *self, const gchar *prop_name,
|
|
GObject **child, GParamSpec **pspec);
|
|
GESTrackType (*get_track_types) (GESTimelineElement * self);
|
|
void (*set_child_property) (GESTimelineElement * self, GObject *child,
|
|
GParamSpec *pspec, GValue *value);
|
|
|
|
guint32 (*get_layer_priority) (GESTimelineElement *self);
|
|
|
|
/*< private > */
|
|
/* Padding for API extension */
|
|
gpointer _ges_reserved[GES_PADDING_LARGE - 4];
|
|
};
|
|
|
|
GES_API
|
|
GType ges_timeline_element_get_type (void) G_GNUC_CONST;
|
|
|
|
GES_API
|
|
GESTimelineElement * ges_timeline_element_get_toplevel_parent (GESTimelineElement *self);
|
|
GES_API
|
|
GESTimelineElement * ges_timeline_element_get_parent (GESTimelineElement * self);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_parent (GESTimelineElement *self,
|
|
GESTimelineElement *parent);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_timeline (GESTimelineElement *self,
|
|
GESTimeline *timeline);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_start (GESTimelineElement *self,
|
|
GstClockTime start);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_inpoint (GESTimelineElement *self,
|
|
GstClockTime inpoint);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_duration (GESTimelineElement *self,
|
|
GstClockTime duration);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_max_duration (GESTimelineElement *self,
|
|
GstClockTime maxduration);
|
|
GES_DEPRECATED
|
|
gboolean ges_timeline_element_set_priority (GESTimelineElement *self,
|
|
guint32 priority);
|
|
GES_API
|
|
GstClockTime ges_timeline_element_get_start (GESTimelineElement *self);
|
|
GES_API
|
|
GstClockTime ges_timeline_element_get_inpoint (GESTimelineElement *self);
|
|
GES_API
|
|
GstClockTime ges_timeline_element_get_duration (GESTimelineElement *self);
|
|
GES_API
|
|
GstClockTime ges_timeline_element_get_max_duration (GESTimelineElement *self);
|
|
GES_API
|
|
GESTimeline * ges_timeline_element_get_timeline (GESTimelineElement *self);
|
|
GES_API
|
|
guint32 ges_timeline_element_get_priority (GESTimelineElement *self);
|
|
GES_API
|
|
gboolean ges_timeline_element_ripple (GESTimelineElement *self,
|
|
GstClockTime start);
|
|
GES_API
|
|
gboolean ges_timeline_element_ripple_end (GESTimelineElement *self,
|
|
GstClockTime end);
|
|
GES_API
|
|
gboolean ges_timeline_element_roll_start (GESTimelineElement *self,
|
|
GstClockTime start);
|
|
GES_API
|
|
gboolean ges_timeline_element_roll_end (GESTimelineElement *self,
|
|
GstClockTime end);
|
|
GES_API
|
|
gboolean ges_timeline_element_trim (GESTimelineElement *self,
|
|
GstClockTime start);
|
|
GES_API
|
|
GESTimelineElement * ges_timeline_element_copy (GESTimelineElement *self,
|
|
gboolean deep);
|
|
GES_API
|
|
gchar * ges_timeline_element_get_name (GESTimelineElement *self);
|
|
GES_API
|
|
gboolean ges_timeline_element_set_name (GESTimelineElement *self,
|
|
const gchar *name);
|
|
GES_API
|
|
GParamSpec ** ges_timeline_element_list_children_properties (GESTimelineElement *self,
|
|
guint *n_properties);
|
|
GES_API
|
|
gboolean ges_timeline_element_lookup_child (GESTimelineElement *self,
|
|
const gchar *prop_name,
|
|
GObject **child,
|
|
GParamSpec **pspec);
|
|
GES_API
|
|
void ges_timeline_element_get_child_property_by_pspec (GESTimelineElement * self,
|
|
GParamSpec * pspec, GValue * value);
|
|
GES_API
|
|
void ges_timeline_element_get_child_property_valist (GESTimelineElement * self,
|
|
const gchar * first_property_name,
|
|
va_list var_args);
|
|
GES_API
|
|
void ges_timeline_element_get_child_properties (GESTimelineElement *self,
|
|
const gchar * first_property_name, ...) G_GNUC_NULL_TERMINATED;
|
|
GES_API
|
|
void ges_timeline_element_set_child_property_valist (GESTimelineElement * self,
|
|
const gchar * first_property_name,
|
|
va_list var_args);
|
|
GES_API
|
|
void ges_timeline_element_set_child_property_by_pspec (GESTimelineElement * self,
|
|
GParamSpec * pspec,
|
|
const GValue * value);
|
|
GES_API
|
|
void ges_timeline_element_set_child_properties (GESTimelineElement * self,
|
|
const gchar * first_property_name,
|
|
...) G_GNUC_NULL_TERMINATED;
|
|
GES_API
|
|
gboolean ges_timeline_element_set_child_property (GESTimelineElement *self,
|
|
const gchar *property_name,
|
|
const GValue * value);
|
|
GES_API
|
|
gboolean ges_timeline_element_get_child_property (GESTimelineElement *self,
|
|
const gchar *property_name,
|
|
GValue * value);
|
|
GES_API
|
|
gboolean ges_timeline_element_add_child_property (GESTimelineElement * self,
|
|
GParamSpec *pspec,
|
|
GObject *child);
|
|
GES_API
|
|
gboolean ges_timeline_element_remove_child_property (GESTimelineElement * self,
|
|
GParamSpec *pspec);
|
|
GES_API
|
|
GESTimelineElement * ges_timeline_element_paste (GESTimelineElement * self,
|
|
GstClockTime paste_position);
|
|
GES_API
|
|
GESTrackType ges_timeline_element_get_track_types (GESTimelineElement * self);
|
|
|
|
GES_API
|
|
guint32 ges_timeline_element_get_layer_priority (GESTimelineElement * self);
|
|
|
|
GES_API
|
|
gboolean ges_timeline_element_edit (GESTimelineElement * self,
|
|
GList * layers,
|
|
gint64 new_layer_priority,
|
|
GESEditMode mode,
|
|
GESEdge edge,
|
|
guint64 position);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* _GES_TIMELINE_ELEMENT_H_ */
|