GESAsset

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 GESClip, GESFormatter, and GESTrackElement do implement it. This means that assets will represent for example a GESUriClip, 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 GESAsset for GESFormatter and GESTransitionClip 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 GESAsset using either ges_asset_request_async or ges_asset_request_async. All the GESAsset are cached and thus any asset that has already been created can be requested again without overhead.

GESAsset

GObject
    ╰──GESAsset
        ╰──GESClipAsset
        ╰──GESProject
        ╰──GESTrackElementAsset

Implemented interfaces: GESMetaContainer, GAsyncInitable, GInitable

Members

parent (GObject) –
No description available

Class structure

GESAssetClass

Fields
parent (GObjectClass) –
No description available
_ges_reserved (gpointer) –
No description available

GES.AssetClass

Attributes
AssetClass.parent (GObject.ObjectClass) –
No description available
AssetClass._ges_reserved ([ object ]) –
No description available

GES.AssetClass

GES.AssetClass

Attributes
AssetClass.parent (GObject.ObjectClass) –
No description available
AssetClass._ges_reserved ([ Object ]) –
No description available

GESAsset

GObject
    ╰──GESAsset
        ╰──GESClipAsset
        ╰──GESProject
        ╰──GESTrackElementAsset

Implemented interfaces: GESMetaContainer, GAsyncInitable, GInitable

Members

parent (GObject) –
No description available

GESAsset

GObject
    ╰──GESAsset
        ╰──GESClipAsset
        ╰──GESProject
        ╰──GESTrackElementAsset

Implemented interfaces: GESMetaContainer, GAsyncInitable, GInitable

GESAsset

GObject
    ╰──GESAsset
        ╰──GESClipAsset
        ╰──GESProject
        ╰──GESTrackElementAsset

Implemented interfaces: GESMetaContainer, GAsyncInitable, GInitable

Members

parent (GObject) –
No description available

Methods

ges_asset_extract

GESExtractable *
ges_asset_extract (GESAsset * self)

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

Parameters:

self

The GESAsset to get extract an object from

Returns ( [transfer: floating] [allow-none] ) –

A newly created GESExtractable

GES.Asset.extract

@raises(GLib.GError)
def GES.Asset.extract (self):
    #python wrapper for 'ges_asset_extract'

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 GES.Asset.get_extractable_type

Parameters:

self ( GES.Asset ) –

The GES.Asset to get extract an object from

Returns ( GES.Extractable ) –

A newly created GES.Extractable

GES.Asset.Extract

GES.IExtractable
GES.Asset.Extract ()

Extracts a new GLib.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 GES.Asset.GetExtractableType

Returns

A newly created GES.IExtractable

GES.prototype.extract

function GES.prototype.extract(): {
    // javascript wrapper for 'ges_asset_extract'
}

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 GES.prototype.get_extractable_type

Parameters:

self ( GES.Asset ) –

The GES.Asset to get extract an object from

Returns ( GES.Extractable ) –

A newly created GES.Extractable

ges_asset_get_error

GError *
ges_asset_get_error (GESAsset * self)

Parameters:

self

The asset to retrieve the error from

Returns ( [transfer: none] [nullable] ) –

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

Since : 1.8

GES.Asset.get_error

def GES.Asset.get_error (self):
    #python wrapper for 'ges_asset_get_error'

Parameters:

self ( GES.Asset ) –

The asset to retrieve the error from

Returns ( GLib.Error ) –

The GLib.Error of the asset or None if the asset was loaded without issue

Since : 1.8

GES.prototype.get_error

function GES.prototype.get_error(): {
    // javascript wrapper for 'ges_asset_get_error'
}

Parameters:

self ( GES.Asset ) –

The asset to retrieve the error from

Returns ( GLib.Error ) –

The GLib.Error of the asset or null if the asset was loaded without issue

Since : 1.8

ges_asset_get_extractable_type

GType
ges_asset_get_extractable_type (GESAsset * self)

Gets the type of object that can be extracted from self

Parameters:

self

The GESAsset

Returns

the type of object that can be extracted from self

GES.Asset.get_extractable_type

def GES.Asset.get_extractable_type (self):
    #python wrapper for 'ges_asset_get_extractable_type'

Gets the type of object that can be extracted from self

Parameters:

self ( GES.Asset ) –

The GES.Asset

Returns ( GObject.Type ) –

the type of object that can be extracted from self

GES.prototype.get_extractable_type

function GES.prototype.get_extractable_type(): {
    // javascript wrapper for 'ges_asset_get_extractable_type'
}

Gets the type of object that can be extracted from self

Parameters:

self ( GES.Asset ) –

The GES.Asset

Returns ( GObject.Type ) –

the type of object that can be extracted from self

ges_asset_get_id

const gchar *
ges_asset_get_id (GESAsset * self)

Gets the ID of a GESAsset

Parameters:

self

The GESAsset to get ID from

Returns

The ID of self

GES.Asset.get_id

def GES.Asset.get_id (self):
    #python wrapper for 'ges_asset_get_id'

Gets the ID of a GES.Asset

Parameters:

self ( GES.Asset ) –

The GES.Asset to get ID from

Returns ( str ) –

The ID of self

GES.prototype.get_id

function GES.prototype.get_id(): {
    // javascript wrapper for 'ges_asset_get_id'
}

Gets the ID of a GES.Asset

Parameters:

self ( GES.Asset ) –

The GES.Asset to get ID from

Returns ( String ) –

The ID of self

ges_asset_get_proxy

GESAsset *
ges_asset_get_proxy (GESAsset * asset)

Parameters:

asset

The GESAsset to get currenlty used proxy

Returns ( [transfer: none] [nullable] ) –

The proxy in use for asset

GES.Asset.get_proxy

def GES.Asset.get_proxy (self):
    #python wrapper for 'ges_asset_get_proxy'

Parameters:

asset ( GES.Asset ) –

The GES.Asset to get currenlty used proxy

Returns ( GES.Asset ) –

The proxy in use for asset

GES.prototype.get_proxy

function GES.prototype.get_proxy(): {
    // javascript wrapper for 'ges_asset_get_proxy'
}

Parameters:

asset ( GES.Asset ) –

The GES.Asset to get currenlty used proxy

Returns ( GES.Asset ) –

The proxy in use for asset

ges_asset_get_proxy_target

GESAsset *
ges_asset_get_proxy_target (GESAsset * proxy)

Parameters:

proxy

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

Returns ( [transfer: none] [nullable] ) –

The GESAsset that is proxied by proxy

GES.Asset.get_proxy_target

def GES.Asset.get_proxy_target (self):
    #python wrapper for 'ges_asset_get_proxy_target'

Parameters:

proxy ( GES.Asset ) –

The GES.Asset from which to get the the asset it proxies.

Returns ( GES.Asset ) –

The GES.Asset that is proxied by proxy

GES.prototype.get_proxy_target

function GES.prototype.get_proxy_target(): {
    // javascript wrapper for 'ges_asset_get_proxy_target'
}

Parameters:

proxy ( GES.Asset ) –

The GES.Asset from which to get the the asset it proxies.

Returns ( GES.Asset ) –

The GES.Asset that is proxied by proxy

ges_asset_list_proxies

GList *
ges_asset_list_proxies (GESAsset * asset)

Parameters:

asset

The GESAsset to get proxies from

Returns ( [element-type GESAsset] [transfer: none] ) –

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

GES.Asset.list_proxies

def GES.Asset.list_proxies (self):
    #python wrapper for 'ges_asset_list_proxies'

Parameters:

asset ( GES.Asset ) –

The GES.Asset to get proxies from

Returns ( [ GES.Asset ] ) –

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

GES.Asset.ListProxies

GES.Asset []
GES.Asset.ListProxies ()
Returns

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

GES.prototype.list_proxies

function GES.prototype.list_proxies(): {
    // javascript wrapper for 'ges_asset_list_proxies'
}

Parameters:

asset ( GES.Asset ) –

The GES.Asset to get proxies from

Returns ( [ GES.Asset ] ) –

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

ges_asset_set_proxy

gboolean
ges_asset_set_proxy (GESAsset * asset,
                     GESAsset * proxy)

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.

Parameters:

asset

The GESAsset to set proxy on

proxy ( [allow-none] ) –

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.

Returns

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

GES.Asset.set_proxy

def GES.Asset.set_proxy (self, proxy):
    #python wrapper for 'ges_asset_set_proxy'

A proxying asset is an asset that can substitue the real asset. For example if you have a full HD GES.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 GES.Asset.request will actually return the proxy asset.

Parameters:

asset ( GES.Asset ) –

The GES.Asset to set proxy on

proxy ( GES.Asset ) –

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

Returns ( bool ) –

True if proxy has been set on asset, False otherwise.

GES.Asset.SetProxy

bool
GES.Asset.SetProxy (GES.Asset)

A proxying asset is an asset that can substitue the real asset. For example if you have a full HD GES.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 GES.Asset.Request will actually return the proxy asset.

Parameters:

proxy

The GES.Asset 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.

Returns

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

GES.prototype.set_proxy

function GES.prototype.set_proxy(proxy: GES.Asset): {
    // javascript wrapper for 'ges_asset_set_proxy'
}

A proxying asset is an asset that can substitue the real asset. For example if you have a full HD GES.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 GES.prototype.request will actually return the proxy asset.

Parameters:

asset ( GES.Asset ) –

The GES.Asset to set proxy on

proxy ( GES.Asset ) –

The GES.Asset 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.

Returns ( Number ) –

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

ges_asset_unproxy

gboolean
ges_asset_unproxy (GESAsset * asset,
                   GESAsset * proxy)

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

Parameters:

asset

The GESAsset to stop proxying with proxy

proxy

The GESAsset to stop considering as a proxy for asset

Returns

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

GES.Asset.unproxy

def GES.Asset.unproxy (self, proxy):
    #python wrapper for 'ges_asset_unproxy'

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

Parameters:

asset ( GES.Asset ) –

The GES.Asset to stop proxying with proxy

proxy ( GES.Asset ) –

The GES.Asset to stop considering as a proxy for asset

Returns ( bool ) –

True if proxy was a known proxy for asset, False otherwise.

GES.Asset.Unproxy

bool
GES.Asset.Unproxy (GES.Asset)

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

Parameters:

proxy

The GES.Asset to stop considering as a proxy for asset

Returns

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

GES.prototype.unproxy

function GES.prototype.unproxy(proxy: GES.Asset): {
    // javascript wrapper for 'ges_asset_unproxy'
}

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

Parameters:

asset ( GES.Asset ) –

The GES.Asset to stop proxying with proxy

proxy ( GES.Asset ) –

The GES.Asset to stop considering as a proxy for asset

Returns ( Number ) –

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

Properties

Error

GLib.Error Error { get;  }

Flags : Read

ExtractableType

GType ExtractableType { get;  }

Gets the type of object that can be extracted from self

Flags : Read

IdField

string IdField { get;  }

Gets the ID of a GES.Asset

Flags : Read

ProxyField

GES.Asset ProxyField { get;  }

Flags : Read

ProxyTarget

GES.Asset ProxyTarget { get;  }

Flags : Read

extractable-type

“extractable-type” GType

Flags : Read / Write / Construct Only

extractable-type

“extractable-type” GObject.Type

Flags : Read / Write / Construct Only

ExtractableType

GType ExtractableType { get; set;  }

Flags : Read / Write / Construct Only

extractable-type

“extractable-type” GObject.Type

Flags : Read / Write / Construct Only

id

“id” gchar *

Flags : Read / Write / Construct Only

id

“id” str

Flags : Read / Write / Construct Only

Id

string Id { get; set;  }

Flags : Read / Write / Construct Only

id

“id” String

Flags : Read / Write / Construct Only

proxy

“proxy” GESAsset *

Flags : Read / Write

proxy

“proxy” GES.Asset

Flags : Read / Write

Proxy

GES.Asset Proxy { get; set;  }

Flags : Read / Write

proxy

“proxy” GES.Asset

Flags : Read / Write

proxy-target

“proxy-target” GESAsset *

Flags : Read / Write

proxy-target

“proxy-target” GES.Asset

Flags : Read / Write

ProxyTarget

GES.Asset ProxyTarget { get; set;  }

Flags : Read / Write

proxy-target

“proxy-target” GES.Asset

Flags : Read / Write

Virtual Methods

extract

GESExtractable *
extract (GESAsset * self)

Parameters:

self
No description available
Returns
No description available

extract

def extract (self):
    #python implementation of the 'extract' virtual method

Parameters:

self ( GES.Asset ) –
No description available
Returns ( GES.Extractable ) –
No description available

Extract

GES.IExtractable
Extract ()
Returns
No description available

extract

function extract(self: GES.Asset): {
    // javascript implementation of the 'extract' virtual method
}

Parameters:

self ( GES.Asset ) –
No description available
Returns ( GES.Extractable ) –
No description available

inform_proxy

inform_proxy (GESAsset * self,
              const gchar * proxy_id)

Parameters:

self
No description available
proxy_id
No description available

inform_proxy

def inform_proxy (self, proxy_id):
    #python implementation of the 'inform_proxy' virtual method

Parameters:

self ( GES.Asset ) –
No description available
proxy_id ( str ) –
No description available

InformProxy

InformProxy (string)

Parameters:

proxy_id
No description available

inform_proxy

function inform_proxy(self: GES.Asset, proxy_id: String): {
    // javascript implementation of the 'inform_proxy' virtual method
}

Parameters:

self ( GES.Asset ) –
No description available
proxy_id ( String ) –
No description available

proxied

proxied (GESAsset * self,
         GESAsset * proxy)

Parameters:

self
No description available
proxy
No description available

proxied

def proxied (self, proxy):
    #python implementation of the 'proxied' virtual method

Parameters:

self ( GES.Asset ) –
No description available
proxy ( GES.Asset ) –
No description available

Proxied

Proxied (GES.Asset)

Parameters:

proxy
No description available

proxied

function proxied(self: GES.Asset, proxy: GES.Asset): {
    // javascript implementation of the 'proxied' virtual method
}

Parameters:

self ( GES.Asset ) –
No description available
proxy ( GES.Asset ) –
No description available

request_id_update

gboolean
request_id_update (GESAsset * self,
                   gchar ** proposed_new_id,
                   GError * error)

Parameters:

self
No description available
proposed_new_id
No description available
error
No description available
Returns
No description available

request_id_update

def request_id_update (self, proposed_new_id, error):
    #python implementation of the 'request_id_update' virtual method

Parameters:

self ( GES.Asset ) –
No description available
proposed_new_id ( str ) –
No description available
error ( GLib.Error ) –
No description available
Returns ( bool ) –
No description available

RequestIdUpdate

bool
RequestIdUpdate (string,
                 GLib.Error)

Parameters:

proposed_new_id
No description available
error
No description available
Returns
No description available

request_id_update

function request_id_update(self: GES.Asset, proposed_new_id: String, error: GLib.Error): {
    // javascript implementation of the 'request_id_update' virtual method
}

Parameters:

self ( GES.Asset ) –
No description available
proposed_new_id ( String ) –
No description available
error ( GLib.Error ) –
No description available
Returns ( Number ) –
No description available

start_loading

GESAssetLoadingReturn
start_loading (GESAsset * self)

Parameters:

self
No description available
Returns
No description available

start_loading

def start_loading (self):
    #python implementation of the 'start_loading' virtual method

Parameters:

self ( GES.Asset ) –
No description available
Returns ( GES.AssetLoadingReturn ) –
No description available

StartLoading

GES.AssetLoadingReturn
StartLoading ()
Returns
No description available

start_loading

function start_loading(self: GES.Asset): {
    // javascript implementation of the 'start_loading' virtual method
}

Parameters:

self ( GES.Asset ) –
No description available
Returns ( GES.AssetLoadingReturn ) –
No description available

Properties

Parent

GObject.ObjectClass Parent { get; set;  }

Flags : Read / Write

GesReserved

IntPtr [] GesReserved { get; set;  }

Flags : Read / Write

Functions

ges_asset_needs_reload

gboolean
ges_asset_needs_reload (GType extractable_type,
                        const gchar * id)

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.

Parameters:

extractable_type

The GType 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.

GES.Asset.needs_reload

def GES.Asset.needs_reload (extractable_type, id):
    #python wrapper for 'ges_asset_needs_reload'

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.

Parameters:

extractable_type ( GObject.Type ) –

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

id ( str ) –

The identifier of the asset to mark as needing reload

Returns ( bool ) –

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

GES.Asset.NeedsReload

bool
GES.Asset.NeedsReload (GType,
                       string)

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.

Parameters:

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.

GES.prototype.needs_reload

function GES.prototype.needs_reload(extractable_type: GObject.Type, id: String): {
    // javascript wrapper for 'ges_asset_needs_reload'
}

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.

Parameters:

extractable_type ( GObject.Type ) –

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

id ( String ) –

The identifier of the asset to mark as needing reload

Returns ( Number ) –

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

ges_asset_request

GESAsset *
ges_asset_request (GType extractable_type,
                   const gchar * id)

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.

Parameters:

extractable_type

The GType of the object that can be extracted from the new asset.

id ( [allow-none] ) –

The Identifier or NULL

Returns ( [transfer: full] [allow-none] ) –

A reference to the wanted GESAsset or NULL

GES.Asset.request

@raises(GLib.GError)
def GES.Asset.request (extractable_type, id):
    #python wrapper for 'ges_asset_request'

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

Parameters:

extractable_type ( GObject.Type ) –

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

id ( str ) –

The Identifier or None

Returns ( GES.Asset ) –

A reference to the wanted GES.Asset or None

GES.Asset.Request

GES.Asset
GES.Asset.Request (GType,
                   string)

Create a GES.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 GES.UriClipAsset.RequestSync method if you really want to.

Parameters:

extractable_type

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

id

The Identifier or null

Returns

A reference to the wanted GES.Asset or null

GES.prototype.request

function GES.prototype.request(extractable_type: GObject.Type, id: String): {
    // javascript wrapper for 'ges_asset_request'
}

Create a GES.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 GES.prototype.request_sync method if you really want to.

Parameters:

extractable_type ( GObject.Type ) –

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

id ( String ) –

The Identifier or null

Returns ( GES.Asset ) –

A reference to the wanted GES.Asset or null

ges_asset_request_async

ges_asset_request_async (GType extractable_type,
                         const gchar * id,
                         GCancellable * cancellable,
                         GAsyncReadyCallback callback,
                         gpointer user_data)

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);

Parameters:

extractable_type

The GType of the object that can be extracted from the new asset. The class must implement the GESExtractable 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 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.

cancellable ( [allow-none] ) –

optional GCancellable object, NULL to ignore.

callback

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.

user_data

The user data to pass when callback is called

GES.Asset.request_async

def GES.Asset.request_async (extractable_type, id, cancellable, callback, user_data):
    #python wrapper for 'ges_asset_request_async'

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

Parameters:

extractable_type ( GObject.Type ) –

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

id ( str ) –

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

cancellable ( Gio.Cancellable ) –

optional Gio.Cancellable object, None to ignore.

callback ( Gio.AsyncReadyCallback ) –

a Gio.AsyncReadyCallback to call when the initialization is finished, Note that the source of the callback will be the GES.Asset, 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.

user_data ( object ) –

The user data to pass when callback is called

GES.Asset.RequestAsync

GES.Asset.RequestAsync (GType,
                        string,
                        Gio.Cancellable,
                        Gio.AsyncReadyCallback,
                        IntPtr)

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

Parameters:

extractable_type

The GLib.Type of the object that can be extracted from the new asset. The class must implement the GES.IExtractable 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 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 GES.IExtractable type you want to create a GES.Asset for.

cancellable

optional Gio.Cancellable object, null to ignore.

callback

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

user_data

The user data to pass when callback is called

GES.prototype.request_async

function GES.prototype.request_async(extractable_type: GObject.Type, id: String, cancellable: Gio.Cancellable, callback: Gio.AsyncReadyCallback, user_data: Object): {
    // javascript wrapper for 'ges_asset_request_async'
}

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

Parameters:

extractable_type ( GObject.Type ) –

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

id ( String ) –

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

cancellable ( Gio.Cancellable ) –

optional Gio.Cancellable object, null to ignore.

callback ( Gio.AsyncReadyCallback ) –

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

user_data ( Object ) –

The user data to pass when callback is called

ges_asset_request_finish

GESAsset *
ges_asset_request_finish (GAsyncResult * res)

Finalize the request of an async GESAsset

Parameters:

res

The GAsyncResult from which to get the newly created GESAsset

Returns ( [transfer: full] [allow-none] ) –

The GESAsset previously requested

GES.Asset.request_finish

@raises(GLib.GError)
def GES.Asset.request_finish (res):
    #python wrapper for 'ges_asset_request_finish'

Finalize the request of an async GES.Asset

Parameters:

res ( Gio.AsyncResult ) –

The Gio.AsyncResult from which to get the newly created GES.Asset

Returns ( GES.Asset ) –

The GES.Asset previously requested

GES.Asset.RequestFinish

GES.Asset
GES.Asset.RequestFinish (Gio.IAsyncResult)

Finalize the request of an async GES.Asset

Parameters:

res

The Gio.IAsyncResult from which to get the newly created GES.Asset

Returns

The GES.Asset previously requested

GES.prototype.request_finish

function GES.prototype.request_finish(res: Gio.AsyncResult): {
    // javascript wrapper for 'ges_asset_request_finish'
}

Finalize the request of an async GES.Asset

Parameters:

res ( Gio.AsyncResult ) –

The Gio.AsyncResult from which to get the newly created GES.Asset

Returns ( GES.Asset ) –

The GES.Asset previously requested

ges_list_assets

GList *
ges_list_assets (GType filter)

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

Parameters:

filter

Type of assets to list, GES_TYPE_EXTRACTABLE will list all assets

Returns ( [transfer: container] [element-type GESAsset] ) –

The list of GESAsset the object contains

GES.list_assets

def GES.list_assets (filter):
    #python wrapper for 'ges_list_assets'

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

Parameters:

filter ( GObject.Type ) –

Type of assets to list, GES_TYPE_EXTRACTABLE (not introspectable) will list all assets

Returns ( [ GES.Asset ] ) –

The list of GES.Asset the object contains

GES.Global.ListAssets

GES.Asset []
GES.Global.ListAssets (GType)

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

Parameters:

filter

Type of assets to list, GES_TYPE_EXTRACTABLE (not introspectable) will list all assets

Returns

The list of GES.Asset the object contains

prototype.list_assets

function prototype.list_assets(filter: GObject.Type): {
    // javascript wrapper for 'ges_list_assets'
}

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

Parameters:

filter ( GObject.Type ) –

Type of assets to list, GES_TYPE_EXTRACTABLE (not introspectable) will list all assets

Returns ( [ GES.Asset ] ) –

The list of GES.Asset the object contains

Constants

GES_TYPE_ASSET

#define GES_TYPE_ASSET ges_asset_get_type()

The results of the search are