mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-07-04 13:45:52 +00:00
d87578c843
Setters return values should return %FALSE **only** when the value could not be set, not when unchanged or when the subclass handled it itself! This patches makes it so the return value is meaningul by allowing subclasses return anything different than `TRUE` or `FALSE` (convention is -1) to let the subclass now that it took care of everything and no signal should be emited.
359 lines
14 KiB
C
359 lines
14 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 start position of the object (in nanoseconds).
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_START(obj) (((GESTimelineElement*)obj)->start)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_END:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The end position of the object (in nanoseconds).
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_END(obj) ((((GESTimelineElement*)obj)->start) + (((GESTimelineElement*)obj)->duration))
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_INPOINT:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The in-point of the object (in nanoseconds).
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_INPOINT(obj) (((GESTimelineElement*)obj)->inpoint)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_DURATION:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The duration of the object (in nanoseconds).
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_DURATION(obj) (((GESTimelineElement*)obj)->duration)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_MAX_DURATION:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The maximun duration of the object (in nanoseconds).
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_MAX_DURATION(obj) (((GESTimelineElement*)obj)->maxduration)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_PRIORITY:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The priority of the object.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_PRIORITY(obj) (((GESTimelineElement*)obj)->priority)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY:
|
|
*
|
|
* Layer priority when the element is not in a 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 parent of the object.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_PARENT(obj) (((GESTimelineElement*)obj)->parent)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_TIMELINE:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The timeline in which the object is.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_TIMELINE(obj) (((GESTimelineElement*)obj)->timeline)
|
|
|
|
/**
|
|
* GES_TIMELINE_ELEMENT_NAME:
|
|
* @obj: a #GESTimelineElement
|
|
*
|
|
* The name of the object.
|
|
*/
|
|
#define GES_TIMELINE_ELEMENT_NAME(obj) (((GESTimelineElement*)obj)->name)
|
|
|
|
/**
|
|
* GESTimelineElement:
|
|
* @parent: The #GESTimelineElement that controls the object
|
|
* @asset: The #GESAsset from which the object has been extracted
|
|
* @start: position (in time) of the object
|
|
* @inpoint: Position in the media from which the object should be used
|
|
* @duration: duration of the object to be used
|
|
* @maxduration: The maximum duration the object can have
|
|
* @priority: priority of the object in the layer (0:top priority)
|
|
*
|
|
* Those filed can be accessed from outside but in no case should
|
|
* be changed from there. Subclasses can write 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 to set the parent of a #GESTimelineElement.
|
|
* @set_start: method to set the start of a #GESTimelineElement,
|
|
* -1 means that the subclass handled emiting the notify signal and
|
|
* the base class should return TRUE.
|
|
* @set_duration: method to set the duration of a #GESTimelineElement,
|
|
* -1 means that the subclass handled emiting the notify signal and
|
|
* the base class should return TRUE.
|
|
* @set_inpoint: method to set the inpoint of a #GESTimelineElement,
|
|
* -1 means that the subclass handled emiting the notify signal and
|
|
* the base class should return TRUE.
|
|
* @set_max_duration: method to set the maximun duration of a #GESTimelineElement
|
|
* @set_priority: method to set the priority of a #GESTimelineElement
|
|
* @ripple: method to ripple an object
|
|
* @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: Copy the children properties of @self into @copy
|
|
*
|
|
* 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 emit 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_API
|
|
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_ */
|