mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-04 07:26:33 +00:00
Code Issues 1 Projects Releases Wiki Activity

uri-clip: Add a warning about synchronous uri discovery

Browse source 
Part-of: <https://gitlab.freedesktop.org/gstreamer/gst-editing-services/-/merge_requests/189>
This commit is contained in:
Thibault Saunier 2020-06-15 12:23:26 -04:00
parent 4fd1bb8163
commit 9e0fbe964f
2 changed files with 10 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
ges/ges-asset.c
View file

@ -1359,7 +1359,7 @@ ges_asset_request (GType extractable_type, const gchar * id, GError ** error)
* calling ges_init(). * calling ges_init().
* *
* Example of an asynchronous asset request: * Example of an asynchronous asset request:
* |[ * ``` c
* // The request callback * // The request callback
* static void * static void
* asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data) * asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data)
@ -1369,20 +1369,20 @@ ges_asset_request (GType extractable_type, const gchar * id, GError ** error)
* *
* asset = ges_asset_request_finish (res, &error); * asset = ges_asset_request_finish (res, &error);
* if (asset) { * if (asset) {
* g_print ("The file: %s is usable as a FileSource", * g_print ("The file: %s is usable as a GESUriClip",
* ges_asset_get_id (asset)); * ges_asset_get_id (asset));
* } else { * } else {
* g_print ("The file: %s is *not* usable as a FileSource because: %s", * g_print ("The file: %s is *not* usable as a GESUriClip because: %s",
* ges_asset_get_id (source), error->message); * ges_asset_get_id (source), error->message);
* } * }
* *
* gst_object_unref (mfs); * gst_object_unref (asset);
* } * }
* *
* // The request: * // The request:
* ges_asset_request_async (GES_TYPE_URI_CLIP, some_uri, NULL, * ges_asset_request_async (GES_TYPE_URI_CLIP, some_uri, NULL,
* (GAsyncReadyCallback) asset_loaded_cb, user_data); * (GAsyncReadyCallback) asset_loaded_cb, user_data);
* ]| * ```
*/ */
void void
ges_asset_request_async (GType extractable_type, ges_asset_request_async (GType extractable_type,

5
ges/ges-uri-clip.c
View file

@ -541,6 +541,11 @@ ges_uri_clip_create_track_elements (GESClip * clip, GESTrackType type)
* *
* Creates a new #GESUriClip for the provided @uri. * Creates a new #GESUriClip for the provided @uri.
* *
* > **WARNING**: This function might 'discover` @uri **synchrounously**, it is
* > an IO and processing intensive task that you probably don't want to run in
* > an application mainloop. Have a look at #ges_asset_request_async to see how
* > to make that operation happen **asynchronously**.
*
* Returns: (transfer floating) (nullable): The newly created #GESUriClip, or * Returns: (transfer floating) (nullable): The newly created #GESUriClip, or
* %NULL if there was an error. * %NULL if there was an error.
*/ */