Struct gstreamer_editing_services::Asset

pub struct Asset(_);

A crate::Asset in the GStreamer Editing Services represents a resources that can be used. In particular, any class that implements the crate::Extractable interface may have some associated assets with a corresponding [crate::Asset:extractable-type], from which its objects can be extracted using crate::prelude::AssetExt::extract(). Some examples would be crate::Clip, [crate::Formatter] and crate::TrackElement.

All assets that are created within GES are stored in a cache; one per each [crate::Asset:id] and [crate::Asset:extractable-type] pair. These assets can be fetched, and initialized if they do not yet exist in the cache, using Self::request().

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

The advantage of using assets, rather than simply creating the object directly, is that the currently loaded resources can be listed with ges_list_assets() and displayed to an end user. For example, to show which media files have been loaded, and a standard list of effects. In fact, the GES library already creates assets for crate::TransitionClip and [crate::Formatter], which you can use to list all the available transition types and supported formats.

The other advantage is that crate::Asset implements [crate::MetaContainer], so metadata can be set on the asset, with some subclasses automatically creating this metadata on initiation.

For example, to display information about the supported formats, you could do the following:

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

ID

Each asset is uniquely defined in the cache by its [crate::Asset:extractable-type] and [crate::Asset:id]. Depending on the [crate::Asset:extractable-type], the [crate::Asset:id] can be used to parametrise the creation of the object upon extraction. By default, a class that implements crate::Extractable will only have a single associated asset, with an [crate::Asset:id] set to the type name of its objects. However, this is overwritten by some implementations, which allow a class to have multiple associated assets. For example, for crate::TransitionClip the [crate::Asset:id] will be a nickname of the [crate::TransitionClip:vtype]. You should check the documentation for each extractable type to see if they differ from the default.

Moreover, each [crate::Asset:extractable-type] may also associate itself with a specific asset subclass. In such cases, when their asset is requested, an asset of this subclass will be returned instead.

Managing

You can use a crate::Project to easily manage the assets of a crate::Timeline.

Proxies

Some assets can (temporarily) act as the [crate::Asset:proxy] of another asset. When the original asset is requested from the cache, the proxy will be returned in its place. This can be useful if, say, you want to substitute a crate::UriClipAsset corresponding to a high resolution media file with the asset of a lower resolution stand in.

An asset may even have several proxies, the first of which will act as its default and be returned on requests, but the others will be ordered to take its place once it is removed. You can add a proxy to an asset, or set its default, using crate::prelude::AssetExt::set_proxy(), and you can remove them with crate::prelude::AssetExt::unproxy().

Implements

crate::prelude::AssetExt, glib::object::ObjectExt

Implementations

impl Asset

pub fn needs_reload(extractable_type: Type, id: Option<&str>) -> bool

Indicate that an existing crate::Asset in the cache should be reloaded upon the next request. This can be used when some condition has changed, which may require that an existing asset should be updated. For example, if an external resource has changed or now become available.

Note, the asset is not immediately changed, but will only actually reload on the next call to Self::request() or Self::request_async().

extractable_type

The [crate::Asset:extractable-type] of the asset that needs reloading

id

The [crate::Asset:id] of the asset asset that needs reloading

Returns

true if the specified asset exists in the cache and could be marked for reloading.

pub fn request(
    extractable_type: Type,
    id: Option<&str>
) -> Result<Option<Asset>, Error>

Returns an asset with the given properties. If such an asset already exists in the cache (it has been previously created in GES), then a reference to the existing asset is returned. Otherwise, a newly created asset is returned, and also added to the cache.

If the requested asset has been loaded with an error, then error is set, if given, and None will be returned instead.

Note that the given id may not be exactly the [crate::Asset:id] that is set on the returned asset. For instance, it may be adjusted into a standard format. Or, if a crate::Extractable type does not have its extraction parametrised, as is the case by default, then the given id may be ignored entirely and the [crate::Asset:id] set to some standard, in which case a None id can be given.

Similarly, the given extractable_type may not be exactly the [crate::Asset:extractable-type] that is set on the returned asset. Instead, the actual extractable type may correspond to a subclass of the given extractable_type, depending on the given id.

Moreover, depending on the given extractable_type, the returned asset may belong to a subclass of crate::Asset.

Finally, if the requested asset has a [crate::Asset:proxy], then the proxy that is found at the end of the chain of proxies is returned (a proxy’s proxy will take its place, and so on, unless it has no proxy).

Some asset subclasses only support asynchronous construction of its assets, such as crate::UriClip. For such assets this method will fail, and you should use Self::request_async() instead. In the case of crate::UriClip, you can use crate::UriClipAsset::request_sync() if you only want to wait for the request to finish.

extractable_type

The [crate::Asset:extractable-type] of the asset

id

The [crate::Asset:id] of the asset

Returns

A reference to the requested asset, or None if an error occurred.

pub fn request_async<P: IsA<Cancellable>, Q: FnOnce(Result<Asset, Error>) + Send + 'static>(
    extractable_type: Type,
    id: Option<&str>,
    cancellable: Option<&P>,
    callback: Q
)

Requests an asset with the given properties asynchronously (see Self::request()). When the asset has been initialized or fetched from the cache, the given callback function will be called. The asset can then be retrieved in the callback using the [Self::request_finish()] method on the given crate::gio::AsyncResult.

Note that the source object passed to the callback will be the crate::Asset corresponding to the request, but it may not have loaded correctly and therefore can not be used as is. Instead, [Self::request_finish()] should be used to fetch a usable asset, or indicate that an error occurred in the asset’s creation.

Note that the callback will be called in the crate::glib::MainLoop running under the same crate::glib::MainContext that ges_init() was called in. So, if you wish the callback to be invoked outside the default crate::glib::MainContext, you can call crate::glib::MainContext::push_thread_default() in a new thread before calling ges_init().

Example of an asynchronous asset request:

// 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 GESUriClip",
       ges_asset_get_id (asset));
  } else {
   g_print ("The file: %s is *not* usable as a GESUriClip because: %s",
       ges_asset_get_id (source), error->message);
  }

  gst_object_unref (asset);
}

// The request:
ges_asset_request_async (GES_TYPE_URI_CLIP, some_uri, NULL,
   (GAsyncReadyCallback) asset_loaded_cb, user_data);

extractable_type

The [crate::Asset:extractable-type] of the asset

id

The [crate::Asset:id] of the asset

cancellable

An object to allow cancellation of the asset request, or None to ignore

callback

A function to call when the initialization is finished

user_data

Data to be passed to callback

pub fn request_async_future(
    extractable_type: Type,
    id: Option<&str>
) -> Pin<Box_<dyn Future<Output = Result<Asset, Error>> + 'static>>

Trait Implementations

impl Clone for Asset

fn clone(&self) -> Asset

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Asset

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for Asset

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for Asset

fn cmp(&self, other: &Asset) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl ParentClassIs for Asset

type Parent = Object

impl<T: ObjectType> PartialEq<T> for Asset

fn eq(&self, other: &T) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use]

fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: ObjectType> PartialOrd<T> for Asset

fn partial_cmp(&self, other: &T) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Asset

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Asset

impl IsA<Asset> for Project

impl IsA<Asset> for UriClipAsset

impl IsA<Asset> for UriSourceAsset

impl StructuralEq for Asset