|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | ||||
-GESCustomTimelineSource-GESCustomTimelineSource — Convenience GESTimelineSource - |
-- |
-#include <ges/ges.h> - - GESCustomTimelineSource; - GESCustomTimelineSourceClass; -gboolean (*FillTrackObjectUserFunc) (-GESTimelineObject *object, -GESTrackObject *trobject, -GstElement *gnlobj, -gpointer user_data); -GESCustomTimelineSource * ges_custom_timeline_source_new - (FillTrackObjectUserFunc func, -gpointer user_data); -
- GObject - +----GESTimelineObject - +----GESTimelineSource - +----GESCustomTimelineSource --
-GESCustomTimelineSource allows creating GESTimelineSource(s) without the -need to subclass. -
--Its usage should be limited to testing and prototyping purposes. -
-typedef struct {
- GESTimelineSourceClass parent_class;
-} GESCustomTimelineSourceClass;
-
--
-gboolean (*FillTrackObjectUserFunc) (-GESTimelineObject *object, -GESTrackObject *trobject, -GstElement *gnlobj, -gpointer user_data);
-A function that will be called when the GNonLin object of a corresponding -track object needs to be filled. -
-
-The implementer of this function shall add the proper GstElement to gnlobj
-using gst_bin_add().
-
|
-the GESTimelineObject controlling the track object - | -
|
-the GESTrackObject - | -
|
-the GNonLin object that needs to be filled. - | -
|
-the gpointer to optional user data - | -
Returns : |
- TRUE if the implementer succesfully filled the gnlobj, else FALSE.
- |
-
GESCustomTimelineSource * ges_custom_timeline_source_new - (-FillTrackObjectUserFunc func, -gpointer user_data);
-Creates a new GESCustomTimelineSource. -
-
|
-The FillTrackObjectUserFunc that will be used to fill the track objects. - | -
|
-a gpointer that will be used when func is called.
- |
-
Returns : |
-The new GESCustomTimelineSource. - | -
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | ||||
-GESSimpleTimelineLayer-GESSimpleTimelineLayer — High-level GESTimelineLayer - |
-- |
-#include <ges/ges.h> - - GESSimpleTimelineLayer; - GESSimpleTimelineLayerClass; -GESSimpleTimelineLayer* ges_simple_timeline_layer_new (-void); -gboolean ges_simple_timeline_layer_add_object - (GESSimpleTimelineLayer *layer, -GESTimelineObject *object, -gint position); -gboolean ges_simple_timeline_layer_move_object - (GESSimpleTimelineLayer *layer, -GESTimelineObject *object, -gint newposition); -
typedef struct {
- GESTimelineLayerClass parent_class;
-} GESSimpleTimelineLayerClass;
-
--
-GESSimpleTimelineLayer* ges_simple_timeline_layer_new (void);
--Creates a new GESSimpleTimelineLayer. -
-Returns : |
-The new GESSimpleTimelineLayer - | -
gboolean ges_simple_timeline_layer_add_object - (-GESSimpleTimelineLayer *layer, -GESTimelineObject *object, -gint position);
-Adds the object at the given position in the layer. The position is where -the object will be inserted. To put the object before all objects, use -position 0. To put after all objects, use position -1. -
--The layer will steal a reference to the provided object. -
-
|
-a GESSimpleTimelineLayer - | -
|
-the GESTimelineObject to add - | -
|
-the position at which to add the object - | -
Returns : |
-TRUE if the object was successfuly added, else FALSE. - | -
gboolean ges_simple_timeline_layer_move_object - (-GESSimpleTimelineLayer *layer, -GESTimelineObject *object, -gint newposition);
-Moves the object to the given position in the layer. To put the object before -all other objects, use position 0. To put the objects after all objects, use -position -1. -
-
|
-a GESSimpleTimelineLayer - | -
|
-the GESTimelineObject to move - | -
|
-the new position at which to move the object - | -
Returns : |
-TRUE if the object was successfuly moved, else FALSE. - | -
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Implemented Interfaces - | - Signals - | ||||
-#include <ges/ges.h> - - GESTimeline; - GESTimelineClass; -GESTimeline* ges_timeline_new (-void); -gboolean ges_timeline_add_layer (GESTimeline *timeline, -GESTimelineLayer *layer); -gboolean ges_timeline_remove_layer (GESTimeline *timeline, -GESTimelineLayer *layer); -gboolean ges_timeline_add_track (GESTimeline *timeline, -GESTrack *track); -gboolean ges_timeline_remove_track (GESTimeline *timeline, -GESTrack *track); -GESTrack * ges_timeline_get_track_for_pad (GESTimeline *timeline, -GstPad *pad); -GESTimeline* ges_timeline_load_from_uri (gchar *uri); -gboolean ges_timeline_save (GESTimeline *timeline, -gchar *uri); -GList * ges_timeline_get_tracks (GESTimeline *timeline); -
- GObject - +----GstObject - +----GstElement - +----GstBin - +----GESTimeline --
- "layer-added" : Run First - "layer-removed" : Run First - "track-added" : Run First - "track-removed" : Run First --
-GESTimeline is the central object for any multimedia timeline. -
--Contains a list of GESTimelineLayer which users should use to arrange the -various timeline objects through time. -
--The output type is determined by the GESTimelineTrack that are set on -the GESTimeline. -
-typedef struct {
- GstBinClass parent_class;
-
- void (*track_added) (GESTimeline *timeline, GESTrack * track);
- void (*track_removed) (GESTimeline *timeline, GESTrack * track);
- void (*layer_added) (GESTimeline *timeline, GESTimelineLayer *layer);
- void (*layer_removed) (GESTimeline *timeline, GESTimelineLayer *layer);
-} GESTimelineClass;
-
--
-GESTimeline* ges_timeline_new (void);
--Creates a new empty GESTimeline. -
-Returns : |
-The new timeline. - | -
gboolean ges_timeline_add_layer (-GESTimeline *timeline, -GESTimelineLayer *layer);
-Add the layer to the timeline. The reference to the layer will be stolen
-by the timeline.
-
|
-a GESTimeline - | -
|
-the GESTimelineLayer to add - | -
Returns : |
-TRUE if the layer was properly added, else FALSE. - | -
gboolean ges_timeline_remove_layer (-GESTimeline *timeline, -GESTimelineLayer *layer);
-Removes the layer from the timeline. The reference that the timeline holds on
-the layer will be dropped. If you wish to use the layer after calling this
-method, you need to take a reference before calling.
-
|
-a GESTimeline - | -
|
-the GESTimelineLayer to remove - | -
Returns : |
-TRUE if the layer was properly removed, else FALSE. - | -
gboolean ges_timeline_add_track (-GESTimeline *timeline, -GESTrack *track);
-Add a track to the timeline. The reference to the track will be stolen by the -pipeline. -
-
|
-a GESTimeline - | -
|
-the GESTrack to add - | -
Returns : |
-TRUE if the track was properly added, else FALSE. - | -
gboolean ges_timeline_remove_track (-GESTimeline *timeline, -GESTrack *track);
-Remove the track from the timeline. The reference stolen when adding the
-track will be removed. If you wish to use the track after calling this
-function you must ensure that you have a reference to it.
-
|
-a GESTimeline - | -
|
-the GESTrack to remove - | -
Returns : |
- TRUE if the track was properly removed, else FALSE.
- |
-
GESTrack * ges_timeline_get_track_for_pad (-GESTimeline *timeline, -GstPad *pad);
-Search the GESTrack corresponding to the given timeline's pad.
-
|
-The GESTimeline - | -
|
-The GstPad - | -
Returns : |
-The corresponding GESTrack if it is found, or NULL if there is -an error. - | -
GESTimeline* ges_timeline_load_from_uri (gchar *uri);
--Creates a timeline from the contents of given uri. -
--NOT_IMPLEMENTED ! -
-
|
-The URI to load from - | -
Returns : |
-A new GESTimeline if loading was successful, else NULL. - | -
gboolean ges_timeline_save (-GESTimeline *timeline, -gchar *uri);
-Saves the timeline to the given location -
--NOT_IMPLEMENTED ! -
-
|
-a GESTimeline - | -
|
-The location to save to - | -
Returns : |
-TRUE if the timeline was successfully saved to the given location, -else FALSE. - | -
GList * ges_timeline_get_tracks (GESTimeline *timeline);
--
-
|
-- | -
Returns : |
-- | -
"layer-added" signalvoid user_function (GESTimeline *timeline, - GESTimelineLayer *layer, - gpointer user_data) : Run First-
-Will be emitted after the layer was added to the timeline. -
-
|
-the GESTimeline - | -
|
-the GESTimelineLayer that was added to the timeline - | -
|
-user data set when the signal handler was connected. | -
"layer-removed" signalvoid user_function (GESTimeline *timeline, - GESTimelineLayer *layer, - gpointer user_data) : Run First-
-Will be emitted after the layer was removed from the timeline. -
-
|
-the GESTimeline - | -
|
-the GESTimelineLayer that was removed from the timeline - | -
|
-user data set when the signal handler was connected. | -
"track-added" signalvoid user_function (GESTimeline *timeline, - GESTrack *track, - gpointer user_data) : Run First-
-Will be emitted after the track was added to the timeline. -
-
|
-the GESTimeline - | -
|
-the GESTrack that was added to the timeline - | -
|
-user data set when the signal handler was connected. | -
"track-removed" signalvoid user_function (GESTimeline *timeline, - GESTrack *track, - gpointer user_data) : Run First-
-Will be emitted after the track was removed from the timeline. -
-
|
-the GESTimeline - | -
|
-the GESTrack that was removed from the timeline - | -
|
-user data set when the signal handler was connected. | -
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Properties - | ||||
-#include <ges/ges.h>
-
- GESTimelineFileSource;
- GESTimelineFileSourceClass;
-GESTimelineFileSource* ges_timeline_filesource_new (gchar *uri);
-
-- GObject - +----GESTimelineObject - +----GESTimelineSource - +----GESTimelineFileSource --
- "max-duration" guint64 : Read / Write / Construct - "mute" gboolean : Read / Write / Construct - "uri" gchar* : Read / Write / Construct Only --
typedef struct {
- GESTimelineSourceClass parent_class;
-} GESTimelineFileSourceClass;
-
--
-GESTimelineFileSource* ges_timeline_filesource_new (gchar *uri);
-
-Creates a new GESTimelineFileSource for the provided uri.
-
|
-the URI the source should control - | -
Returns : |
-The newly created GESTimelineFileSource, or NULL if there was an -error. - | -
"max-duration" property"max-duration" guint64 : Read / Write / Construct-
-The maximum duration (in nanoseconds) of the file. -
--If not set before adding the object to a layer, it will be discovered -asynchronously. Connect to 'notify::max-duration' to be notified of it. -
-Default value: 18446744073709551615
-"mute" property"mute" gboolean : Read / Write / Construct-
-Whether the sound will be played or not. -
-Default value: FALSE
-"uri" property"uri" gchar* : Read / Write / Construct Only-
-The location of the file/resource to use. -
-Default value: NULL
- |
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Properties - | - Signals - | ||||
-GESTimelineLayer-GESTimelineLayer — Non-overlaping sequence of GESTimelineObject - |
-- |
-#include <ges/ges.h> - - GESTimelineLayer; - GESTimelineLayerClass; -gboolean ges_timeline_layer_add_object (-GESTimelineLayer *layer, -GESTimelineObject *object); -GESTimelineLayer* ges_timeline_layer_new (void); -gboolean ges_timeline_layer_remove_object (GESTimelineLayer *layer, -GESTimelineObject *object); -void ges_timeline_layer_set_priority (GESTimelineLayer *layer, -guint priority); -
typedef struct {
- GObjectClass parent_class;
-
- /*< signals >*/
- void (*object_added) (GESTimelineLayer * layer, GESTimelineObject * object);
- void (*object_removed) (GESTimelineLayer * layer, GESTimelineObject * object);
-} GESTimelineLayerClass;
-
--
-gboolean ges_timeline_layer_add_object (-GESTimelineLayer *layer, -GESTimelineObject *object);
-Adds the object to the layer. The layer will steal a reference to the -provided object. -
-
|
-a GESTimelineLayer - | -
|
-the GESTimelineObject to add. - | -
Returns : |
- TRUE if the object was properly added to the layer, or FALSE
-if the layer refused to add the object.
- |
-
GESTimelineLayer* ges_timeline_layer_new (void);
--Creates a new GESTimelineLayer. -
-Returns : |
-A new GESTimelineLayer - | -
gboolean ges_timeline_layer_remove_object (-GESTimelineLayer *layer, -GESTimelineObject *object);
-Removes the given object from the layer. The reference stolen by the layer
-when the object was added will be removed. If you wish to use the object after
-this function, make sure you take an extra reference to the object before
-calling this function.
-
|
-a GESTimelineLayer - | -
|
-the GESTimelineObject to remove - | -
Returns : |
-TRUE if the object was properly remove, else FALSE. - | -
void ges_timeline_layer_set_priority (-GESTimelineLayer *layer, -guint priority);
-
-
|
-- | -
|
-- | -
"priority" property"priority" guint : Read / Write-
-The priority of the layer in the GESTimeline. 0 is the highest -priority. -
-Default value: 0
-"object-added" signalvoid user_function (GESTimelineLayer *layer, - GESTimelineObject *object, - gpointer user_data) : Run First-
-Will be emitted after the object was added to the layer. -
-
|
-the GESTimelineLayer - | -
|
-the GESTimelineObject that was added. - | -
|
-user data set when the signal handler was connected. | -
"object-removed" signalvoid user_function (GESTimelineLayer *layer, - GESTimelineObject *object, - gpointer user_data) : Run First-
-Will be emitted after the object was removed from the layer. -
-
|
-the GESTimelineLayer - | -
|
-the GESTimelineObject that was removed - | -
|
-user data set when the signal handler was connected. | -
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Properties - | ||||
-GESTimelineObject-GESTimelineObject — Base Class for objects in a GESTimelineLayer - |
-- |
-#include <ges/ges.h> - - GESTimelineObject; - GESTimelineObjectClass; -GESTrackObject * (*CreateTrackObjectFunc) (-GESTimelineObject *object, -GESTrack *track); -gboolean (*FillTrackObjectFunc) (GESTimelineObject *object, -GESTrackObject *trobject, -GstElement *gnlobj); -#define GES_TIMELINE_OBJECT_DURATION (obj) -#define GES_TIMELINE_OBJECT_INPOINT (obj) -#define GES_TIMELINE_OBJECT_PRIORITY (obj) -#define GES_TIMELINE_OBJECT_START (obj) -void ges_timeline_object_set_inpoint (GESTimelineObject *object, -guint64 inpoint); -void ges_timeline_object_set_start (GESTimelineObject *object, -guint64 start); -void ges_timeline_object_set_duration (GESTimelineObject *object, -guint64 duration); -GESTrackObject * ges_timeline_object_find_track_object - (GESTimelineObject *object, -GESTrack *track); -
- GObject - +----GESTimelineObject - +----GESTimelineSource - +----GESTimelineTransition --
- "duration" guint64 : Read / Write - "in-point" guint64 : Read / Write - "priority" guint : Read / Write - "start" guint64 : Read / Write --
-Responsible for creating the GESTrackObject(s) for given GESTimelineTrack(s) -
--Keeps a reference to the GESTrackObject(s) it created and sets/updates their properties. -
-typedef struct {
- GESTimelineLayer * layer;
-} GESTimelineObject;
-
--The GESTimelineObject subclass. Subclasses can access these fields. -
-GESTimelineLayer * |
-the GESTImelineLayer where this object is being used. - | -
typedef struct {
- GObjectClass parent_class;
-
- CreateTrackObjectFunc create_track_object;
- /* FIXME : might need a release_track_object */
- FillTrackObjectFunc fill_track_object;
- gboolean need_fill_track;
-} GESTimelineObjectClass;
-
-
-Subclasses can override the create_track_object and fill_track_object methods.
-
GObjectClass |
-object parent class - | -
CreateTrackObjectFunc |
-method to create a GESTrackObject for a given GESTrack. - | -
FillTrackObjectFunc |
-method to fill an associated GESTrackObject. - | -
gboolean |
-Set to TRUE if fill_track_object needs to be called.
- |
-
GESTrackObject * (*CreateTrackObjectFunc) (-GESTimelineObject *object, -GESTrack *track);
-A function that will be called when the object is added to a
-GESTimelineLayer.
-
-The implementer of this function shall return the proper GESTrackObject
-that should be controlled by object for the given track.
-
-If the object can't support the media-type of the track, this function
-should return NULL.
-
|
-a GESTimelineObject - | -
|
-a GESTrack - | -
Returns : |
- the GESTrackObject to be used, or NULL.
- |
-
gboolean (*FillTrackObjectFunc) (-GESTimelineObject *object, -GESTrackObject *trobject, -GstElement *gnlobj);
-A function that will be called when the GNonLin object of a corresponding -track object needs to be filled. -
-
-The implementer of this function shall add the proper GstElement to gnlobj
-using gst_bin_add().
-
|
-the GESTimelineObject controlling the track object - | -
|
-the GESTrackObject - | -
|
-the GNonLin object that needs to be filled. - | -
Returns : |
- TRUE if the implementer succesfully filled the gnlobj, else FALSE.
- |
-
#define GES_TIMELINE_OBJECT_DURATION(obj) (((GESTimelineObject*)obj)->duration) --
-The duration position of the object (in nanoseconds). -
-
|
-a GESTimelineObject - | -
#define GES_TIMELINE_OBJECT_INPOINT(obj) (((GESTimelineObject*)obj)->inpoint) --
-The in-point of the object (in nanoseconds). -
-
|
-a GESTimelineObject - | -
#define GES_TIMELINE_OBJECT_PRIORITY(obj) (((GESTimelineObject*)obj)->priority) --
-The priority of the object. -
-
|
-a GESTimelineObject - | -
#define GES_TIMELINE_OBJECT_START(obj) (((GESTimelineObject*)obj)->start) --
-The start position of the object (in nanoseconds). -
-
|
-a GESTimelineObject - | -
void ges_timeline_object_set_inpoint (-GESTimelineObject *object, -guint64 inpoint);
-
-
|
-- | -
|
-- | -
void ges_timeline_object_set_start (-GESTimelineObject *object, -guint64 start);
-
-
|
-- | -
|
-- | -
void ges_timeline_object_set_duration (-GESTimelineObject *object, -guint64 duration);
-
-
|
-- | -
|
-- | -
GESTrackObject * ges_timeline_object_find_track_object - (-GESTimelineObject *object, -GESTrack *track);
-Finds the GESTrackObject controlled by object that is used in track.
-
-Note: The reference count of the returned GESTrackObject will be increased, -unref when done with it. -
-
|
-a GESTimelineObject - | -
|
-a GESTrack - | -
Returns : |
- The GESTrackObject used by track, else NULL.
- |
-
"duration" property"duration" guint64 : Read / Write-
-The duration (in nanoseconds) which will be used in the container GESTrack -starting from 'in-point'. -
-Default value: 1000000000
-"in-point" property"in-point" guint64 : Read / Write-
-The in-point at which this GESTimelineObject will start outputting data -from its contents (in nanoseconds). -
--Ex : an in-point of 5 seconds means that the first outputted buffer will -be the one located 5 seconds in the controlled resource. -
-Default value: 0
-"priority" property"priority" guint : Read / Write-
The priority of the object.
-Default value: 0
-"start" property"start" guint64 : Read / Write-
-The position of the object in the GESTimelineLayer (in nanoseconds). -
-Default value: 0
- |
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Implemented Interfaces - | ||||
-GESTimelinePipeline-GESTimelinePipeline — Convenience GstPipeline for editing. - |
-- |
-#include <ges/ges.h> - - GESTimelinePipeline; - GESTimelinePipelineClass; -enum GESPipelineFlags; -GESTimelinePipeline* ges_timeline_pipeline_new (-void); -gboolean ges_timeline_pipeline_add_timeline (GESTimelinePipeline *pipeline, -GESTimeline *timeline); -gboolean ges_timeline_pipeline_set_mode (GESTimelinePipeline *pipeline, -GESPipelineFlags mode); -gboolean ges_timeline_pipeline_set_render_settings - (GESTimelinePipeline *pipeline, -gchar *output_uri, -GstEncodingProfile *profile); -
- GObject - +----GstObject - +----GstElement - +----GstBin - +----GstPipeline - +----GESTimelinePipeline --
-GESTimelinePipeline allows developers to view and render GESTimeline -in a simple fashion. -Its usage is inspired by the 'playbin' element from gst-plugins-base. -
-typedef struct {
- GstPipelineClass parent_class;
-} GESTimelinePipelineClass;
-
--
-typedef enum {
- TIMELINE_MODE_PREVIEW_AUDIO = 1 << 0,
- TIMELINE_MODE_PREVIEW_VIDEO = 1 << 1,
- TIMELINE_MODE_PREVIEW = TIMELINE_MODE_PREVIEW_AUDIO | TIMELINE_MODE_PREVIEW_VIDEO,
- TIMELINE_MODE_RENDER = 1 << 2,
- TIMELINE_MODE_SMART_RENDER = 1 << 3
-} GESPipelineFlags;
-
--The various modes the GESTimelinePipeline can be configured to. -
-| - | output audio to the soundcard - | -
| - | output video to the screen - | -
| - | output audio/video to soundcard/screen (default) - | -
| - | render timeline (forces decoding) - | -
| - | render timeline (tries to avoid decoding/reencoding) - | -
GESTimelinePipeline* ges_timeline_pipeline_new (void);
--Creates a new conveninence GESTimelinePipeline. -
-Returns : |
-the new GESTimelinePipeline. - | -
gboolean ges_timeline_pipeline_add_timeline (-GESTimelinePipeline *pipeline, -GESTimeline *timeline);
-Sets the timeline to use in this pipeline. -
-
-The reference to the timeline will be stolen by the pipeline.
-
|
-a GESTimelinePipeline - | -
|
-the GESTimeline to set on the pipeline.
- |
-
Returns : |
- TRUE if the timeline could be successfully set on the pipeline,
-else FALSE.
- |
-
gboolean ges_timeline_pipeline_set_mode (-GESTimelinePipeline *pipeline, -GESPipelineFlags mode);
-switches the pipeline to the specified mode. The default mode when
-creating a GESTimelinePipeline is TIMELINE_MODE_PREVIEW.
-
-Note: The pipeline will be set to GST_STATE_NULL during this call due to
-the internal changes that happen. The caller will therefore have to
-set the pipeline to the requested state after calling this method.
-
|
-a GESTimelinePipeline - | -
|
-the GESPipelineFlags to use - | -
Returns : |
- TRUE if the mode was properly set, else FALSE.
- |
-
gboolean ges_timeline_pipeline_set_render_settings - (-GESTimelinePipeline *pipeline, -gchar *output_uri, -GstEncodingProfile *profile);
-Specify where the pipeline shall be rendered and with what settings. -
--This method must be called before setting the pipeline mode to -TIMELINE_MODE_RENDER -
-
|
-a GESTimelinePipeline - | -
|
-the URI to which the timeline will be rendered
- |
-
|
-the GstEncodingProfile to use to render the timeline - | -
Returns : |
- TRUE if the settings were aknowledged properly, else FALSE
- |
-
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | ||||
-GESTimelineSource-GESTimelineSource — Base Class for sources of a GESTimelineLayer - |
-- |
-#include <ges/ges.h>
-
- GESTimelineSource;
- GESTimelineSourceClass;
-GESTimelineSource* ges_timeline_source_new (void);
-
-- GObject - +----GESTimelineObject - +----GESTimelineSource - +----GESTimelineFileSource - +----GESCustomTimelineSource --
typedef struct {
- GESTimelineObjectClass parent_class;
-} GESTimelineSourceClass;
-
--
-GESTimelineSource* ges_timeline_source_new (void);
--
-Returns : |
-- | -
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | ||||
-GESTimelineTransition-GESTimelineTransition — Base Class for transitions in a GESTimelineLayer - |
-- |
-#include <ges/ges.h>
-
- GESTimelineTransition;
- GESTimelineTransitionClass;
-GESTimelineTransition* ges_timeline_transition_new (void);
-
-typedef struct {
- GESTimelineObjectClass parent_class;
-} GESTimelineTransitionClass;
-
--
-GESTimelineTransition* ges_timeline_transition_new (void);
--
-Returns : |
-- | -
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Implemented Interfaces - | - Properties - | ||||
-#include <ges/ges.h> - - GESTrack; -enum GESTrackType; - GESTrackClass; -GESTrack * ges_track_audio_raw_new (); -GESTrack * ges_track_video_raw_new (); -GESTrack* ges_track_new (-GESTrackType type, -GstCaps *caps); -gboolean ges_track_add_object (GESTrack *track, -GESTrackObject *object); -gboolean ges_track_remove_object (GESTrack *track, -GESTrackObject *object); -void ges_track_set_caps (GESTrack *track, -const GstCaps *caps); -
- "caps" GstCaps* : Read / Write / Construct - "track-type" GESTrackType : Read / Write / Construct Only --
-Corresponds to one output format (i.e. audio OR video). -
--Contains the compatible TrackObject(s). -
--Wraps GNonLin's 'gnlcomposition' element. -
-typedef enum {
- GES_TRACK_TYPE_AUDIO = 0,
- GES_TRACK_TYPE_VIDEO = 1,
- GES_TRACK_TYPE_TEXT = 2,
- GES_TRACK_TYPE_CUSTOM = 3
-} GESTrackType;
-
-
-Types of content handled by a track. If the content is not one of
-GEST_TRACK_TYPE_AUDIO, GES_TRACK_TYPE_VIDEO or GES_TRACK_TYPE_TEXT,
-the user of the GESTrack must set the type to GES_TRACK_TYPE_CUSTOM.
-
GESTrack * ges_track_audio_raw_new ();-
-Creates a new GESTrack of type GES_TRACK_TYPE_AUDIO and with generic -raw audio caps ("audio/x-raw-int;audio/x-raw-float"); -
-Returns : |
-A new GESTrack. - | -
GESTrack * ges_track_video_raw_new ();-
-Creates a new GESTrack of type GES_TRACK_TYPE_VIDEO and with generic -raw video caps ("video/x-raw-yuv;video/x-raw-rgb"); -
-Returns : |
-A new GESTrack. - | -
GESTrack* ges_track_new (-GESTrackType type, -GstCaps *caps);
-Creates a new GESTrack with the given type and caps.
-
-The newly created track will steal a reference to the caps. If you wish to -use those caps elsewhere, you will have to take an extra reference. -
-
|
-The type of track - | -
|
-The caps to restrict the output of the track to. - | -
Returns : |
-A new GESTrack. - | -
gboolean ges_track_add_object (-GESTrack *track, -GESTrackObject *object);
-Adds the given object to the track. -
-
|
-a GESTrack - | -
|
-the GESTrackObject to add - | -
Returns : |
-TRUE if the object was properly added. FALSE if the track does not -want to accept the object. - | -
gboolean ges_track_remove_object (-GESTrack *track, -GESTrackObject *object);
-Removes the object from the track. -
-
|
-a GESTrack - | -
|
-the GESTrackObject to remove - | -
Returns : |
-TRUE if the object was removed, else FALSE if the track -could not remove the object (like if it didn't belong to the track). - | -
"caps" property"caps" GstCaps* : Read / Write / Construct-
-Caps used to filter/choose the output stream. This is generally set to -a generic set of caps like 'video/x-raw-rgb;video/x-raw-yuv' for raw video. -
--Default value: GST_CAPS_ANY. -
-"track-type" property"track-type" GESTrackType : Read / Write / Construct Only-
-Type of stream the track outputs. This is used when creating the GESTrack -to specify in generic terms what type of content will be outputted. -
--It also serves as a 'fast' way to check what type of data will be outputted -from the GESTrack without having to actually check the GESTrack's caps -property. -
-Default value: GES_TRACK_TYPE_CUSTOM
- |
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Properties - | ||||
-#include <ges/ges.h>
-
- GESTrackFileSource;
- GESTrackFileSourceClass;
-GESTrackFileSource* ges_track_filesource_new (gchar *uri);
-
-- GObject - +----GESTrackObject - +----GESTrackSource - +----GESTrackFileSource --
typedef struct {
- GESTrackObjectClass parent_class;
-} GESTrackFileSourceClass;
-
--
-GESTrackFileSource* ges_track_filesource_new (gchar *uri);
--
-
|
-- | -
Returns : |
-- | -
"uri" property"uri" gchar* : Read / Write / Construct Only-
-The location of the file/resource to use. -
-Default value: NULL
- |
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | - Properties - | ||||
-GESTrackObject-GESTrackObject — Base Class for objects contained in a GESTrack - |
-- |
-#include <ges/ges.h> - - GESTrackObject; - GESTrackObjectClass; -#define GES_TRACK_OBJECT_DURATION (obj) -#define GES_TRACK_OBJECT_INPOINT (obj) -#define GES_TRACK_OBJECT_PRIORITY (obj) -#define GES_TRACK_OBJECT_START (obj) -gboolean ges_track_object_set_active (-GESTrackObject *object, -gboolean active); -
- "active" gboolean : Read / Write - "duration" guint64 : Read / Write - "in-point" guint64 : Read / Write - "priority" guint : Read / Write - "start" guint64 : Read / Write --
-GESTrackObject is the Base Class for any object that can be contained in a -GESTrack. -
--It contains the basic information as to the location of the object within -its container, like the start position, the in-point, the duration and the -priority. -
-typedef struct {
- GESTimelineObject *timelineobj;
- GESTrack *track;
-
- gboolean valid;
-
- /* Cached values of the gnlobject properties */
- guint64 start;
- guint64 inpoint;
- guint64 duration;
- guint32 priority;
- gboolean active;
-} GESTrackObject;
-
--The GESTrackObject base class. Only sub-classes can access these fields. -
-GESTimelineObject * |
-The GESTimelineObject to which this object belongs. - | -
GESTrack * |
-The GESTrack in which this object is. - | -
gboolean |
-
-TRUE if the content of the gnlobject is valid.
- |
-
guint64 |
-Position (in nanoseconds) of the object the track. - | -
guint64 |
-in-point (in nanoseconds) of the object in the track. - | -
guint64 |
-Duration of the object - | -
guint32 |
-Priority of the object in the track (0:top priority) - | -
gboolean |
-Whether the object is to be used or not. - | -
typedef struct {
- GObjectClass parent_class;
-
- /* virtual methods for subclasses */
- gboolean (*create_gnl_object) (GESTrackObject * object);
-} GESTrackObjectClass;
-
-
-Subclasses can override the create_gnl_object method to override what type
-of GNonLin object will be created.
-
GObjectClass |
-- | -
| - | method to create the GNonLin container object. - | -
#define GES_TRACK_OBJECT_DURATION(obj) (((GESTrackObject*)obj)->duration) --
-The duration position of the object (in nanoseconds). -
-
|
-a GESTrackObject - | -
#define GES_TRACK_OBJECT_INPOINT(obj) (((GESTrackObject*)obj)->inpoint) --
-The in-point of the object (in nanoseconds). -
-
|
-a GESTrackObject - | -
#define GES_TRACK_OBJECT_PRIORITY(obj) (((GESTrackObject*)obj)->priority) --
-The priority of the object (in nanoseconds). -
-
|
-a GESTrackObject - | -
#define GES_TRACK_OBJECT_START(obj) (((GESTrackObject*)obj)->start) --
-The start position of the object (in nanoseconds). -
-
|
-a GESTrackObject - | -
gboolean ges_track_object_set_active (-GESTrackObject *object, -gboolean active);
-
-
|
-- | -
|
-- | -
Returns : |
-- | -
"active" property"active" gboolean : Read / Write-
-Whether the object should be taken into account in the GEStrack output. -If FALSE, then its contents will not be used in the resulting track. -
-Default value: TRUE
-"duration" property"duration" guint64 : Read / Write-
-The duration (in nanoseconds) which will be used in the container GESTrack -starting from 'in-point'. -
-Default value: 1000000000
-"in-point" property"in-point" guint64 : Read / Write-
-The in-point at which this GESTrackObject will start outputting data -from its contents (in nanoseconds). -
--Ex : an in-point of 5 seconds means that the first outputted buffer will -be the one located 5 seconds in the controlled resource. -
-Default value: 0
-"priority" property"priority" guint : Read / Write-
-The priority of the object within the containing GESTrack.
-If two objects intersect over the same region of time, the priority
-property is used to decide which one takes precedence.
-
-The highest priority (that supercedes everything) is 0, and then lowering -priorities go in increasing numerical value (with G_MAXUINT64 being the -lowest priority). -
-Default value: 0
- |
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | - Object Hierarchy - | ||||
-#include <ges/ges.h>
-
- GESTrackSource;
- GESTrackSourceClass;
-GESTrackSource* ges_track_source_new (void);
-
-- GObject - +----GESTrackObject - +----GESTrackSource - +----GESTrackFileSource --
typedef struct {
- GESTrackObjectClass parent_class;
-} GESTrackSourceClass;
-
--
-GESTrackSource* ges_track_source_new (void);
--
-Returns : |
-- | -
|
-- | |
-GStreamer Editing Services 0.10.0.1 Reference Manual | -- |
|---|---|---|---|---|
| -C - | - F - | - I - | - P - | - S - | - T - | ||||
|
-- | |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|
- The "GStreamer Editing Services" is a library to simplify the creation -of multimedia editing applications. Based on the GStreamer multimedia framework -and the GNonLin set of plugins, its goals are to suit all types of editing-related -applications. -
-- The GStreamer Editing Services are cross-platform and work on most UNIX-like -platform as well as Windows. It is released under the GNU Library General Public License -(GNU LGPL). -
- |
-- | |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|
|
-- | |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|
|
-- | |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|---|---|---|---|
| -Top - | - Description - | ||||
|
- |
- |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|
The GStreamer multimedia framework and the accompanying GNonLin set - of plugins for non-linear editing offer all the building blocks for: -
-Decoding and encoding to a wide variety of formats, through - all the available GStreamer plugins.
Easily choosing segments of streams and arranging them through - time through the GNonLin set of plugins.
But all those building blocks only offer stream-level access, which - results in developers who want to write non-linear editors to write a - consequent amount of code to get to the level of non-linear - editing notions which are closer and more meaningful for the - end-user (and therefore the application).
-The GStreamer Editing Services (hereafter GES) aims - to fill the gap between GStreamer/GNonLin and the application developer by - offering a series of classes to simplify the creation of many kind of - editing-related applications.
-The most top-level object encapsulating every other object is the - GESTimeline. It is the central object - for any editing project.
-The GESTimeline is a
- GstElement. It can therefore be used in any
- GStreamer pipeline like any other object.
The GESTimeline can contain two types of objects (seen in Figure 1, “Layers and Tracks”):
-Layers - Corresponds to the user-visible layout of - non-overlapping objects. A minimalistic timeline would only have - one layer. A more complex editing application could use as many as - needed.
Tracks - Corresponds to the output stream formats. A typical - GESTimeline would have a audio track and a video track. An audio - editor would only require one single audio Track.
In order to reduce even more the amount of GStreamer interaction - the application developer has to deal with , a convenience GstPipeline - has been made available specifically for Timelines : GESTimelinePipeline.
- |
-- | |
-GStreamer Editing Services 0.10.0.1 Reference Manual | - |
-
|---|
- GObject - GstObject - GstElement - GstBin - GstPipeline - GESTimelinePipeline - GESTrack - GESTimeline - GESTrackObject - GESTrackSource - GESTrackFileSource - GESTimelineLayer - GESSimpleTimelineLayer - GESTimelineObject - GESTimelineSource - GESTimelineFileSource - GESCustomTimelineSource - GESTimelineTransition --
GStreamer Editing Services 0.10.0.1 Reference Manual |
|---|
- for GStreamer Editing Services 0.10 (0.10.0.1) -
