gstreamer-rs/docs/gstreamer-editing-services/docs.md
2019-06-24 20:52:03 +03:00

90 KiB

The Assets in the GStreamer Editing Services represent the resources that can be used. You can create assets for any type that implements the Extractable interface, for example GESClips, Formatter, and TrackElement do implement it. This means that assets will represent for example a GESUriClips, BaseEffect etc, and then you can extract objects of those types with the appropriate parameters from the asset using the AssetExt::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 Asset 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 Asset through the MetaContainer interface and you have a model for your custom effects. Note that Asset management is making easier thanks to the Project class.

Each asset is represented by a pair of extractable_type and id (string). Actually the extractable_type is the type that implements the Extractable interface, that means that for example for a UriClip, the type that implements the Extractable interface is Clip. 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 Asset actually represents for that type. By default, we only have one Asset 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 Effect 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 Asset 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 Asset::request or Asset::request_async. All the GESAssets are cached and thus any asset that has already been created can be requested again without overhead.

Implements

AssetExt, glib::object::ObjectExt

Trait containing all Asset methods.

Implementors

Asset, Project

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.

extractable_type

The glib::Type of the object that can be extracted from the asset to be reloaded.

id

The identifier of the asset to mark as needing reload

Returns

true if the asset was in the cache and could be set as needing reload, false otherwise.

Create a Asset 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 UriClipAsset::request_sync method if you really want to.

extractable_type

The glib::Type of the object that can be extracted from the new asset.

id

The Identifier or None

Returns

A reference to the wanted Asset or None

The callback will be called from a running glib::MainLoop which is iterating a glib::MainContext. Note that, users should ensure the glib::MainContext, since this method will notify callback from the thread which was associated with a thread default glib::MainContext at calling ges_init. For example, if a user wants non-default glib::MainContext to be associated with callback, ges_init must be called after g_main_context_push_thread_default () with custom glib::MainContext.

Request a new Asset 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);

extractable_type

The glib::Type of the object that can be extracted from the new asset. The class must implement the Extractable interface.

id

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 None), 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 Extractable type you want to create a Asset for.

cancellable

optional gio::Cancellable object, None to ignore.

callback

a GAsyncReadyCallback to call when the initialization is finished, Note that the source of the callback will be the Asset, but you need to make sure that the asset is properly loaded using the Asset::request_finish method. This asset can not be used as is.

user_data

The user data to pass when callback is called

Finalize the request of an async Asset

res

The gio::AsyncResult from which to get the newly created Asset

Returns

The Asset previously requested

Extracts a new gobject::Object 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 AssetExt::get_extractable_type

Returns

A newly created Extractable

Returns

The glib::Error of the asset or None if the asset was loaded without issue

Gets the type of object that can be extracted from self

Returns

the type of object that can be extracted from self

Gets the ID of a Asset

Returns

The ID of self

Returns

The proxy in use for self

Returns

The Asset that is proxied by self

Returns

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

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

proxy

The Asset that should be used as default proxy for self or None if you want to use the currently set proxy. Note that an asset can proxy one and only one other asset.

Returns

true if proxy has been set on self, false otherwise.

Removes proxy from the list of known proxies for self. If proxy was the current proxy for self, stop using it.

proxy

The Asset to stop considering as a proxy for self

Returns

true if proxy was a known proxy for self, false otherwise.

Implements

TrackElementExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

A Clip is a 'natural' object which controls one or more TrackElement(s) in one or more Track(s).

Keeps a reference to the TrackElement(s) it created and sets/updates their properties.

Implements

ClipExt, GESContainerExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all Clip methods.

Implementors

Clip

Extracts a TrackElement from asset and adds it to the self. Should only be called in order to add operations to a Clip, ni other cases TrackElement are added automatically when adding the Clip/Asset to a layer.

Takes a reference on track_element.

asset

a Asset with GES_TYPE_TRACK_ELEMENT as extractable_type

Returns

Created TrackElement or NULL if an error happened

Finds the TrackElement controlled by self 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.

track

a Track or NULL

type_

a glib::Type indicating the type of track element you are looking for or G_TYPE_NONE if you do not care about the track type.

Returns

The TrackElement used by track, else None. Unref after usage

Finds all the TrackElement controlled by self that is used in track. You may optionally specify a GType to further narrow search criteria.

track

a Track or NULL

track_type

a TrackType indicating the type of tracks in which elements should be searched.

type_

a glib::Type indicating the type of track element you are looking for or G_TYPE_NONE if you do not care about the track type.

Returns

a glib::List of the TrackElement contained in self. The refcount of the objects will be increased. The user will have to unref each TrackElement and free the glib::List.

Get the Layer to which this clip belongs.

Returns

The Layer where this self is being used, or None if it is not used on any layer. The caller should unref it usage.

Get the formats supported by self.

Returns

The formats supported by self.

Gets the index position of an effect.

effect

The BaseEffect we want to get the top index from

Returns

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

Get effects applied on self

Returns

a glib::List of the BaseEffect that are applied on self order by ascendant priorities. The refcount of the objects will be increased. The user will have to unref each BaseEffect and free the glib::List.

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

layer

the new Layer

Returns

true if self could be moved false otherwize

Sets the formats supported by the file.

supportedformats

the TrackType defining formats supported by self

This is a convenience method that lets you set the index of a top effect.

effect

The BaseEffect to move

newindex

the new index at which to move the effect inside this Clip

Returns

true if effect was successfuly moved, false otherwise.

The function modifies self, and creates another Clip 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 self is in. This implies that self must be in a Layer 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 Effect '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 EffectClass::register_rate_property; for the 'pitch' plugin, this is already done.

position

a gst::ClockTime representing the timeline position at which to split

Returns

The newly created Clip resulting from the splitting or None if the clip can't be 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 formats supported by the clip.

The Container base class.

Implements

GESContainerExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all Container methods.

Implementors

Clip, Container, Group

Groups the Container-s provided in containers. It creates a subclass of Container, depending on the containers provided in containers. Basically, if all the containers in containers should be contained in a same clip (all the TrackElement they contain have the exact same start/inpoint/duration and are in the same layer), it will create a Clip otherwise a Group will be created

containers

The Container to group, they must all be in a same Timeline

Returns

The Container (subclass) resulting of the grouping

Add the TimelineElement to the container.

child

the TimelineElement

Returns

true on success, false on failure.

Edit self in the different exisiting EditMode modes. In the case of slide, and roll, you need to specify a Edge

layers

The layers you want the edit to happen in, None means that the edition is done in all the GESLayers contained in the current timeline.

new_layer_priority

The priority of the layer self 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.

mode

The EditMode in which the editition will happen.

edge

The Edge the edit should happen on.

position

The position at which to edit self (in nanosecond)

Returns

true if the container as been edited properly, false if an error occured

Get the list of TimelineElement contained in self The user is responsible for unreffing the contained objects and freeing the list.

recursive

Whether to recursively get children in self

Returns

The list of timeline element contained in self.

Release the child from the control of self.

child

the TimelineElement to release

Returns

true if the child was properly released, else false.

Ungroups the TimelineElement contained in this GESContainer, creating new Container containing those TimelineElement apropriately.

recursive

Wether to recursively ungroup self

Returns

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

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.

element

the TimelineElement that was added.

Will be emitted after a child was removed from container.

element

the TimelineElement that was removed.

The span of priorities which this container occupies.

The edges of an object contain in a Timeline or Track

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: trim, ripple and roll</ulink> and 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)

Implements

EffectExt, BaseEffectExt, TrackElementExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all Effect methods.

Implementors

Effect

Creates a new Effect 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: Asset::request (GES_TYPE_EFFECT, "audio your ! bin ! description", NULL); and extract that asset to be in full control.

bin_description

The gst-launch like bin description of the effect

Returns

a newly created Effect, or None if something went wrong.

The description of the effect bin with a gst-launch-style pipeline description.

Example: "videobalance saturation=1.5 hue=+0.5"

The description of the effect bin with a gst-launch-style pipeline description.

Example: "videobalance saturation=1.5 hue=+0.5"

FIXME: Long description needed

Implements

ExtractableExt, glib::object::ObjectExt

Trait containing all Extractable methods.

Implementors

BaseEffect, Clip, Container, Effect, Extractable, Group, Layer, TimelineElement, Timeline, TrackElement, UriClip

Method for getting an asset from a Extractable

Returns

The Asset or None if none has been set

Returns

The id of the associated Asset, free with g_free

Method to set the asset which instantiated the specified object

asset

The Asset to set

Returns

true if asset could be set false otherwize

A Group is an object which controls one or more GESClips in one or more Layer(s).

To instanciate a group, you should use the ges_container_group method, this will be responsible for deciding what subclass of Container should be instaciated to group the various TimelineElement passed in parametter.

Implements

GroupExt, GESContainerExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all Group methods.

Implementors

Group

Created a new empty Group, if you want to group several container together, it is recommanded to use the Container::group method so the proper subclass is selected.

Returns

The new empty group.

The duration (in nanoseconds) which will be used in the container

The duration (in nanoseconds) which will be used in the container

The in-point at which this Group 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 in-point at which this Group 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 Group.

The maximum duration (in nanoseconds) of the Group.

The position of the object in its container (in nanoseconds).

The position of the object in its container (in nanoseconds).

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.

Implements

LayerExt, glib::object::ObjectExt, ExtractableExt

Trait containing all Layer methods.

Implementors

Layer

Creates a new Layer.

Returns

A new Layer

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

asset

The asset to add to

start

The start value to set on the new Clip, if start == GST_CLOCK_TIME_NONE, it will be set to the current duration of self

inpoint

The inpoint value to set on the new Clip

duration

The duration value to set on the new Clip

track_types

The TrackType to set on the the new Clip

Returns

Created Clip

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 TrackElement) are constructed, you should connect to the container::child-added signal which is emited right after those elements are ready to be used.

clip

the Clip to add.

Returns

true if the clip was properly added to the layer, or false if the self refuses to add the clip.

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

Returns

true if transitions are automatically added, else false.

Get the clips this layer contains.

Returns

a glib::List of clips. The user is responsible for unreffing the contained objects and freeing the list.

Gets the clips which appear between start and end on self.

start

start of the interval

end

end of the interval

Returns

a glib::List of clips intersecting [start, end) interval on self.

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

Returns

The duration of a layer

Get the priority of self within the timeline.

Returns

The priority of the self within the timeline.

Get the Timeline in which Layer currently is.

Returns

the Timeline in which Layer currently is or None if not in any timeline yet.

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

Returns

true if self is empty, false if it already contains at least one Clip

Removes the given clip from the self and unparents it. Unparenting it means the reference owned by self on the clip will be removed. If you wish to use the clip after this function, make sure you call gst::ObjectExt::ref before removing it from the self.

clip

the Clip to remove

Returns

true if the clip could be removed, false if the layer does not want to remove the clip.

Sets the layer to the given auto_transition. See the documentation of the property auto_transition for more information.

auto_transition

whether the auto_transition is active

Sets the layer to the given priority. See the documentation of the priority property for more information.

Deprecated since 1.16

use TimelineExt::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.

priority

the priority to set

Will be emitted after the clip was added to the layer.

clip

the Clip that was added.

Will be emitted after the clip was removed from the layer.

clip

the Clip that was removed

Sets whether transitions are added automagically when clips overlap.

Sets whether transitions are added automagically when clips overlap.

The priority of the layer in the Timeline. 0 is the highest priority. Conceptually, a Timeline 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 TimelineExt::commit) for the change to be taken into account.

Deprecated since 1.16

use TimelineExt::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 priority of the layer in the Timeline. 0 is the highest priority. Conceptually, a Timeline 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 TimelineExt::commit) for the change to be taken into account.

Deprecated since 1.16

use TimelineExt::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.

Pipeline allows developers to view and render Timeline in a simple fashion. Its usage is inspired by the 'playbin' element from gst-plugins-base.

Implements

GESPipelineExt, gst::PipelineExt, gst::ElementExt, gst::ObjectExt, glib::object::ObjectExt

Trait containing all Pipeline methods.

Implementors

Pipeline

Creates a new conveninence Pipeline.

Returns

the new Pipeline.

Returns

the PipelineFlags currently in use.

Returns a gst::Sample 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.

caps

caps specifying current format. Use GST_CAPS_ANY for native size.

Returns

a gst::Sample or None

A convenience method for GESPipelineExt::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.

width

the requested width or -1 for native size

height

the requested height or -1 for native size

Returns

a gst::Sample or None

Obtains a pointer to playsink's audio sink element that is used for displaying audio when the Pipeline is in PipelineFlags::FullPreview

The caller is responsible for unreffing the returned element with gst::ObjectExt::unref.

Returns

a pointer to the playsink audio sink gst::Element

Obtains a pointer to playsink's video sink element that is used for displaying video when the Pipeline is in PipelineFlags::FullPreview

The caller is responsible for unreffing the returned element with gst::ObjectExt::unref.

Returns

a pointer to the playsink video sink gst::Element

Sets playsink's audio sink element that is used for displaying audio when the Pipeline is in PipelineFlags::FullPreview

sink

a audio sink gst::Element

Sets playsink's video sink element that is used for displaying video when the Pipeline is in PipelineFlags::FullPreview

sink

a video sink gst::Element

Saves the current frame to the specified location.

width

the requested width or -1 for native size

height

the requested height or -1 for native size

format

a string specifying the desired mime type (for example, image/jpeg)

location

the path to save the thumbnail

Returns

true if the thumbnail was properly save, else false.

switches the self to the specified mode. The default mode when creating a Pipeline is PipelineFlags::FullPreview.

Note: The self 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 self to the requested state after calling this method.

mode

the PipelineFlags to use

Returns

true if the mode was properly set, else false.

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 PipelineFlags::Render

output_uri

the URI to which the timeline will be rendered

profile

the gst_pbutils::EncodingProfile to use to render the timeline.

Returns

true if the settings were aknowledged properly, else false

Sets the timeline to use in this pipeline.

The reference to the timeline will be stolen by the self.

timeline

the Timeline to set on the self.

Returns

true if the timeline could be successfully set on the self, else false.

Audio sink for the preview.

Audio sink for the preview.

Pipeline mode. See GESPipelineExt::set_mode for more info.

Pipeline mode. See GESPipelineExt::set_mode for more info.

Timeline to use in this pipeline. See also GESPipelineExt::set_timeline for more info.

Timeline to use in this pipeline. See also GESPipelineExt::set_timeline for more info.

Video sink for the preview.

Video sink for the preview.

The Project is used to control a set of Asset and is a Asset with GES_TYPE_TIMELINE as extractable_type itself. That means that you can extract Timeline 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 Project class offers a higher level API to handle Asset-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 gst::Element and lets you try to recover from those.

Implements

ProjectExt, AssetExt, glib::object::ObjectExt

Trait containing all Project methods.

Implementors

Project

Creates a new Project and sets its uri to uri if provided. Note that if uri is not valid or None, 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.

uri

The uri to be set after creating the project.

Returns

A newly created Project

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

asset

A Asset to add to self

Returns

true if the asset could be added false it was already in the 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.

profile

A gst_pbutils::EncodingProfile to add to the project. If a profile with the same name already exists, it will be replaced

Returns

true if profile could be added, false otherwize

Create and add a Asset to self. You should connect to the "asset-added" signal to get the asset when it finally gets added to self

id

The id of the asset to create and add to self

extractable_type

The glib::Type of the asset to create

Returns

true if the asset started to be added false it was already in the project

Create and add a Asset to self. You should connect to the "asset-added" signal to get the asset when it finally gets added to self

id

The id of the asset to create and add to self

extractable_type

The glib::Type of the asset to create

Returns

The newly created Asset or None.

id

The id of the asset to retrieve

extractable_type

The extractable_type of the asset to retrieve from object

Returns

The Asset with id or None if no asset with id as an ID

Get the assets that are being loaded

Returns

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

Retrieve the uri that is currently set on self

Returns

a newly allocated string representing uri.

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

filter

Type of assets to list, GES_TYPE_EXTRACTABLE will list all assets

Returns

The list of Asset the object contains

Lists the encoding profile that have been set to self. The first one is the latest added.

Returns

The list of gst_pbutils::EncodingProfile used in self

Loads self into timeline

timeline

A blank timeline to load self into

Returns

true if the project could be loaded false otherwize.

remove a asset to from self.

asset

A Asset to remove from self

Returns

true if the asset could be removed false otherwise

Save the timeline of self to uri. You should make sure that timeline is one of the timelines that have been extracted from self (using ges_asset_extract (self);)

timeline

The Timeline to save, it must have been extracted from self

uri

The uri where to save self and timeline

formatter_asset

The formatter asset to use or None. If None, 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

overwrite

true to overwrite file if it exists

Returns

true if the project could be save, false otherwize

asset

The Asset that has been added to project

asset

The Asset that started loading

asset

The Asset that has been removed from project

Informs you that a Asset could not be created. In case of missing GStreamer plugins, the error will be set to GST_CORE_ERROR gst::CoreError::MissingPlugin

error

The glib::Error defining the error that occured, might be None

id

The id of the asset that failed loading

extractable_type

The extractable_type of the asset that failed loading

timeline

The Timeline 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));
}

error

The error that happened

wrong_asset

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

Returns

The new URI of wrong_asset

Timeline is the central object for any multimedia timeline.

Contains a list of Layer which users should use to arrange the various clips through time.

The output type is determined by the Track that are set on the Timeline.

To save/load a timeline, you can use the TimelineExt::load_from_uri and TimelineExt::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 TimelineExt::commit method.

Implements

TimelineExt, gst::ElementExt, gst::ObjectExt, glib::object::ObjectExt, ExtractableExt

Trait containing all Timeline methods.

Implementors

Timeline

Creates a new empty Timeline.

Returns

The new timeline.

Creates a new Timeline containing a raw audio and a raw video track.

Returns

The newly created Timeline.

Creates a timeline from the given URI.

uri

the URI to load from

Returns

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

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

layer

the Layer to add

Returns

true if the layer was properly added, else false.

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

track

the Track to add

Returns

true if the track was properly added, else false.

Append a newly created Layer to self Note that you do not own any reference to the returned layer.

Returns

The newly created Layer, or the last (empty) Layer of self.

Commit all the pending changes of the clips contained in the self.

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 Timeline::commited signal will be emitted when the (possibly updated) gst::Pipeline 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 Pipeline.

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 Timeline::commited signal.

See TimelineExt::commit_sync if you don't want to bother with waiting for the signal.

Returns

true if pending changes were commited or false if nothing needed to be commited

Commit all the pending changes of the GESClips contained in the self.

Will return once the update is complete, that is when the (possibly updated) gst::Pipeline 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::ElementExt::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 TimelineExt::commit for more information.

Returns

true if pending changes were commited or false if nothing needed to be commited

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

Returns

true if transitions are automatically added, else false.

Get the current duration of self

Returns

The current duration of self

Gets a TimelineElement contained in the timeline

Returns

The TimelineElement or None if not found.

Get the list of Group present in the Timeline.

Returns

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

Retrieve the layer with priority as a priority

priority

The priority of the layer to find

Returns

A Layer or None if no layer with priority was found

Since 1.6

Get the list of Layer present in the Timeline.

Returns

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

Search the gst::Pad corresponding to the given self's track.

track

The Track

Returns

The corresponding gst::Pad if it is found, or None if there is an error.

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

Returns

The snapping_distance property of the timeline

Search the Track corresponding to the given self's pad.

pad

The gst::Pad

Returns

The corresponding Track if it is found, or None if there is an error.

Returns the list of Track used by the Timeline.

Returns

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

Check whether a Timeline is empty or not

Returns

true if the timeline is empty false otherwize

Loads the contents of URI into the given timeline.

uri

The URI to load from

Returns

true if the timeline was loaded successfully, or false if the uri could not be loaded.

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.

layer

The layer to move at new_layer_priority

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.

element

The TimelineElement to paste

position

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

layer_priority

The Layer to which the element should be pasted to. -1 means paste to the same layer from which the element has been copied from.

Returns

Shallow copy of the element pasted

Removes the layer from the timeline. The reference that the self 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.

layer

the Layer to remove

Returns

true if the layer was properly removed, else false.

Remove the track from the self. 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.

track

the Track to remove

Returns

true if the track was properly removed, else false.

Saves the timeline to the given location

uri

The location to save to

formatter_asset

The formatter asset to use or None. If None, 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

overwrite

true to overwrite file if it exists

Returns

true if the timeline was successfully saved to the given location, else false.

Sets the layer to the given auto_transition. See the documentation of the property auto_transition for more information.

auto_transition

whether the auto_transition is active

Sets the snapping_distance of the timeline. See the documentation of the property snapping_distance for more information.

snapping_distance

whether the snapping_distance is active

This signal will be emitted once the changes initiated by TimelineExt::commit have been executed in the backend. Use TimelineExt::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.

group

the Group

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

group

the Group

children

a list of Container

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

layer

the Layer that was added to the timeline

Will be emitted after the layer was removed from the timeline.

layer

the Layer that was removed from the timeline

clip

The Clip on which track_element will land

track_element

The TrackElement for which to choose the tracks it should land into

Returns

a glib::PtrArray of Track-s where that object should be added

Will be emitted when the 2 TrackElement ended to snap

obj1

the first TrackElement that was snapping.

obj2

the second TrackElement that was snapping.

position

the position where the two objects finally snapping.

Will be emitted when the 2 TrackElement first snapped

obj1

the first TrackElement that was snapping.

obj2

the second TrackElement that was snapping.

position

the position where the two objects finally snapping.

Will be emitted after the track was added to the timeline.

track

the Track that was added to the timeline

Will be emitted after the track was removed from the timeline.

track

the Track that was removed from the timeline

Sets whether transitions are added automagically when clips overlap.

Sets whether transitions are added automagically when clips overlap.

Current duration (in nanoseconds) of the Timeline

Distance (in nanoseconds) from which a moving object will snap with it neighboors. 0 means no snapping.

Distance (in nanoseconds) from which a moving object will snap with it neighboors. 0 means no snapping.

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.

Implements

TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all TimelineElement methods.

Implementors

Container, TimelineElement, TrackElement

Copies self

deep

whether we want to create the elements self contains or not

Returns

The newly create TimelineElement, copied from self

Gets properties of a child of self.

first_property_name

The name of the first property to get

In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling gobject::Value::unset.

Gets a property of a GstElement contained in object.

Note that TimelineElementExt::get_child_property is really intended for language bindings, TimelineElementExt::get_child_properties is much more convenient for C programming.

property_name

The name of the property

value

return location for the property value, it will be initialized if it is initialized with 0

Returns

true if the property was found, false otherwize

Gets a property of a child of self.

pspec

The gobject::ParamSpec that specifies the property you want to get

value

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.

first_property_name

The name of the first property to get

var_args

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

Returns

The duration of self

Returns

The inpoint of self

Returns

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.

Returns

The maxduration of self

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

Returns

The name of self

Returns the parent of self. This function increases the refcount of the parent object so you should gst::ObjectExt::unref it after usage.

Returns

parent of self, this can be None if self has no parent. unref after usage.

Returns

The priority of self

Returns

The start of self

Returns the timeline of self. This function increases the refcount of the timeline so you should gst::ObjectExt::unref it after usage.

Returns

timeline of self, this can be None if self has no timeline. unref after usage.

Gets the toplevel TimelineElement controlling self

Returns

The toplevel controlling parent of self

Gets all the TrackTypes self will interact with

Gets an array of gobject::ParamSpec* for all configurable properties of the children of self.

n_properties

return location for the length of the returned array

Returns

an array of gobject::ParamSpec* which should be freed after use or None if something went wrong

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.

prop_name

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.

child

pointer to a gst::Element that takes the real object to set property on

pspec

pointer to take the gobject::ParamSpec describing the property

Returns

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.

Paste self inside the timeline. self must have been created using ges_timeline_element_copy with recurse=TRUE set, otherwise it will fail.

paste_position

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

Returns

Paste self copying the element

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.

start

The new start of self in ripple mode.

Returns

true if the self as been rippled properly, false if an error occured

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.

end

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

Returns

true if the self as been rippled properly, false if an error occured

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.

end

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

Returns

true if the self as been rolled properly, false if an error occured

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.

start

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

Returns

true if the self as been roll properly, false if an error occured

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.

first_property_name

The name of the first property to set

Sets a property of a child of self

Note that TimelineElementExt::set_child_property is really intended for language bindings, TimelineElementExt::set_child_properties is much more convenient for C programming.

property_name

The name of the property

value

the value

Returns

true if the property was set, false otherwize

Sets a property of a child of self.

pspec

The gobject::ParamSpec that specifies the property you want to set

value

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.

first_property_name

The name of the first property to set

var_args

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.

duration

the duration in gst::ClockTime

Returns

true if duration could be set.

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

inpoint

the in-point in gst::ClockTime

Returns

true if inpoint could be set.

Set the maximun duration of the object

maxduration

the maximum duration in gst::ClockTime

Returns

true if maxduration could be set.

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.

name

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.

parent

new parent of self

Returns

true if parent could be set or false when self already had a parent or self and parent are the same.

Sets the priority of the object within the containing layer

Deprecated

All priority management is done by GES itself now. To set Effect priorities ClipExt::set_top_effect_index should be used.

priority

the priority

Returns

true if priority could be set.

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.

start

the position in gst::ClockTime

Returns

true if start could be set.

Sets the timeline of self to timeline.

timeline

The Timeline self is in

Returns

true if timeline could be set or false when timeline already had a timeline.

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.

start

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

Returns

true if the self as been trimmed properly, false if an error occured

The deep notify signal is used to be notified of property changes of all the childs of timeline_element

prop_object

the object that originated the signal

prop

the property that changed

The duration (in nanoseconds) which will be used in the container

The duration (in nanoseconds) which will be used in the container

The in-point at which this TimelineElement 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 in-point at which this TimelineElement 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 TimelineElement.

The maximum duration (in nanoseconds) of the TimelineElement.

The name of the object

The name of the object

The parent container 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.

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.

Whether the element should be serialized.

The position of the object in its container (in nanoseconds).

The position of the object in its container (in nanoseconds).

The timeline in which element is

The timeline in which element is

Corresponds to one output format (i.e. audio OR video).

Contains the compatible TrackElement(s).

Implements

GESTrackExt, gst::ElementExt, gst::ObjectExt, glib::object::ObjectExt

Trait containing all Track methods.

Implementors

Track

Creates a new Track 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.

type_

The type of track

caps

The caps to restrict the output of the track to.

Returns

A new Track.

Adds the given object to the track. Sets the object's controlling track, and thus takes ownership of the object.

An object can only be added to one track.

object

the TrackElement to add

Returns

true if the object was properly added. false if the track does not want to accept the object.

Commits all the pending changes of the TrackElement contained in the track.

When timing changes happen in a timeline, the changes are not directly done inside NLE. This method needs to be called so any changes on a clip contained in the timeline actually happen at the media processing level.

Returns

true if something as been commited false if nothing needed to be commited

Get the gst::Caps this track is configured to output.

Returns

The gst::Caps this track is configured to output.

Gets the TrackElement contained in self

Returns

the list of TrackElement present in the Track sorted by priority and start.

Gets if the underlying NleComposition contains an expandable mixer.

Returns

True if there is a mixer, False otherwise.

Get the Timeline this track belongs to. Can be None.

Returns

The Timeline this track belongs to. Can be None.

Removes the object from the track and unparents it. Unparenting it means the reference owned by self on the object will be removed. If you wish to use the object after this function, make sure you call gst::ObjectExt::ref before removing it from the self.

object

the TrackElement 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).

Sets the function that should be used to create the GstElement used to fill gaps. To avoid to provide such a function we advice you to use the AudioTrack::new and VideoTrack::new constructor when possible.

func

The GESCreateElementForGapFunc that will be used to create gst::Element to fill gaps

Sets if the Track should be mixing.

mixing

TRUE if the track should be mixing, FALSE otherwise.

Sets the given caps as the caps the track has to output.

caps

the gst::Caps to set

Sets timeline as the timeline controlling self.

timeline

a Timeline

Updates the restriction caps by modifying all the fields present in caps in the original restriction caps. If for example the current restriction caps are video/x-raw, format=I420, width=360 and caps is video/x-raw, format=RGB, the restriction caps will be updated to video/x-raw, format=RGB, width=360.

Modification happens for each structure in the new caps, and one can add new fields or structures through that function.

caps

the gst::Caps to update with

Will be emitted after a track element was added to the track.

effect

the TrackElement that was added.

Will be emitted after a track element was removed from the track.

effect

the TrackElement that was removed.

Caps used to filter/choose the output stream. This is generally set to a generic set of caps like 'video/x-raw' for raw video.

Default value: GST_CAPS_ANY.

Caps used to filter/choose the output stream. This is generally set to a generic set of caps like 'video/x-raw' for raw video.

Default value: GST_CAPS_ANY.

Current duration of the track

Default value: O

Whether layer mixing is activated or not on the track.

Whether layer mixing is activated or not on the track.

Caps used to filter/choose the output stream.

Default value: GST_CAPS_ANY.

Caps used to filter/choose the output stream.

Default value: GST_CAPS_ANY.

Type of stream the track outputs. This is used when creating the Track 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 Track without having to actually check the Track's caps property.

Type of stream the track outputs. This is used when creating the Track 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 Track without having to actually check the Track's caps property.

TrackElement is the Base Class for any object that can be contained in a Track.

It contains the basic information as to the location of the object within its container, like the start position, the inpoint, the duration and the priority.

Implements

TrackElementExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all TrackElement methods.

Implementors

TrackElement

Looks for the properties defines with the various parametters and add them to the hashtable of children properties.

To be used by subclasses only

element

The GstElement to retrieve properties from

wanted_categories

An array of categories of GstElement to take into account (as defined in the factory meta "klass" field)

blacklist

A blacklist of elements factory names to not take into account

whitelist

A list of propery names to add as children properties

Edit self in the different exisiting EditMode modes. In the case of slide, and roll, you need to specify a Edge

layers

The layers you want the edit to happen in, None means that the edition is done in all the GESLayers contained in the current timeline. FIXME: This is not implemented yet.

mode

The EditMode in which the edition will happen.

edge

The Edge the edit should happen on.

position

The position at which to edit self (in nanosecond)

Returns

true if the object as been edited properly, false if an error occured

Returns

A glib::HashTable containing all property_name: GstControlBinding

Gets properties of a child of self.

Deprecated

Use TimelineElementExt::get_child_properties

first_property_name

The name of the first property to get

In general, a copy is made of the property contents and the caller is responsible for freeing the memory by calling gobject::Value::unset.

Gets a property of a GstElement contained in self.

Note that TrackElement::get_child_property is really intended for language bindings, TrackElement::get_child_properties is much more convenient for C programming.

Deprecated

Use TimelineElementExt::get_child_property

property_name

The name of the property

value

return location for the property value, it will be initialized if it is initialized with 0

Returns

true if the property was found, false otherwize

Gets a property of a child of self.

Deprecated

Use TimelineElementExt::get_child_property_by_pspec

pspec

The gobject::ParamSpec that specifies the property you want to get

value

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.

Deprecated

Use TimelineElementExt::get_child_property_valist

first_property_name

The name of the first property to get

var_args

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

Looks up the various controlled properties for that TrackElement, and returns the gst::ControlBinding which controls property_name.

property_name

The property_name to which the binding is associated.

Returns

the gst::ControlBinding associated with property_name, or None if that property is not controlled.

Get the gst::Element this track element is controlling within GNonLin.

Returns

the gst::Element this track element is controlling within GNonLin.

Get the NleObject object this object is controlling.

Deprecated

use TrackElementExt::get_nleobject instead.

Returns

the NleObject object this object is controlling.

Get the GNonLin object this object is controlling.

Returns

the GNonLin object this object is controlling.

Get the Track to which this object belongs.

Returns

The Track to which this object belongs. Can be None if it is not in any track

Lets you know if self will be used for playback and rendering, or not.

Returns

true if self is active, false otherwize

Gets an array of gobject::ParamSpec* for all configurable properties of the children of self.

Deprecated

Use TimelineElementExt::list_children_properties

n_properties

return location for the length of the returned array

Returns

an array of gobject::ParamSpec* which should be freed after use or None if something went wrong

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.

Deprecated

Use TimelineElementExt::lookup_child

prop_name

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.

element

pointer to a gst::Element that takes the real object to set property on

pspec

pointer to take the gobject::ParamSpec describing the property

Returns

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.

Removes a gst::ControlBinding from self.

property_name

The name of the property to control.

Returns

true if the binding could be removed, false if an error occured

Sets the usage of the self. If active is true, the object will be used for playback and rendering, else it will be ignored.

active

visibility

Returns

true if the property was toggled, else false

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.

Deprecated

Use TimelineElementExt::set_child_properties

first_property_name

The name of the first property to set

Sets a property of a GstElement contained in self.

Note that TrackElement::set_child_property is really intended for language bindings, TrackElement::set_child_properties is much more convenient for C programming.

Deprecated

use TimelineElementExt::set_child_property instead

property_name

The name of the property

value

the value

Returns

true if the property was set, false otherwize

Sets a property of a child of self.

Deprecated

Use ges_timeline_element_set_child_property_by_spec

pspec

The gobject::ParamSpec that specifies the property you want to set

value

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.

Deprecated

Use TimelineElementExt::set_child_property_valist

first_property_name

The name of the first property to set

var_args

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

Creates a gst::ControlBinding and adds it to the gst::Element concerned by the property. Use the same syntax as TrackElementExt::lookup_child for the property name.

source

the gst::ControlSource to set on the binding.

property_name

The name of the property to control.

binding_type

The type of binding to create. Currently the following values are valid:

  • "direct": See gst_direct_control_binding_new
  • "direct-absolute": See gst_direct_control_binding_new_absolute

Returns

true if the binding could be created and added, false if an error occured

The control-binding-added signal is emitted each time a control binding is added for a child property of track_element

control_binding

the gst::ControlBinding that has been added

The control-binding-removed signal is emitted each time a control binding is removed for a child property of track_element

control_binding

the gst::ControlBinding that has been removed

Whether the object should be taken into account in the Track output. If false, then its contents will not be used in the resulting track.

Whether the object should be taken into account in the Track output. If false, then its contents will not be used in the resulting track.

Represents all the output streams from a particular uri. It is assumed that the URI points to a file of some type.

Implements

UriClipExt, ClipExt, GESContainerExt, TimelineElementExt, glib::object::ObjectExt, ExtractableExt

Trait containing all UriClip methods.

Implementors

UriClip

Creates a new UriClip for the provided uri.

uri

the URI the source should control

Returns

The newly created UriClip, or None if there was an error.

Get the location of the resource.

Returns

The location of the resource.

Lets you know if self is an image or not.

Returns

true if self is a still image false otherwise.

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

Returns

true if the audio track of self is muted, false otherwise.

Sets whether the clip is a still image or not.

is_image

true if self is a still image, false otherwise

Sets whether the audio track of this clip is muted or not.

mute

true to mute self audio track, false to unmute it

Whether this uri clip represents a still image or not. This must be set before create_track_elements is called.

Whether this uri clip represents a still image or not. This must be set before create_track_elements is called.

Whether the sound will be played or not.

Whether the sound will be played or not.

The location of the file/resource to use.

The location of the file/resource to use.

The UriClipAsset is a special Asset that lets you handle the media file to use inside the GStreamer Editing Services. It has APIs that let you get information about the medias. Also, the tags found in the media file are set as Metadata of the Asset.

Implements

UriClipAssetExt, AssetExt, glib::object::ObjectExt

Trait containing all UriClipAsset methods.

Implementors

UriClipAsset

Finalize the request of an async UriClipAsset

res

The gio::AsyncResult from which to get the newly created UriClipAsset

Returns

The UriClipAsset previously requested

Creates a UriClipAsset for uri

Example of request of a GESUriClipAsset:

// The request callback
static void
filesource_asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data)
{
  GError *error = NULL;
  GESUriClipAsset *filesource_asset;

  filesource_asset = ges_uri_clip_asset_finish (res, &error);
  if (filesource_asset) {
   g_print ("The file: %s is usable as a FileSource, it is%s an image and lasts %" GST_TIME_FORMAT,
       ges_asset_get_id (GES_ASSET (filesource_asset))
       ges_uri_clip_asset_is_image (filesource_asset) ? "" : " not",
       GST_TIME_ARGS (ges_uri_clip_asset_get_duration (filesource_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_uri_clip_asset_new (uri, (GAsyncReadyCallback) filesource_asset_loaded_cb, user_data);

uri

The URI of the file for which to create a UriClipAsset

cancellable

optional gio::Cancellable object, None to ignore.

callback

a GAsyncReadyCallback to call when the initialization is finished

user_data

The user data to pass when callback is called

Creates a UriClipAsset for uri syncronously. You should avoid to use it in application, and rather create UriClipAsset asynchronously

uri

The URI of the file for which to create a UriClipAsset. You can also use multi file uris for MultiFileSource.

Returns

A reference to the requested asset or None if an error happened

Gets duration of the file represented by self

Returns

The duration of self

Gets gst_pbutils::DiscovererInfo about the file

Returns

gst_pbutils::DiscovererInfo of specified asset

Get the GESUriSourceAsset self containes

Returns

a glib::List of UriSourceAsset

Gets Whether the file represented by self is an image or not

Returns

Whether the file represented by self is an image or not

The duration (in nanoseconds) of the media file

The duration (in nanoseconds) of the media file

NOTE: You should never request such a Asset as they will be created automatically by UriClipAsset-s.

Implements

UriSourceAssetExt, AssetExt, glib::object::ObjectExt

Trait containing all UriSourceAsset methods.

Implementors

UriSourceAsset

Get the UriClipAsset self_ is contained in

Returns

a UriClipAsset

Get the gst_pbutils::DiscovererStreamInfo user by self

Returns

a UriClipAsset