The Assets in the GStreamer Editing Services represent the resources that can be used. You can create assets for any type that implements the #GESExtractable interface, for example #GESClips, #GESFormatter, and #GESTrackElement do implement it. This means that assets will represent for example a #GESUriClips, #GESBaseEffect etc, and then you can extract objects of those types with the appropriate parameters from the asset using the #ges_asset_extract method: |[ GESAsset *effect_asset; GESEffect *effect; // You create an asset for an effect effect_asset = ges_asset_request (GES_TYPE_EFFECT, "agingtv", NULL); // And now you can extract an instance of GESEffect from that asset effect = GES_EFFECT (ges_asset_extract (effect_asset)); ]| In that example, the advantages of having a #GESAsset are that you can know what effects you are working with and let your user know about the avalaible ones, you can add metadata to the #GESAsset through the #GESMetaContainer interface and you have a model for your custom effects. Note that #GESAsset management is making easier thanks to the #GESProject class. Each asset is represented by a pair of @extractable_type and @id (string). Actually the @extractable_type is the type that implements the #GESExtractable interface, that means that for example for a #GESUriClip, the type that implements the #GESExtractable interface is #GESClip. The identifier represents different things depending on the @extractable_type and you should check the documentation of each type to know what the ID of #GESAsset actually represents for that type. By default, we only have one #GESAsset per type, and the @id is the name of the type, but this behaviour is overriden to be more useful. For example, for GESTransitionClips, the ID is the vtype of the transition you will extract from it (ie crossfade, box-wipe-rc etc..) For #GESEffect the ID is the @bin-description property of the extracted objects (ie the gst-launch style description of the bin that will be used). Each and every #GESAsset is cached into GES, and you can query those with the #ges_list_assets function. Also the system will automatically register #GESAssets for #GESFormatters and #GESTransitionClips and standard effects (actually not implemented yet) and you can simply query those calling: |[ GList *formatter_assets, *tmp; // List all the transitions formatter_assets = ges_list_assets (GES_TYPE_FORMATTER); // Print some infos about the formatter GESAsset for (tmp = formatter_assets; tmp; tmp = tmp->next) { g_print ("Name of the formatter: %s, file extension it produces: %s", ges_meta_container_get_string (GES_META_CONTAINER (tmp->data), GES_META_FORMATTER_NAME), ges_meta_container_get_string (GES_META_CONTAINER (tmp->data), GES_META_FORMATTER_EXTENSION)); } g_list_free (transition_assets); ]| You can request the creation of #GESAssets using either ges_asset_request() or ges_asset_request_async(). All the #GESAssets are cached and thus any asset that has already been created can be requested again without overhead. Sets an asset from the internal cache as needing reload. An asset needs reload in the case where, for example, we were missing a GstPlugin to use it and that plugin has been installed, or, that particular asset content as changed meanwhile (in the case of the usage of proxies). Once an asset has been set as "needs reload", requesting that asset again will lead to it being re discovered, and reloaded as if it was not in the cache before.

%TRUE if the asset was in the cache and could be set as needing reload, %FALSE otherwise.

The #GType of the object that can be extracted from the asset to be reloaded. The identifier of the asset to mark as needing reload Create a #GESAsset in the most simple cases, you should look at the @extractable_type documentation to see if that constructor can be called for this particular type As it is recommanded not to instanciate assets for GESUriClip synchronously, it will not work with this method, but you can instead use the specific #ges_uri_clip_asset_request_sync method if you really want to.

A reference to the wanted #GESAsset or %NULL

The #GType of the object that can be extracted from the new asset. The Identifier or %NULL The @callback will be called from a running #GMainLoop which is iterating a #GMainContext. Note that, users should ensure the #GMainContext, since this method will notify @callback from the thread which was associated with a thread default #GMainContext at calling ges_init(). For example, if a user wants non-default #GMainContext to be associated with @callback, ges_init() must be called after g_main_context_push_thread_default () with custom #GMainContext. Request a new #GESAsset asyncronously, @callback will be called when the materail is ready to be used or if an error occured. Example of request of a GESAsset async: |[ // The request callback static void asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data) { GESAsset *asset; GError *error = NULL; asset = ges_asset_request_finish (res, &error); if (asset) { g_print ("The file: %s is usable as a FileSource", ges_asset_get_id (asset)); } else { g_print ("The file: %s is *not* usable as a FileSource because: %s", ges_asset_get_id (source), error->message); } gst_object_unref (mfs); } // The request: ges_asset_request_async (GES_TYPE_URI_CLIP, some_uri, NULL, (GAsyncReadyCallback) asset_loaded_cb, user_data); ]|

The #GType of the object that can be extracted from the new asset. The class must implement the #GESExtractable interface. The Identifier of the asset we want to create. This identifier depends of the extractable, type you want. By default it is the name of the class itself (or %NULL), but for example for a GESEffect, it will be the pipeline description, for a GESUriClip it will be the name of the file, etc... You should refer to the documentation of the #GESExtractable type you want to create a #GESAsset for. optional %GCancellable object, %NULL to ignore. a #GAsyncReadyCallback to call when the initialization is finished, Note that the @source of the callback will be the #GESAsset, but you need to make sure that the asset is properly loaded using the #ges_asset_request_finish method. This asset can not be used as is. The user data to pass when @callback is called Finalize the request of an async #GESAsset

The #GESAsset previously requested

The #GAsyncResult from which to get the newly created #GESAsset

Extracts a new #GObject from @asset. The type of the object is defined by the extractable-type of @asset, you can check what type will be extracted from @asset using #ges_asset_get_extractable_type

A newly created #GESExtractable

The #GESAsset to get extract an object from

Extracts a new #GObject from @asset. The type of the object is defined by the extractable-type of @asset, you can check what type will be extracted from @asset using #ges_asset_get_extractable_type

A newly created #GESExtractable

The #GESAsset to get extract an object from

The #GError of the asset or %NULL if the asset was loaded without issue

The asset to retrieve the error from

Gets the type of object that can be extracted from @self

the type of object that can be extracted from @self

The #GESAsset

Gets the ID of a #GESAsset

The ID of @self

The #GESAsset to get ID from

The proxy in use for @asset

The #GESAsset to get currenlty used proxy

The #GESAsset that is proxied by @proxy

The #GESAsset from which to get the the asset it proxies.

The list of proxies @asset has. Note that the default asset to be used is always the first in that list.

The #GESAsset to get proxies from

A proxying asset is an asset that can substitue the real @asset. For example if you have a full HD #GESUriClipAsset you might want to set a lower resolution (HD version of the same file) as proxy. Note that when an asset is proxied, calling #ges_asset_request will actually return the proxy asset.

%TRUE if @proxy has been set on @asset, %FALSE otherwise.

The #GESAsset to set proxy on

The #GESAsset that should be used as default proxy for @asset or %NULL if you want to use the currently set proxy. Note that an asset can proxy one and only one other asset. Removes @proxy from the list of known proxies for @asset. If @proxy was the current proxy for @asset, stop using it.

%TRUE if @proxy was a known proxy for @asset, %FALSE otherwise.

The #GESAsset to stop proxying with @proxy

The #GESAsset to stop considering as a proxy for @asset

A newly created #GESExtractable

The #GESAsset to get extract an object from

## Children Properties You can use the following children properties through the #ges_track_element_set_child_property and alike set of methods: <informaltable frame="none"> <tgroup cols="3"> <colspec colname="properties_type" colwidth="150px"/> <colspec colname="properties_name" colwidth="200px"/> <colspec colname="properties_flags" colwidth="400px"/> <tbody> <row> <entry role="property_type"><link linkend="gdouble"><type>double</type></link></entry> <entry role="property_name"><link linkend="GESAudioSource--volume">volume</link></entry> <entry>volume factor, 1.0=100%.</entry> </row> <row> <entry role="property_type"><link linkend="gboolean"><type>gboolean</type></link></entry> <entry role="property_name"><link linkend="GESAudioSource--mute">mute</link></entry> <entry>mute channel.</entry> </row> </tbody> </tgroup> </informaltable>

Outputs a test audio stream using audiotestsrc. The default property values output silence. Useful for testing pipelines, or to fill gaps in an audio track. Get the current frequency of @self.

The current frequency of @self.

a #GESAudioTestSource

Get the current volume of @self.

The current volume of @self

a #GESAudioTestSource

Lets you set the frequency applied on the track element

a #GESAudioTestSource

The frequency you want to apply on @self Sets the volume of the test audio signal.

a #GESAudioTestSource

The volume you want to apply on @self Sane default properties to specify and fixate the output stream are set as restriction-caps. It is advised, to modify these properties, to use #ges_track_update_restriction_caps, setting them directly is possible through #ges_track_set_restriction_caps, but not specifying one of them can lead to negotiation issues, only use that function if you actually know what you're doing :) The default properties are: - format: S32LE - channels: 2 - rate: 44100 - layout: interleaved Creates a new #GESAudioTrack of type #GES_TRACK_TYPE_AUDIO and with generic raw audio caps ("audio/x-raw");

A new #GESTrack

Creates a new #GESAudioTransition.

The newly created #GESAudioTransition.

The location of the file/resource to use. parent class The effect will be applied on the sources that have lower priorities (higher number) between the inpoint and the end of it.

A #GESClip is a 'natural' object which controls one or more #GESTrackElement(s) in one or more #GESTrack(s). Keeps a reference to the #GESTrackElement(s) it created and sets/updates their properties.

the #GESTrackElement to be used, or %NULL if it can't provide one for the given @track.

a #GESClip

a #GESTrackType

%TRUE on success %FALSE on failure.

a #GESClip

a #GESTrackType

Extracts a #GESTrackElement from @asset and adds it to the @clip. Should only be called in order to add operations to a #GESClip, ni other cases TrackElement are added automatically when adding the #GESClip/#GESAsset to a layer. Takes a reference on @track_element.

Created #GESTrackElement or NULL if an error happened

a #GESClip

a #GESAsset with #GES_TYPE_TRACK_ELEMENT as extractable_type Finds the #GESTrackElement controlled by @clip that is used in @track. You may optionally specify a GType to further narrow search criteria. Note: If many objects match, then the one with the highest priority will be returned.

The #GESTrackElement used by @track, else %NULL. Unref after usage

a #GESClip

a #GESTrack or NULL a #GType indicating the type of track element you are looking for or %G_TYPE_NONE if you do not care about the track type. Finds all the #GESTrackElement controlled by @clip that is used in @track. You may optionally specify a GType to further narrow search criteria.

a #GList of the #GESTrackElement contained in @clip. The refcount of the objects will be increased. The user will have to unref each #GESTrackElement and free the #GList.

a #GESClip

a #GESTrack or NULL a #GESTrackType indicating the type of tracks in which elements should be searched. a #GType indicating the type of track element you are looking for or %G_TYPE_NONE if you do not care about the track type. Get the #GESLayer to which this clip belongs.

The #GESLayer where this @clip is being used, or %NULL if it is not used on any layer. The caller should unref it usage.

a #GESClip

Get the formats supported by @clip.

The formats supported by @clip.

the #GESClip

Gets the index position of an effect.

The top index of the effect, -1 if something went wrong.

The origin #GESClip

The #GESBaseEffect we want to get the top index from

Get effects applied on @clip

a #GList of the #GESBaseEffect that are applied on @clip order by ascendant priorities. The refcount of the objects will be increased. The user will have to unref each #GESBaseEffect and free the #GList.

The origin #GESClip

Moves @clip to @layer. If @clip is not in any layer, it adds it to @layer, else, it removes it from its current layer, and adds it to @layer.

%TRUE if @clip could be moved %FALSE otherwize

a #GESClip

the new #GESLayer Sets the formats supported by the file.

the #GESClip to set supported formats on

the #GESTrackType defining formats supported by @clip This is a convenience method that lets you set the index of a top effect.

%TRUE if @effect was successfuly moved, %FALSE otherwise.

The origin #GESClip

The #GESBaseEffect to move the new index at which to move the @effect inside this #GESClip

The function modifies @clip, and creates another #GESClip so we have two clips at the end, splitted at the time specified by @position, as a position in the timeline (not in the clip to be split). For example, if ges_clip_split is called on a 4-second clip playing from 0:01.00 until 0:05.00, with a split position of 0:02.00, this will result in one clip of 1 second and one clip of 3 seconds, not in two clips of 2 seconds. The newly created clip will be added to the same layer as @clip is in. This implies that @clip must be in a #GESLayer for the operation to be possible. This method supports clips playing at a different tempo than one second per second. For example, splitting a clip with a #GESEffect 'pitch tempo=1.5' four seconds after it starts, will set the inpoint of the new clip to six seconds after that of the clip to split. For this, the rate-changing property must be registered using @ges_effect_class_register_rate_property; for the 'pitch' plugin, this is already done.

The newly created #GESClip resulting from the splitting or %NULL if the clip can't be split.

the #GESClip to split

a #GstClockTime representing the timeline position at which to split The GESLayer where this clip is being used. If you want to connect to its notify signal you should connect to it with g_signal_connect_after as the signal emission can be stop in the first fase. The formats supported by the clip. The #GESUriClipAsset is a special #GESAsset specilized in #GESClip. it is mostly used to get information about the #GESTrackType-s the objects extracted from it can potentialy create #GESTrackElement for. Gets track types for which objects extracted from @self can create #GESTrackElement

The track types on which @self will create TrackElement when added to a layer

a #GESClipAsset

Sets track types for which objects extracted from @self can create #GESTrackElement

a #GESClipAsset

The track types supported by the GESClipAsset The formats supported by the asset. Subclasses can override the @create_track_element. method to create a single #GESTrackElement for a given #GESTrack. method to create multiple #GESTrackElements for a #GESTrack.

The #GESContainer base class. Groups the #GESContainer-s provided in @containers. It creates a subclass of #GESContainer, depending on the containers provided in @containers. Basically, if all the containers in @containers should be contained in a same clip (all the #GESTrackElement they contain have the exact same start/inpoint/duration and are in the same layer), it will create a #GESClip otherwise a #GESGroup will be created

The #GESContainer (subclass) resulting of the grouping

The #GESContainer to group, they must all be in a same #GESTimeline

Edit @container in the different exisiting #GESEditMode modes. In the case of slide, and roll, you need to specify a #GESEdge

%TRUE if the container as been edited properly, %FALSE if an error occured

the #GESClip to edit

The layers you want the edit to happen in, %NULL means that the edition is done in all the #GESLayers contained in the current timeline. The priority of the layer @container should land in. If the layer you're trying to move the container to doesn't exist, it will be created automatically. -1 means no move. The #GESEditMode in which the editition will happen. The #GESEdge the edit should happen on. The position at which to edit @container (in nanosecond)

Ungroups the #GESTimelineElement contained in this GESContainer, creating new #GESContainer containing those #GESTimelineElement apropriately.

The list of #GESContainer resulting from the ungrouping operation The user is responsible for unreffing the contained objects and freeing the list.

The #GESContainer to ungroup

Wether to recursively ungroup @container

Add the #GESTimelineElement to the container.

%TRUE on success, %FALSE on failure.

a #GESContainer

the #GESTimelineElement Edit @container in the different exisiting #GESEditMode modes. In the case of slide, and roll, you need to specify a #GESEdge

%TRUE if the container as been edited properly, %FALSE if an error occured

the #GESClip to edit

The list of timeline element contained in @container.

a #GESContainer

Whether to recursively get children in @container Release the @child from the control of @container.

%TRUE if the @child was properly released, else %FALSE.

a #GESContainer

the #GESTimelineElement to release Ungroups the #GESTimelineElement contained in this GESContainer, creating new #GESContainer containing those #GESTimelineElement apropriately.

The list of #GESContainer resulting from the ungrouping operation The user is responsible for unreffing the contained objects and freeing the list.

The #GESContainer to ungroup

Wether to recursively ungroup @container The span of priorities which this container occupies. A list of TimelineElement controlled by this Container. NOTE: Do not modify. The span of priorities this container occupies Will be emitted after a child was added to @container. Usually you should connect with #g_signal_connect_after as in the first emission stage, the signal emission might get stopped internally.

the #GESTimelineElement that was added. Will be emitted after a child was removed from @container.

the #GESTimelineElement that was removed.

The list of #GESContainer resulting from the ungrouping operation The user is responsible for unreffing the contained objects and freeing the list.

The #GESContainer to ungroup Wether to recursively ungroup @container

%TRUE if the container as been edited properly, %FALSE if an error occured

the #GESClip to edit The layers you want the edit to happen in, %NULL means that the edition is done in all the #GESLayers contained in the current timeline. The priority of the layer @container should land in. If the layer you're trying to move the container to doesn't exist, it will be created automatically. -1 means no move. The #GESEditMode in which the editition will happen. The #GESEdge the edit should happen on. The position at which to edit @container (in nanosecond) A function that will be called to create the #GstElement that will be used as a source to fill the gaps in @track.

A #GstElement (must be a source) that will be used to fill the gaps (periods of time in @track that containes no source).

the #GESTrack Creates the 'primary' track element for this @clip. Subclasses should implement this method if they only provide a single #GESTrackElement per track. If the subclass needs to create more than one #GESTrackElement for a given track, then it should implement the 'create_track_elements' method instead. The implementer of this function shall return the proper #GESTrackElement that should be controlled by @clip for the given @track. The returned #GESTrackElement will be automatically added to the list of objects controlled by the #GESClip.

the #GESTrackElement to be used, or %NULL if it can't provide one for the given @track.

a #GESClip a #GESTrackType Create all track elements this clip handles for this type of track. Subclasses should implement this method if they potentially need to return more than one #GESTrackElement(s) for a given #GESTrack.

%TRUE on success %FALSE on failure.

a #GESClip a #GESTrackType The edges of an object contain in a #GESTimeline or #GESTrack Represents the start of an object. Represents the end of an object. Represent the fact we are not workin with any edge of an object.

You can also find more explanation about the behaviour of those modes at: <ulink url="http://pitivi.org/manual/trimming.html"> trim, ripple and roll</ulink> and <ulink url="http://pitivi.org/manual/usingclips.html">clip management</ulink>. The object is edited the normal way (default). The objects are edited in ripple mode. The Ripple mode allows you to modify the beginning/end of a clip and move the neighbours accordingly. This will change the overall timeline duration. In the case of ripple end, the duration of the clip being rippled can't be superior to its max_duration - inpoint otherwise the action won't be executed. The object is edited in roll mode. The Roll mode allows you to modify the position of an editing point between two clips without modifying the inpoint of the first clip nor the out-point of the second clip. This will not change the overall timeline duration. The object is edited in trim mode. The Trim mode allows you to modify the in-point/duration of a clip without modifying its position in the timeline. The object is edited in slide mode. The Slide mode allows you to modify the position of a clip in a timeline without modifying its duration or its in-point, but will modify the duration of the previous clip and in-point of the following clip so does not modify the overall timeline duration. (not implemented yet) Creates a new #GESEffect from the description of the bin. It should be possible to determine the type of the effect through the element 'klass' metadata of the GstElements that will be created. In that corner case, you should use: #ges_asset_request (GES_TYPE_EFFECT, "audio your ! bin ! description", NULL); and extract that asset to be in full control.

a newly created #GESEffect, or %NULL if something went wrong.

The gst-launch like bin description of the effect The description of the effect bin with a gst-launch-style pipeline description. Example: "videobalance saturation=1.5 hue=+0.5" parent class Register an element that can change the rate at which media is playing. The property type must be float or double, and must be a factor of the rate, i.e. a value of 2.0 must mean that the media plays twice as fast. For example, this is true for the properties 'rate' and 'tempo' of the element 'pitch', which is already registered by default. By registering the element, timeline duration can be correctly converted into media duration, allowing the right segment seeks to be sent to the sources. A reference to the GESEffectClass can be obtained as follows: GES_EFFECT_CLASS (g_type_class_ref (GES_TYPE_EFFECT));

whether the rate property was succesfully registered. When this method returns false, a warning is emitted with more information.

Instance of the GESEffectClass

Name of the GstElement that changes the rate Name of the property that changes the rate The effect will be applied on the sources that have lower priorities (higher number) between the inpoint and the end of it. Creates a new #GESEffectClip from the description of the bin.

a newly created #GESEffectClip, or %NULL if something went wrong.

The gst-launch like bin description of the effect The gst-launch like bin description of the effect The description of the audio track of the effect bin with a gst-launch-style pipeline description. This should be used for test purposes. Example: "audiopanorama panorama=1.0" The description of the video track of the effect bin with a gst-launch-style pipeline description. This should be used for test purposes. Example: "videobalance saturation=1.5 hue=+0.5" The ID passed is malformed An error happened while loading the asset The formatted files was malformed FIXME: Long description needed

The #id of the associated #GESAsset, free with #g_free

The #GESExtractable

Method for getting an asset from a #GESExtractable

The #GESAsset or %NULL if none has been set

The #GESExtractable from which to retrieve a #GESAsset

The #id of the associated #GESAsset, free with #g_free

The #GESExtractable

Method to set the asset which instantiated the specified object

%TRUE if @asset could be set %FALSE otherwize

Target object

The #GESAsset to set

The ID to use for the asset or %NULL if @id is not valid

The #GType to check @id for: The id to check

The #id of the associated #GESAsset, free with #g_free

The #GESExtractable

A function that will be called when the GNonLin object of a corresponding track element needs to be filled. The implementer of this function shall add the proper #GstElement to @nleobj using gst_bin_add().

TRUE if the implementer succesfully filled the @nleobj, else #FALSE.

the #GESClip controlling the track elements the #GESTrackElement the GNonLin object that needs to be filled. Base class for timeline data serialization and deserialization. Checks if there is a #GESFormatter available which can load a #GESTimeline from the given URI.

TRUE if there is a #GESFormatter that can support the given uri or FALSE if not.

a #gchar * pointing to the URI Returns TRUE if there is a #GESFormatter available which can save a #GESTimeline to the given URI.

TRUE if the given @uri is supported, else FALSE.

a #gchar * pointing to a URI Get the default #GESAsset to use as formatter. It will return the asset for the #GESFormatter that has the highest @rank

The #GESAsset for the formatter with highest @rank

Load data from the given URI into timeline.

TRUE if the timeline data was successfully loaded from the URI, else FALSE.

a #GESFormatter

a #GESTimeline a #gchar * pointing to a URI

Save data from timeline to the given URI.

TRUE if the timeline data was successfully saved to the URI else FALSE.

a #GESFormatter

a #GESTimeline a #gchar * pointing to a URI %TRUE to overwrite file if it exists

Load data from the given URI into timeline.

TRUE if the timeline data was successfully loaded from the URI, else FALSE.

a #GESFormatter

a #GESTimeline a #gchar * pointing to a URI Save data from timeline to the given URI.

TRUE if the timeline data was successfully saved to the URI else FALSE.

a #GESFormatter

a #GESTimeline a #gchar * pointing to a URI %TRUE to overwrite file if it exists

GES Formatter class. Override the vmethods to implement the formatter functionnality. the parent class structure Whether the URI can be loaded class method to deserialize data from a URI class method to serialize data to a URI

Virtual method for loading a timeline from a given URI. Every #GESFormatter subclass needs to implement this method.

Use @ges_timeline_load_from_uri

TRUE if the timeline data was successfully loaded from the URI, else FALSE.

a #GESFormatter a #GESTimeline a #gchar * pointing to a URI Virtual method for saving a timeline to a uri. Every #GESFormatter subclass needs to implement this method.

Use @ges_timeline_save_to_uri

TRUE if the timeline data was successfully saved to the URI else FALSE.

a #GESFormatter a #GESTimeline a #gchar * pointing to a URI %TRUE to overwrite file if it exists A #GESGroup is an object which controls one or more #GESClips in one or more #GESLayer(s). To instanciate a group, you should use the ges_container_group method, this will be responsible for deciding what subclass of #GESContainer should be instaciated to group the various #GESTimelineElement passed in parametter. Created a new empty #GESGroup, if you want to group several container together, it is recommanded to use the #ges_container_group method so the proper subclass is selected.

The new empty group.

The duration (in nanoseconds) which will be used in the container The in-point at which this #GESGroup 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. The maximum duration (in nanoseconds) of the #GESGroup. The position of the object in its container (in nanoseconds). Outputs the video stream from a given file as a still frame. The frame chosen will be determined by the in-point property on the track element. For image files, do not set the in-point property. The location of the file/resource to use. Responsible for the ordering of the various contained Clip(s). A timeline layer has a "priority" property, which is used to manage the priorities of individual Clips. Two layers should not have the same priority within a given timeline. Creates a new #GESLayer.

A new #GESLayer

Creates Clip from asset, adds it to layer and returns a reference to it.

Created #GESClip

a #GESLayer

The asset to add to The start value to set on the new #GESClip, if @start == GST_CLOCK_TIME_NONE, it will be set to the current duration of @layer The inpoint value to set on the new #GESClip The duration value to set on the new #GESClip The #GESTrackType to set on the the new #GESClip Adds the given clip to the layer. Sets the clip's parent, and thus takes ownership of the clip. An clip can only be added to one layer. Calling this method will construct and properly set all the media related elements on @clip. If you need to know when those objects (actually #GESTrackElement) are constructed, you should connect to the container::child-added signal which is emited right after those elements are ready to be used.

%TRUE if the clip was properly added to the layer, or %FALSE if the @layer refuses to add the clip.

a #GESLayer

the #GESClip to add. Gets whether transitions are automatically added when objects overlap or not.

%TRUE if transitions are automatically added, else %FALSE.

a #GESLayer

Get the clips this layer contains.

a #GList of clips. The user is responsible for unreffing the contained objects and freeing the list.

a #GESLayer

Gets the clips which appear between @start and @end on @layer.

a #GList of clips intersecting [@start, @end) interval on @layer.

a #GESLayer

start of the interval end of the interval Lets you retrieve the duration of the layer, which means the end time of the last clip inside it

The duration of a layer

The #GESLayer to get the duration from

Get the priority of @layer within the timeline.

The priority of the @layer within the timeline.

a #GESLayer

Get the #GESTimeline in which #GESLayer currently is.

the #GESTimeline in which #GESLayer currently is or %NULL if not in any timeline yet.

The #GESLayer to get the parent #GESTimeline from

Convenience method to check if @layer is empty (doesn't contain any clip), or not.

%TRUE if @layer is empty, %FALSE if it already contains at least one #GESClip

The #GESLayer to check

Removes the given @clip from the @layer and unparents it. Unparenting it means the reference owned by @layer on the @clip will be removed. If you wish to use the @clip after this function, make sure you call gst_object_ref() before removing it from the @layer.

%TRUE if the clip could be removed, %FALSE if the layer does not want to remove the clip.

a #GESLayer

the #GESClip to remove Sets the layer to the given @auto_transition. See the documentation of the property auto_transition for more information.

a #GESLayer

whether the auto_transition is active Sets the layer to the given @priority. See the documentation of the priority property for more information.

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.

a #GESLayer

the priority to set

Sets whether transitions are added automagically when clips overlap. The priority of the layer in the #GESTimeline. 0 is the highest priority. Conceptually, a #GESTimeline is a stack of GESLayers, and the priority of the layer represents its position in the stack. Two layers should not have the same priority within a given GESTimeline. Note that the timeline needs to be commited (with #ges_timeline_commit) for the change to be taken into account.

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.

the #GESTimeline where this layer is being used. Will be emitted after the clip was added to the layer.

the #GESClip that was added. Will be emitted after the clip was removed from the layer.

the #GESClip that was removed Subclasses can override the @get_objects if they can provide a more efficient way of providing the list of contained #GESClip(s).

The description of an object, can be used in various context (string) The description The extension of the files produced by a formatter (string) Mimetype used for the file produced by a formatter (string) The mime type Name of a formatter it is used as ID of Formater assets (string) The name of the formatter The rank of a formatter (GstRank) The rank of a formatter The version of a formatter (double) The formatter version The version of the format in which a project is serialized The volume, can be used for audio track or layers The volume for a track or a layer, it is register as a float The default volume The default volume for a track or a layer as a float Interface that allows reading and writing meta Deserializes a meta container.

TRUE on success, FALSE if there was an error.

Target container

a string created with ges_meta_container_metas_to_string()

Calls the given function for each metadata inside the meta container. Note that if there is no metadata, the function won't be called at all.

container to iterate over

function to be called for each metadata user specified data Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns %FALSE if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns %FALSE if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns NULL if @key can not be found.

the #GValue corresponding to the meta with the given @key.

Target container

The key name of the meta to retrieve Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Gets the value of a given meta item, returns NULL if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Gets the value of a given meta item, returns %FALSE if @meta_item can not be found.

Target container

Name of the meta item to get Destination to which value of meta item will be copied Serializes a meta container to a string.

a newly-allocated string, or NULL in case of an error. The string must be freed with g_free() when no longer needed.

a #GESMetaContainer

Sets a static meta on @container. This method lets you define static metadatas, which means that the type of the registered will be the only type accepted for this meta on that particular @container.

%TRUE if the static meta could be added, %FALSE otherwise

Target container

The #GESMetaFlag to be used Name of the meta item to set Value to set Sets a static meta on @container. This method lets you define static metadatas, which means that the type of the registered will be the only type accepted for this meta on that particular @container.

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

%TRUE if the meta could be registered, %FALSE otherwise

Target container

The #GESMetaFlag to be used Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set Sets the value of a given meta item

%TRUE if the meta could be added, %FALSE otherwise

Target container

Name of the meta item to set Value to set

The metadata is readable The metadata is writable The metadata is readable and writable

Outputs the video stream from a given image sequence. The start frame chosen will be determined by the in-point property on the track element. Creates a new #GESMultiFileSource for the provided @uri.

A new #GESMultiFileSource.

the URI the source should control The uri of the file/resource to use. You can set a start index, a stop index and a sequence pattern. The format is <multifile://start:stop\@location-pattern>. The pattern uses printf string formating. Example uris: multifile:///home/you/image\%03d.jpg multifile://20:50@/home/you/sequence/\%04d.png Base class for overlays, transitions, and effects Operations are any kind of object that both outputs AND consumes data. Overlays are objects which modify the underlying layer(s). Examples of overlays include text, image watermarks, or audio dubbing. Transitions, which change from one source to another over time, are not considered overlays. parent class #GESPipeline allows developers to view and render #GESTimeline in a simple fashion. Its usage is inspired by the 'playbin' element from gst-plugins-base. Creates a new conveninence #GESPipeline.

the new #GESPipeline.

the #GESPipelineFlags currently in use.

a #GESPipeline

Returns a #GstSample with the currently playing image in the format specified by caps. The caller should free the sample with #gst_sample_unref when finished. If ANY caps are specified, the information will be returned in the whatever format is currently used by the sink. This information can be retrieve from caps associated with the buffer.

a #GstSample or %NULL

a #GESPipeline in %GST_STATE_PLAYING or %GST_STATE_PAUSED

caps specifying current format. Use %GST_CAPS_ANY for native size. A convenience method for @ges_pipeline_get_thumbnail which returns a buffer in 24-bit RGB, optionally scaled to the specified width and height. If -1 is specified for either dimension, it will be left at native size. You can retreive this information from the caps associated with the buffer. The caller is responsible for unreffing the returned sample with #gst_sample_unref.

a #GstSample or %NULL

a #GESPipeline in %GST_STATE_PLAYING or %GST_STATE_PAUSED

the requested width or -1 for native size the requested height or -1 for native size Obtains a pointer to playsink's audio sink element that is used for displaying audio when the #GESPipeline is in %GES_PIPELINE_MODE_PREVIEW The caller is responsible for unreffing the returned element with #gst_object_unref.

a pointer to the playsink audio sink #GstElement

a #GESPipeline

Obtains a pointer to playsink's video sink element that is used for displaying video when the #GESPipeline is in %GES_PIPELINE_MODE_PREVIEW The caller is responsible for unreffing the returned element with #gst_object_unref.

a pointer to the playsink video sink #GstElement

a #GESPipeline

Sets playsink's audio sink element that is used for displaying audio when the #GESPipeline is in %GES_PIPELINE_MODE_PREVIEW

a #GESPipeline in %GST_STATE_NULL

a audio sink #GstElement Sets playsink's video sink element that is used for displaying video when the #GESPipeline is in %GES_PIPELINE_MODE_PREVIEW

a #GESPipeline in %GST_STATE_NULL

a video sink #GstElement Saves the current frame to the specified @location.

%TRUE if the thumbnail was properly save, else %FALSE.

a #GESPipeline in %GST_STATE_PLAYING or %GST_STATE_PAUSED

the requested width or -1 for native size the requested height or -1 for native size a string specifying the desired mime type (for example, image/jpeg) the path to save the thumbnail switches the @pipeline to the specified @mode. The default mode when creating a #GESPipeline is #GES_PIPELINE_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.

%TRUE if the mode was properly set, else %FALSE.

a #GESPipeline

the #GESPipelineFlags to use Specify where the pipeline shall be rendered and with what settings. A copy of @profile and @output_uri will be done internally, the caller can safely free those values afterwards. This method must be called before setting the pipeline mode to #GES_PIPELINE_MODE_RENDER

%TRUE if the settings were aknowledged properly, else %FALSE

a #GESPipeline

the URI to which the timeline will be rendered the #GstEncodingProfile to use to render the timeline. Sets the timeline to use in this pipeline. The reference to the @timeline will be stolen by the @pipeline.

%TRUE if the @timeline could be successfully set on the @pipeline, else %FALSE.

a #GESPipeline

the #GESTimeline to set on the @pipeline. Audio sink for the preview. Pipeline mode. See ges_pipeline_set_mode() for more info. Timeline to use in this pipeline. See also ges_pipeline_set_timeline() for more info. Video sink for the preview. parent class The various modes the #GESPipeline 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) This is a legacy format and you should avoid to use it. The formatter is really not in good shape and is deprecated.

The #GESProject is used to control a set of #GESAsset and is a #GESAsset with #GES_TYPE_TIMELINE as @extractable_type itself. That means that you can extract #GESTimeline from a project as followed: |[ GESProject *project; GESTimeline *timeline; project = ges_project_new ("file:///path/to/a/valid/project/uri"); // Here you can connect to the various signal to get more infos about // what is happening and recover from errors if possible ... timeline = ges_asset_extract (GES_ASSET (project)); ]| The #GESProject class offers a higher level API to handle #GESAsset-s. It lets you request new asset, and it informs you about new assets through a set of signals. Also it handles problem such as missing files/missing #GstElement and lets you try to recover from those. Creates a new #GESProject and sets its uri to @uri if provided. Note that if @uri is not valid or %NULL, the uri of the project will then be set the first time you save the project. If you then save the project to other locations, it will never be updated again and the first valid URI is the URI it will keep refering to.

A newly created #GESProject

The uri to be set after creating the project.

Adds a #Asset to @project, the project will keep a reference on @asset.

%TRUE if the asset could be added %FALSE it was already in the project

A #GESProject

A #GESAsset to add to @project Adds @profile to the project. It lets you save in what format the project has been renders and keep a reference to those formats. Also, those formats will be saves to the project file when possible.

%TRUE if @profile could be added, %FALSE otherwize

A #GESProject

A #GstEncodingProfile to add to the project. If a profile with the same name already exists, it will be replaced Create and add a #GESAsset to @project. You should connect to the "asset-added" signal to get the asset when it finally gets added to @project

%TRUE if the asset started to be added %FALSE it was already in the project

A #GESProject

The id of the asset to create and add to @project The #GType of the asset to create Create and add a #GESAsset to @project. You should connect to the "asset-added" signal to get the asset when it finally gets added to @project

The newly created #GESAsset or %NULL.

A #GESProject

The id of the asset to create and add to @project The #GType of the asset to create

The #GESAsset with @id or %NULL if no asset with @id as an ID

A #GESProject

The id of the asset to retrieve The extractable_type of the asset to retrieve from @object Get the assets that are being loaded

A set of loading asset that will be added to @project. Note that those Asset are *not* loaded yet, and thus can not be used

A #GESProject

Retrieve the uri that is currently set on @project

a newly allocated string representing uri.

A #GESProject

List all @asset contained in @project filtering per extractable_type as defined by @filter. It copies the asset and thus will not be updated in time.

The list of #GESAsset the object contains

A #GESProject

Type of assets to list, #GES_TYPE_EXTRACTABLE will list all assets Lists the encoding profile that have been set to @project. The first one is the latest added.

The list of #GstEncodingProfile used in @project

A #GESProject

Loads @project into @timeline

%TRUE if the project could be loaded %FALSE otherwize.

A #GESProject that has an @uri set already

A blank timeline to load @project into remove a @asset to from @project.

%TRUE if the asset could be removed %FALSE otherwise

A #GESProject

A #GESAsset to remove from @project Save the timeline of @project to @uri. You should make sure that @timeline is one of the timelines that have been extracted from @project (using ges_asset_extract (@project);)

%TRUE if the project could be save, %FALSE otherwize

A #GESProject to save

The #GESTimeline to save, it must have been extracted from @project The uri where to save @project and @timeline The formatter asset to use or %NULL. If %NULL, will try to save in the same format as the one from which the timeline as been loaded or default to the formatter with highest rank %TRUE to overwrite file if it exists

The #GESAsset that has been added to @project

The #GESAsset that started loading

The #GESAsset that has been removed from @project Informs you that a #GESAsset could not be created. In case of missing GStreamer plugins, the error will be set to #GST_CORE_ERROR #GST_CORE_ERROR_MISSING_PLUGIN

The #GError defining the error that occured, might be %NULL The @id of the asset that failed loading The @extractable_type of the asset that failed loading

The #GESTimeline that complete loading |[ static gchar source_moved_cb (GESProject *project, GError *error, GESAsset *asset_with_error) { return g_strdup ("file:///the/new/uri.ogg"); } static int main (int argc, gchar ** argv) { GESTimeline *timeline; GESProject *project = ges_project_new ("file:///some/uri.xges"); g_signal_connect (project, "missing-uri", source_moved_cb, NULL); timeline = ges_asset_extract (GES_ASSET (project)); } ]|

The new URI of @wrong_asset

The error that happened The asset with the wrong ID, you should us it and its content only to find out what the new location is.

Base class for single-media sources Base class for sources of a #GESLayer Layer priority when the element is not in a layer Useful for testing purposes. You can use the ges_asset_request_simple API to create an Asset capable of extracting GESTestClip-s Creates a new #GESTestClip.

The newly created #GESTestClip, or %NULL if there was an error.

Creates a new #GESTestClip for the provided @nick.

The newly created #GESTestClip, or %NULL if there was an error.

the nickname for which to create the #GESTestClip Get the frequency @self generates.

The frequency @self generates. See audiotestsrc element.

a #GESTestClip

Get the volume of the test audio signal applied on @self.

The volume of the test audio signal applied on @self.

a #GESTestClip

Get the #GESVideoTestPattern which is applied on @self.

The #GESVideoTestPattern which is applied on @self.

a #GESTestClip

Let you know if the audio track of @self is muted or not.

Whether the audio track of @self is muted or not.

a #GESTestClip

Sets the frequency to generate. See audiotestsrc element.

the #GESTestClip to set the frequency on

the frequency you want to use on @self Sets whether the audio track of this clip is muted or not.

the #GESTestClip on which to mute or unmute the audio track

%TRUE to mute the audio track, %FALSE to unmute it Sets the volume of the test audio signal.

the #GESTestClip to set the volume on

the volume of the audio signal you want to use on @self Sets which video pattern to display on @self.

the #GESTestClip to set the pattern on

the #GESVideoTestPattern to use on @self The frequency to generate for audio track elements. Whether the sound will be played or not. The volume for the audio track elements. Video pattern to display in video track elements. Horizontal alignment of the text. align text left align text center align text right align text on xpos position Creates a new #GESTextOverlay.

The newly created #GESTextOverlay or %NULL if something went wrong.

Get the color used by @source.

The color used by @source.

a GESTextOverlay

Get the pango font description currently set on @source.

The pango font description currently set on @source.

a GESTextOverlay

Get the horizontal aligment used by @source.

The horizontal aligment used by @source.

a GESTextOverlay

Get the text currently set on @source.

The text currently set on @source.

a GESTextOverlay

Get the vertical aligment used by @source.

The vertical aligment used by @source.

a GESTextOverlay

Get the horizontal position used by @source.

The horizontal position used by @source.

a GESTextOverlay

Get the vertical position used by @source.

The vertical position used by @source.

a GESTextOverlay

Sets the color of the text.

the #GESTextOverlay* to set

The color @self is being set to Sets the pango font description of the text this track element will render.

the #GESTextOverlay

the pango font description Sets the horizontal aligment of the text.

the #GESTextOverlay* to set text on

The #GESTextHAlign defining the horizontal alignment of the text render by @self. Sets the text this track element will render.

the #GESTextOverlay* to set text on

the text to render. an internal copy of this text will be made. Sets the vertical aligment of the text.

the #GESTextOverlay* to set text on

The #GESTextVAlign defining the vertical alignment of the text render by @self. Sets the horizontal position of the text.

the #GESTextOverlay* to set

The horizontal position @self is being set to Sets the vertical position of the text.

the #GESTextOverlay* to set

The vertical position @self is being set to Renders text onto the next lower priority stream using textrender. Creates a new #GESTextOverlayClip

The newly created #GESTextOverlayClip, or %NULL if there was an error.

Get the color used by @source.

The color used by @source.

a #GESTextOverlayClip

Get the pango font description used by @self.

The pango font description used by @self.

a #GESTextOverlayClip

Get the horizontal aligment used by @self.

The horizontal aligment used by @self.

a #GESTextOverlayClip

Get the text currently set on @self.

The text currently set on @self.

a #GESTextOverlayClip

Get the vertical aligment used by @self.

The vertical aligment used by @self.

a #GESTextOverlayClip

Get the horizontal position used by @source.

The horizontal position used by @source.

a #GESTextOverlayClip

Get the vertical position used by @source.

The vertical position used by @source.

a #GESTextOverlayClip

Sets the color of the text.

the #GESTextOverlayClip* to set

The color @self is being set to Sets the pango font description of the text

the #GESTextOverlayClip*

the pango font description Sets the horizontal aligment of the text.

the #GESTextOverlayClip* to set horizontal alignement of text on

#GESTextHAlign Sets the text this clip will render.

the #GESTextOverlayClip* to set text on

the text to render. an internal copy of this text will be made. Sets the vertical aligment of the text.

the #GESTextOverlayClip* to set vertical alignement of text on

#GESTextVAlign Sets the horizontal position of the text.

the #GESTextOverlayClip* to set

The horizontal position @self is being set to Sets the vertical position of the text.

the #GESTextOverlayClip* to set

The vertical position @self is being set to The color of the text Pango font description string Horizontal alignment of the text The text to diplay Vertical alignent of the text The horizontal position of the text The vertical position of the text Vertical alignment of the text. draw text on the baseline draw text on the bottom draw text on top draw text on ypos position draw text on the center #GESTimeline is the central object for any multimedia timeline. Contains a list of #GESLayer which users should use to arrange the various clips through time. The output type is determined by the #GESTrack that are set on the #GESTimeline. To save/load a timeline, you can use the ges_timeline_load_from_uri() and ges_timeline_save_to_uri() methods to use the default format. If you wish Note that any change you make in the timeline will not actually be taken into account until you call the #ges_timeline_commit method. Creates a new empty #GESTimeline.

The new timeline.

Creates a new #GESTimeline containing a raw audio and a raw video track.

The newly created #GESTimeline.

Creates a timeline from the given URI.

A new timeline if the uri was loaded successfully, or %NULL if the uri could not be loaded.

the URI to load from

Add the layer to the timeline. The reference to the @layer will be stolen by the @timeline.

%TRUE if the layer was properly added, else %FALSE.

a #GESTimeline

the #GESLayer to add Add a track to the timeline. The reference to the track will be stolen by the pipeline.

%TRUE if the track was properly added, else %FALSE.

a #GESTimeline

the #GESTrack to add Append a newly created #GESLayer to @timeline Note that you do not own any reference to the returned layer.

The newly created #GESLayer, or the last (empty) #GESLayer of @timeline.

a #GESTimeline

Commit all the pending changes of the clips contained in the @timeline. When changes happen in a timeline, they are not directly executed in the non-linear engine. Call this method once you are done with a set of changes and want it to be executed. The #GESTimeline::commited signal will be emitted when the (possibly updated) #GstPipeline is ready to output data again, except if the state of the timeline was #GST_STATE_READY or #GST_STATE_NULL. Note that all the pending changes will automatically be executed when the timeline goes from #GST_STATE_READY to #GST_STATE_PAUSED, which usually is triggered by corresponding state changes in a containing #GESPipeline. You should not try to change the state of the timeline, seek it or add tracks to it during a commit operation, that is between a call to this function and after receiving the #GESTimeline::commited signal. See #ges_timeline_commit_sync if you don't want to bother with waiting for the signal.

%TRUE if pending changes were commited or %FALSE if nothing needed to be commited

a #GESTimeline

Commit all the pending changes of the #GESClips contained in the @timeline. Will return once the update is complete, that is when the (possibly updated) #GstPipeline is ready to output data again, or if the state of the timeline was #GST_STATE_READY or #GST_STATE_NULL. This function will wait for any pending state change of the timeline by calling #gst_element_get_state with a #GST_CLOCK_TIME_NONE timeout, you should not try to change the state from another thread before this function has returned. See #ges_timeline_commit for more information.

%TRUE if pending changes were commited or %FALSE if nothing needed to be commited

a #GESTimeline

Gets whether transitions are automatically added when objects overlap or not.

%TRUE if transitions are automatically added, else %FALSE.

a #GESTimeline

Get the current duration of @timeline

The current duration of @timeline

a #GESTimeline

Gets a #GESTimelineElement contained in the timeline

The #GESTimelineElement or %NULL if not found.

a #GESTimeline

Get the list of #GESGroup present in the Timeline.

the list of #GESGroup that contain clips present in the timeline's layers. Must not be changed.

a #GESTimeline

Retrieve the layer with @priority as a priority

A #GESLayer or %NULL if no layer with @priority was found Since 1.6

The #GESTimeline to retrive a layer from

The priority of the layer to find Get the list of #GESLayer present in the Timeline.

the list of #GESLayer present in the Timeline sorted by priority. The caller should unref each Layer once he is done with them.

a #GESTimeline

Search the #GstPad corresponding to the given @timeline's @track.

The corresponding #GstPad if it is found, or %NULL if there is an error.

The #GESTimeline

The #GESTrack Gets the configured snapping distance of the timeline. See the documentation of the property snapping_distance for more information.

The @snapping_distance property of the timeline

a #GESTimeline

Search the #GESTrack corresponding to the given @timeline's @pad.

The corresponding #GESTrack if it is found, or %NULL if there is an error.

The #GESTimeline

The #GstPad Returns the list of #GESTrack used by the Timeline.

A list of #GESTrack. The caller should unref each track once he is done with them.

a #GESTimeline

Check whether a #GESTimeline is empty or not

%TRUE if the timeline is empty %FALSE otherwize

a #GESTimeline

Loads the contents of URI into the given timeline.

%TRUE if the timeline was loaded successfully, or %FALSE if the uri could not be loaded.

an empty #GESTimeline into which to load the formatter

The URI to load from Moves @layer at @new_layer_priority meaning that @layer we land at that position in the stack of layers inside the timeline. If @new_layer_priority is superior than the number of layers present in the time, it will move to the end of the stack of layers.

The timeline in which @layer must be

The layer to move at @new_layer_priority The index at which @layer should land Paste @element inside the timeline. @element must have been created using ges_timeline_element_copy with deep=TRUE set, i.e. it must be a deep copy, otherwise it will fail.

Shallow copy of the @element pasted

The #GESTimeline onto which the #GESTimelineElement should be pasted

The #GESTimelineElement to paste The position in the timeline the element should be pasted to, meaning it will become the start of @element The #GESLayer to which the element should be pasted to. -1 means paste to the same layer from which the @element has been copied from. 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.

%TRUE if the layer was properly removed, else %FALSE.

a #GESTimeline

the #GESLayer to remove 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.

%TRUE if the @track was properly removed, else %FALSE.

a #GESTimeline

the #GESTrack to remove Saves the timeline to the given location

%TRUE if the timeline was successfully saved to the given location, else %FALSE.

a #GESTimeline

The location to save to The formatter asset to use or %NULL. If %NULL, will try to save in the same format as the one from which the timeline as been loaded or default to the formatter with highest rank %TRUE to overwrite file if it exists Sets the layer to the given @auto_transition. See the documentation of the property auto_transition for more information.

a #GESLayer

whether the auto_transition is active Sets the @snapping_distance of the timeline. See the documentation of the property snapping_distance for more information.

a #GESLayer

whether the snapping_distance is active Sets whether transitions are added automagically when clips overlap. Current duration (in nanoseconds) of the #GESTimeline Distance (in nanoseconds) from which a moving object will snap with it neighboors. 0 means no snapping. A list of #GESLayer sorted by priority NOTE: Do not modify. A list of #GESTrack sorted by priority NOTE: Do not modify. This signal will be emitted once the changes initiated by #ges_timeline_commit have been executed in the backend. Use #ges_timeline_commit_sync if you don't need to do anything in the meantime.

Will be emitted after a new group is added to to the timeline.

the #GESGroup Will be emitted after a group has been removed from the timeline.

the #GESGroup a list of #GESContainer Will be emitted after a new layer is added to the timeline.

the #GESLayer that was added to the timeline Will be emitted after the layer was removed from the timeline.

the #GESLayer that was removed from the timeline

a #GPtrArray of #GESTrack-s where that object should be added

The #GESClip on which @track_element will land The #GESTrackElement for which to choose the tracks it should land into Will be emitted when the 2 #GESTrackElement ended to snap

the first #GESTrackElement that was snapping. the second #GESTrackElement that was snapping. the position where the two objects finally snapping. Will be emitted when the 2 #GESTrackElement first snapped

the first #GESTrackElement that was snapping. the second #GESTrackElement that was snapping. the position where the two objects finally snapping. Will be emitted after the track was added to the timeline.

the #GESTrack that was added to the timeline Will be emitted after the track was removed from the timeline.

the #GESTrack that was removed from the timeline parent class

The GESTimelineElement base class implements the notion of timing as well as priority. A GESTimelineElement can have a parent object which will be responsible for controlling its timing properties.

The priority of the first layer the element is in (note that only groups can span over several layers). %GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY means that the element is not in a layer.

A #GESTimelineElement

Gets all the TrackTypes @self will interact with

A #GESTimelineElement

Looks up which @element and @pspec would be effected by the given @name. If various contained elements have this property name you will get the first one, unless you specify the class name in @name.

TRUE if @element and @pspec could be found. FALSE otherwise. In that case the values for @pspec and @element are not modified. Unref @element after usage.

object to lookup the property in

name of the property to look up. You can specify the name of the class as such: "ClassName::property-name", to guarantee that you get the proper GParamSpec in case various GstElement-s contain the same property name. If you don't do so, you will get the first element found, having this property and the and the corresponding GParamSpec. pointer to a #GstElement that takes the real object to set property on pointer to take the #GParamSpec describing the property

Edits @self in ripple mode. It allows you to modify the start of @self and move the following neighbours accordingly. This will change the overall timeline duration.

%TRUE if the self as been rippled properly, %FALSE if an error occured

The #GESTimelineElement to ripple.

The new start of @self in ripple mode.

Edits @self in ripple mode. It allows you to modify the duration of a @self and move the following neighbours accordingly. This will change the overall timeline duration.

%TRUE if the self as been rippled properly, %FALSE if an error occured

The #GESTimelineElement to ripple.

The new end (start + duration) of @self in ripple mode. It will basically only change the duration of @self.

Edits @self in roll mode. It allows you to modify the duration of a @self and trim (basicly change the start + inpoint in this case) the following neighbours accordingly. This will not change the overall timeline duration.

%TRUE if the self as been rolled properly, %FALSE if an error occured

The #GESTimelineElement to roll.

The new end (start + duration) of @self in roll mode

Edits @self in roll mode. It allows you to modify the start and inpoint of a @self and "resize" (basicly change the duration in this case) of the previous neighbours accordingly. This will not change the overall timeline duration.

%TRUE if the self as been roll properly, %FALSE if an error occured

The #GESTimelineElement to roll

The new start of @self in roll mode, it will also adapat the in-point of @self according

Set the duration of the object Note that if the timeline snap-distance property of the timeline containing @self is set, @self will properly snap to its neighboors.

%TRUE if @duration could be set.

a #GESTimelineElement

the duration in #GstClockTime

Set the in-point, that is the moment at which the @self will start outputting data from its contents.

%TRUE if @inpoint could be set.

a #GESTimelineElement

the in-point in #GstClockTime

Set the maximun duration of the object

%TRUE if @maxduration could be set.

a #GESTimelineElement

the maximum duration in #GstClockTime

Sets the parent of @self to @parent. The parents needs to already own a hard reference on @self.

%TRUE if @parent could be set or %FALSE when @self already had a parent or @self and @parent are the same.

a #GESTimelineElement

new parent of self

Sets the priority of the object within the containing layer

All priority management is done by GES itself now. To set #GESEffect priorities #ges_clip_set_top_effect_index should be used.

%TRUE if @priority could be set.

a #GESTimelineElement

the priority

Set the position of the object in its containing layer. Note that if the snapping-distance property of the timeline containing @self is set, @self will properly snap to the edges around @start.

%TRUE if @start could be set.

a #GESTimelineElement

the position in #GstClockTime

Edits @self in trim mode. It allows you to modify the inpoint and start of @self. This will not change the overall timeline duration. Note that to trim the end of an self you can just set its duration. The same way as this method, it will take into account the snapping-distance property of the timeline in which @self is.

%TRUE if the self as been trimmed properly, %FALSE if an error occured

The #GESTimelineElement to trim.

The new start of @self in trim mode, will adapt the inpoint of @self accordingly

Copies @self

The newly create #GESTimelineElement, copied from @self

The #GESTimelineElement to copy

whether we want to create the elements @self contains or not Gets properties of a child of @self.

The origin #GESTimelineElement

The name of the first property to get return location for the first property, followed optionally by more name/return location pairs, followed by NULL In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling g_value_unset(). Gets a property of a GstElement contained in @object. Note that #ges_timeline_element_get_child_property is really intended for language bindings, #ges_timeline_element_get_child_properties is much more convenient for C programming.

%TRUE if the property was found, %FALSE otherwize

The origin #GESTimelineElement

The name of the property return location for the property value, it will be initialized if it is initialized with 0 Gets a property of a child of @self.

a #GESTrackElement

The #GParamSpec that specifies the property you want to get return location for the value Gets a property of a child of @self. If there are various child elements that have the same property name, you can distinguish them using the following syntax: 'ClasseName::property_name' as property name. If you don't, the corresponding property of the first element found will be set.

The #GESTimelineElement parent object

The name of the first property to get value for the first property, followed optionally by more name/return location pairs, followed by NULL

The @duration of @self

a #GESTimelineElement

The @inpoint of @self

a #GESTimelineElement

The priority of the first layer the element is in (note that only groups can span over several layers). %GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY means that the element is not in a layer.

A #GESTimelineElement

The @maxduration of @self

a #GESTimelineElement

Returns a copy of the name of @self. Caller should g_free() the return value after usage.

The name of @self

a #GESTimelineElement

Returns the parent of @self. This function increases the refcount of the parent object so you should gst_object_unref() it after usage.

parent of @self, this can be %NULL if @self has no parent. unref after usage.

a #GESTimelineElement

The @priority of @self

a #GESTimelineElement

The @start of @self

a #GESTimelineElement

Returns the timeline of @self. This function increases the refcount of the timeline so you should gst_object_unref() it after usage.

timeline of @self, this can be %NULL if @self has no timeline. unref after usage.

a #GESTimelineElement

Gets the toplevel #GESTimelineElement controlling @self

The toplevel controlling parent of @self

The #GESTimelineElement to get the toplevel parent from

Gets all the TrackTypes @self will interact with

A #GESTimelineElement

Gets an array of #GParamSpec* for all configurable properties of the children of @self.

an array of #GParamSpec* which should be freed after use or %NULL if something went wrong

The #GESTimelineElement to get the list of children properties from

return location for the length of the returned array Looks up which @element and @pspec would be effected by the given @name. If various contained elements have this property name you will get the first one, unless you specify the class name in @name.

TRUE if @element and @pspec could be found. FALSE otherwise. In that case the values for @pspec and @element are not modified. Unref @element after usage.

object to lookup the property in

Paste @self copying the element

The #GESTimelineElement to paste

The position in the timeline the element should be copied to, meaning it will become the start of @self

Edits @self in ripple mode. It allows you to modify the start of @self and move the following neighbours accordingly. This will change the overall timeline duration.

%TRUE if the self as been rippled properly, %FALSE if an error occured

The #GESTimelineElement to ripple.

The new start of @self in ripple mode. Edits @self in ripple mode. It allows you to modify the duration of a @self and move the following neighbours accordingly. This will change the overall timeline duration.

%TRUE if the self as been rippled properly, %FALSE if an error occured

The #GESTimelineElement to ripple.

The new end (start + duration) of @self in ripple mode. It will basically only change the duration of @self. Edits @self in roll mode. It allows you to modify the duration of a @self and trim (basicly change the start + inpoint in this case) the following neighbours accordingly. This will not change the overall timeline duration.

%TRUE if the self as been rolled properly, %FALSE if an error occured

The #GESTimelineElement to roll.

The new end (start + duration) of @self in roll mode Edits @self in roll mode. It allows you to modify the start and inpoint of a @self and "resize" (basicly change the duration in this case) of the previous neighbours accordingly. This will not change the overall timeline duration.

%TRUE if the self as been roll properly, %FALSE if an error occured

The #GESTimelineElement to roll

The new start of @self in roll mode, it will also adapat the in-point of @self according Sets a property of a child of @self. If there are various child elements that have the same property name, you can distinguish them using the following syntax: 'ClasseName::property_name' as property name. If you don't, the corresponding property of the first element found will be set.

The #GESTimelineElement parent object

The name of the first property to set value for the first property, followed optionally by more name/return location pairs, followed by NULL Sets a property of a child of @self Note that #ges_timeline_element_set_child_property is really intended for language bindings, #ges_timeline_element_set_child_properties is much more convenient for C programming.

%TRUE if the property was set, %FALSE otherwize

The origin #GESTimelineElement

The name of the property the value Sets a property of a child of @self.

a #GESTimelineElement

The #GParamSpec that specifies the property you want to set the value Sets a property of a child of @self. If there are various child elements that have the same property name, you can distinguish them using the following syntax: 'ClasseName::property_name' as property name. If you don't, the corresponding property of the first element found will be set.

The #GESTimelineElement parent object

The name of the first property to set value for the first property, followed optionally by more name/return location pairs, followed by NULL Set the duration of the object Note that if the timeline snap-distance property of the timeline containing @self is set, @self will properly snap to its neighboors.

%TRUE if @duration could be set.

a #GESTimelineElement

the duration in #GstClockTime Set the in-point, that is the moment at which the @self will start outputting data from its contents.

%TRUE if @inpoint could be set.

a #GESTimelineElement

the in-point in #GstClockTime Set the maximun duration of the object

%TRUE if @maxduration could be set.

a #GESTimelineElement

the maximum duration in #GstClockTime Sets the name of object, or gives @self a guaranteed unique name (if name is NULL). This function makes a copy of the provided name, so the caller retains ownership of the name it sent.

a #GESTimelineElement

The name @self should take (if avalaible<) Sets the parent of @self to @parent. The parents needs to already own a hard reference on @self.

%TRUE if @parent could be set or %FALSE when @self already had a parent or @self and @parent are the same.

a #GESTimelineElement

new parent of self Sets the priority of the object within the containing layer

All priority management is done by GES itself now. To set #GESEffect priorities #ges_clip_set_top_effect_index should be used.

%TRUE if @priority could be set.

a #GESTimelineElement

the priority Set the position of the object in its containing layer. Note that if the snapping-distance property of the timeline containing @self is set, @self will properly snap to the edges around @start.

%TRUE if @start could be set.

a #GESTimelineElement

the position in #GstClockTime Sets the timeline of @self to @timeline.

%TRUE if @timeline could be set or %FALSE when @timeline already had a timeline.

a #GESTimelineElement

The #GESTimeline @self is in Edits @self in trim mode. It allows you to modify the inpoint and start of @self. This will not change the overall timeline duration. Note that to trim the end of an self you can just set its duration. The same way as this method, it will take into account the snapping-distance property of the timeline in which @self is.

%TRUE if the self as been trimmed properly, %FALSE if an error occured

The #GESTimelineElement to trim.

The new start of @self in trim mode, will adapt the inpoint of @self accordingly The duration (in nanoseconds) which will be used in the container The in-point at which this #GESTimelineElement 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. The maximum duration (in nanoseconds) of the #GESTimelineElement. The name of the object The parent container of the object The priority of the object. Setting GESTimelineElement priorities is deprecated as all priority management is done by GES itself now. Whether the element should be serialized. The position of the object in its container (in nanoseconds). The timeline in which @element is The #GESTimelineElement that controls the object The #GESAsset from which the object has been extracted position (in time) of the object Position in the media from which the object should be used duration of the object to be used The maximum duration the object can have priority of the object in the layer (0:top priority) The deep notify signal is used to be notified of property changes of all the childs of @timeline_element

the object that originated the signal the property that changed 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.

%TRUE if @parent could be set or %FALSE when @self already had a parent or @self and @parent are the same.

a #GESTimelineElement new parent of self

%TRUE if @start could be set.

a #GESTimelineElement the position in #GstClockTime

%TRUE if @inpoint could be set.

a #GESTimelineElement the in-point in #GstClockTime

%TRUE if @duration could be set.

a #GESTimelineElement the duration in #GstClockTime

%TRUE if @maxduration could be set.

a #GESTimelineElement the maximum duration in #GstClockTime

%TRUE if @priority could be set.

a #GESTimelineElement the priority

%TRUE if the self as been rippled properly, %FALSE if an error occured

The #GESTimelineElement to ripple. The new start of @self in ripple mode.

%TRUE if the self as been rippled properly, %FALSE if an error occured

The #GESTimelineElement to ripple. The new end (start + duration) of @self in ripple mode. It will basically only change the duration of @self.

%TRUE if the self as been roll properly, %FALSE if an error occured

The #GESTimelineElement to roll The new start of @self in roll mode, it will also adapat the in-point of @self according

%TRUE if the self as been rolled properly, %FALSE if an error occured

The #GESTimelineElement to roll. The new end (start + duration) of @self in roll mode

%TRUE if the self as been trimmed properly, %FALSE if an error occured

The #GESTimelineElement to trim. The new start of @self in trim mode, will adapt the inpoint of @self accordingly

TRUE if @element and @pspec could be found. FALSE otherwise. In that case the values for @pspec and @element are not modified. Unref @element after usage.

A #GESTimelineElement

The priority of the first layer the element is in (note that only groups can span over several layers). %GES_TIMELINE_ELEMENT_NO_LAYER_PRIORITY means that the element is not in a layer.

A #GESTimelineElement Renders the given text in the specified font, at specified position, and with the specified background pattern. Creates a new #GESTitleClip

The newly created #GESTitleClip, or %NULL if there was an error.

Get the background used by @self.