mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-26 11:41:09 +00:00
ges: add some g-i annotations according to documentation
Mainly (transfer xxx) and (nullable). Also fix some typo. https://bugzilla.gnome.org/show_bug.cgi?id=766459
This commit is contained in:
parent
dc95299080
commit
813c4b4fb7
33 changed files with 96 additions and 94 deletions
|
@ -477,7 +477,7 @@ _gtask_return_true (GTask * task, gpointer udata)
|
|||
*
|
||||
* Looks for asset with specified id in cache and it's completely loaded.
|
||||
*
|
||||
* Returns: (transfer none): The #GESAsset found or %NULL
|
||||
* Returns: (transfer none) (nullable): The #GESAsset found or %NULL
|
||||
*/
|
||||
GESAsset *
|
||||
ges_asset_cache_lookup (GType extractable_type, const gchar * id)
|
||||
|
@ -770,7 +770,7 @@ ges_asset_list_proxies (GESAsset * asset)
|
|||
* ges_asset_get_proxy:
|
||||
* @asset: The #GESAsset to get currenlty used proxy
|
||||
*
|
||||
* Returns: (transfer none): The proxy in use for @asset
|
||||
* Returns: (transfer none) (nullable): The proxy in use for @asset
|
||||
*/
|
||||
GESAsset *
|
||||
ges_asset_get_proxy (GESAsset * asset)
|
||||
|
@ -788,7 +788,7 @@ ges_asset_get_proxy (GESAsset * asset)
|
|||
* ges_asset_get_proxy_target:
|
||||
* @proxy: The #GESAsset from which to get the the asset it proxies.
|
||||
*
|
||||
* Returns: (transfer none): The #GESAsset that is proxied by @proxy
|
||||
* Returns: (transfer none) (nullable): The #GESAsset that is proxied by @proxy
|
||||
*/
|
||||
GESAsset *
|
||||
ges_asset_get_proxy_target (GESAsset * proxy)
|
||||
|
@ -1283,8 +1283,8 @@ ges_list_assets (GType filter)
|
|||
* ges_asset_get_error:
|
||||
* @self: The asset to retrieve the error from
|
||||
*
|
||||
* Returns: (transfer none): The #GError of the asset or %NULL if the asset was
|
||||
* loaded without issue
|
||||
* Returns: (transfer none) (nullable): The #GError of the asset or %NULL if
|
||||
* the asset was loaded without issue
|
||||
*
|
||||
* Since: 1.8
|
||||
*/
|
||||
|
|
|
@ -183,7 +183,7 @@ ges_audio_test_source_get_freq (GESAudioTestSource * self)
|
|||
/**
|
||||
* ges_audio_test_source_get_volume:
|
||||
* @self: a #GESAudioTestSource
|
||||
*
|
||||
*
|
||||
* Get the current volume of @self.
|
||||
*
|
||||
* Returns: The current volume of @self
|
||||
|
@ -203,7 +203,7 @@ ges_audio_test_source_get_volume (GESAudioTestSource * self)
|
|||
*
|
||||
* Creates a new #GESAudioTestSource.
|
||||
*
|
||||
* Returns: The newly created #GESAudioTestSource.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESAudioTestSource.
|
||||
*/
|
||||
GESAudioTestSource *
|
||||
ges_audio_test_source_new (void)
|
||||
|
|
|
@ -114,7 +114,7 @@ ges_audio_track_class_init (GESAudioTrackClass * klass)
|
|||
* Creates a new #GESAudioTrack of type #GES_TRACK_TYPE_AUDIO and with generic
|
||||
* raw audio caps ("audio/x-raw");
|
||||
*
|
||||
* Returns: A new #GESTrack
|
||||
* Returns: (transfer floating): A new #GESTrack
|
||||
*/
|
||||
GESAudioTrack *
|
||||
ges_audio_track_new (void)
|
||||
|
|
|
@ -287,7 +287,7 @@ ges_audio_transition_duration_changed (GESTrackElement * track_element,
|
|||
*
|
||||
* Creates a new #GESAudioTransition.
|
||||
*
|
||||
* Returns: The newly created #GESAudioTransition.
|
||||
* Returns: (transfer floating): The newly created #GESAudioTransition.
|
||||
*/
|
||||
GESAudioTransition *
|
||||
ges_audio_transition_new (void)
|
||||
|
|
|
@ -185,8 +185,8 @@ ges_audio_uri_source_init (GESAudioUriSource * self)
|
|||
*
|
||||
* Creates a new #GESAudioUriSource for the provided @uri.
|
||||
*
|
||||
* Returns: The newly created #GESAudioUriSource, or %NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created
|
||||
* #GESAudioUriSource, or %NULL if there was an error.
|
||||
*/
|
||||
GESAudioUriSource *
|
||||
ges_audio_uri_source_new (gchar * uri)
|
||||
|
|
|
@ -824,8 +824,8 @@ ges_clip_init (GESClip * self)
|
|||
* keep a reference to the newly created trackelement, you therefore need to
|
||||
* call @ges_container_remove when you are done with it.
|
||||
*
|
||||
* Returns: (transfer none): A #GESTrackElement. Returns NULL if the #GESTrackElement could not
|
||||
* be created.
|
||||
* Returns: (transfer none) (nullable): A #GESTrackElement. Returns NULL if
|
||||
* the #GESTrackElement could not be created.
|
||||
*/
|
||||
GESTrackElement *
|
||||
ges_clip_create_track_element (GESClip * clip, GESTrackType type)
|
||||
|
@ -1053,8 +1053,8 @@ ges_clip_move_to_layer (GESClip * clip, GESLayer * layer)
|
|||
* Note: If many objects match, then the one with the highest priority will be
|
||||
* returned.
|
||||
*
|
||||
* Returns: (transfer full): The #GESTrackElement used by @track, else %NULL,
|
||||
* Unref after usage
|
||||
* Returns: (transfer full) (nullable): The #GESTrackElement used by @track,
|
||||
* else %NULL. Unref after usage
|
||||
*/
|
||||
|
||||
GESTrackElement *
|
||||
|
@ -1090,7 +1090,7 @@ ges_clip_find_track_element (GESClip * clip, GESTrack * track, GType type)
|
|||
*
|
||||
* Get the #GESLayer to which this clip belongs.
|
||||
*
|
||||
* Returns: (transfer full): The #GESLayer where this @clip is being
|
||||
* Returns: (transfer full) (nullable): The #GESLayer where this @clip is being
|
||||
* used, or %NULL if it is not used on any layer. The caller should unref it
|
||||
* usage.
|
||||
*/
|
||||
|
@ -1265,8 +1265,8 @@ ges_clip_set_top_effect_index (GESClip * clip, GESBaseEffect * effect,
|
|||
* property must be registered using @ges_effect_class_register_rate_property;
|
||||
* for the 'pitch' plugin, this is already done.
|
||||
*
|
||||
* Returns: (transfer none): The newly created #GESClip resulting from the
|
||||
* splitting
|
||||
* Returns: (transfer none) (nullable): The newly created #GESClip resulting
|
||||
* from the splitting or %NULL if the clip can't be split.
|
||||
*/
|
||||
GESClip *
|
||||
ges_clip_split (GESClip * clip, guint64 position)
|
||||
|
|
|
@ -176,7 +176,7 @@ _create_track_element (GESClip * self, GESTrackType type)
|
|||
*
|
||||
* Creates a new #GESEffectClip from the description of the bin.
|
||||
*
|
||||
* Returns: a newly created #GESEffectClip, or
|
||||
* Returns: (transfer floating) (nullable): a newly created #GESEffectClip, or
|
||||
* %NULL if something went wrong.
|
||||
*/
|
||||
GESEffectClip *
|
||||
|
|
|
@ -257,7 +257,7 @@ ges_effect_create_element (GESTrackElement * object)
|
|||
* #ges_asset_request (GES_TYPE_EFFECT, "audio your ! bin ! description", NULL);
|
||||
* and extract that asset to be in full control.
|
||||
*
|
||||
* Returns: a newly created #GESEffect, or %NULL if something went
|
||||
* Returns: (nullable): a newly created #GESEffect, or %NULL if something went
|
||||
* wrong.
|
||||
*/
|
||||
GESEffect *
|
||||
|
|
|
@ -83,7 +83,8 @@ ges_extractable_default_init (GESExtractableInterface * iface)
|
|||
*
|
||||
* Method for getting an asset from a #GESExtractable
|
||||
*
|
||||
* Returns: (transfer none): The #GESAsset or %NULL if none has been set
|
||||
* Returns: (transfer none) (nullable): The #GESAsset or %NULL if none has
|
||||
* been set
|
||||
*/
|
||||
GESAsset *
|
||||
ges_extractable_get_asset (GESExtractable * self)
|
||||
|
@ -212,8 +213,8 @@ ges_extractable_type_get_asset_type (GType type)
|
|||
*
|
||||
* Check if @id is valid for @type
|
||||
*
|
||||
* Returns: (transfer full): A newly allocated string containing the actuall
|
||||
* ID (after some processing) or %NULL if the ID is wrong.
|
||||
* Returns: (transfer full) (nullable): A newly allocated string containing
|
||||
* the actual ID (after some processing) or %NULL if the ID is wrong.
|
||||
*/
|
||||
gchar *
|
||||
ges_extractable_type_check_id (GType type, const gchar * id, GError ** error)
|
||||
|
|
|
@ -791,7 +791,7 @@ ges_group_init (GESGroup * self)
|
|||
* together, it is recommanded to use the #ges_container_group method so the
|
||||
* proper subclass is selected.
|
||||
*
|
||||
* Returns: The new empty group.
|
||||
* Returns: (transfer floating): The new empty group.
|
||||
*/
|
||||
GESGroup *
|
||||
ges_group_new (void)
|
||||
|
|
|
@ -181,7 +181,7 @@ ges_image_source_init (GESImageSource * self)
|
|||
*
|
||||
* Creates a new #GESImageSource for the provided @uri.
|
||||
*
|
||||
* Returns: A new #GESImageSource.
|
||||
* Returns: (transfer floating): A new #GESImageSource.
|
||||
*/
|
||||
GESImageSource *
|
||||
ges_image_source_new (gchar * uri)
|
||||
|
|
|
@ -502,7 +502,7 @@ ges_layer_is_empty (GESLayer * layer)
|
|||
* are constructed, you should connect to the container::child-added signal which
|
||||
* is emited right after those elements are ready to be used.
|
||||
*
|
||||
* Returns: TRUE if the clip was properly added to the layer, or FALSE
|
||||
* Returns: %TRUE if the clip was properly added to the layer, or %FALSE
|
||||
* if the @layer refuses to add the clip.
|
||||
*/
|
||||
gboolean
|
||||
|
@ -662,7 +662,7 @@ ges_layer_add_asset (GESLayer * layer,
|
|||
*
|
||||
* Creates a new #GESLayer.
|
||||
*
|
||||
* Returns: A new #GESLayer
|
||||
* Returns: (transfer floating): A new #GESLayer
|
||||
*/
|
||||
GESLayer *
|
||||
ges_layer_new (void)
|
||||
|
@ -676,7 +676,7 @@ ges_layer_new (void)
|
|||
*
|
||||
* Get the #GESTimeline in which #GESLayer currently is.
|
||||
*
|
||||
* Returns: (transfer none): the #GESTimeline in which #GESLayer
|
||||
* Returns: (transfer none) (nullable): the #GESTimeline in which #GESLayer
|
||||
* currently is or %NULL if not in any timeline yet.
|
||||
*/
|
||||
GESTimeline *
|
||||
|
|
|
@ -426,8 +426,8 @@ ges_meta_container_set_meta (GESMetaContainer * container,
|
|||
*
|
||||
* Serializes a meta container to a string.
|
||||
*
|
||||
* Returns: a newly-allocated string, or NULL in case of an error. The
|
||||
* string must be freed with g_free() when no longer needed.
|
||||
* Returns: (nullable): a newly-allocated string, or NULL in case of an error.
|
||||
* The string must be freed with g_free() when no longer needed.
|
||||
*/
|
||||
gchar *
|
||||
ges_meta_container_metas_to_string (GESMetaContainer * container)
|
||||
|
|
|
@ -261,7 +261,7 @@ ges_multi_file_source_init (GESMultiFileSource * self)
|
|||
*
|
||||
* Creates a new #GESMultiFileSource for the provided @uri.
|
||||
*
|
||||
* Returns: A new #GESMultiFileSource.
|
||||
* Returns: (transfer floating): A new #GESMultiFileSource.
|
||||
*/
|
||||
GESMultiFileSource *
|
||||
ges_multi_file_source_new (gchar * uri)
|
||||
|
|
|
@ -401,7 +401,7 @@ no_encodebin:
|
|||
*
|
||||
* Creates a new conveninence #GESPipeline.
|
||||
*
|
||||
* Returns: the new #GESPipeline.
|
||||
* Returns: (transfer floating): the new #GESPipeline.
|
||||
*/
|
||||
GESPipeline *
|
||||
ges_pipeline_new (void)
|
||||
|
@ -921,7 +921,7 @@ _unlink_track (GESPipeline * self, GESTrack * track)
|
|||
/**
|
||||
* ges_pipeline_set_timeline:
|
||||
* @pipeline: a #GESPipeline
|
||||
* @timeline: the #GESTimeline to set on the @pipeline.
|
||||
* @timeline: (transfer full): the #GESTimeline to set on the @pipeline.
|
||||
*
|
||||
* Sets the timeline to use in this pipeline.
|
||||
*
|
||||
|
@ -1196,7 +1196,7 @@ ges_pipeline_set_mode (GESPipeline * pipeline, GESPipelineFlags mode)
|
|||
* is currently used by the sink. This information can be retrieve from caps
|
||||
* associated with the buffer.
|
||||
*
|
||||
* Returns: (transfer full): a #GstSample or %NULL
|
||||
* Returns: (transfer full) (nullable): a #GstSample or %NULL
|
||||
*/
|
||||
|
||||
GstSample *
|
||||
|
@ -1284,11 +1284,11 @@ ges_pipeline_save_thumbnail (GESPipeline * self, int width, int
|
|||
* 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.
|
||||
*
|
||||
* Returns: (transfer full): a #GstSample or %NULL
|
||||
* Returns: (transfer full) (nullable): a #GstSample or %NULL
|
||||
*/
|
||||
|
||||
GstSample *
|
||||
|
|
|
@ -732,7 +732,7 @@ ges_project_create_asset (GESProject * project, const gchar * id,
|
|||
* "asset-added" signal to get the asset when it finally gets added to
|
||||
* @project
|
||||
*
|
||||
* Returns: (transfer full): The newly created #GESAsset
|
||||
* Returns: (transfer full) (nullable): The newly created #GESAsset or %NULL.
|
||||
*/
|
||||
GESAsset *
|
||||
ges_project_create_asset_sync (GESProject * project, const gchar * id,
|
||||
|
|
|
@ -358,8 +358,8 @@ ges_test_clip_create_track_element (GESClip * clip, GESTrackType type)
|
|||
*
|
||||
* Creates a new #GESTestClip.
|
||||
*
|
||||
* Returns: The newly created #GESTestClip, or NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESTestClip,
|
||||
* or %NULL if there was an error.
|
||||
*/
|
||||
GESTestClip *
|
||||
ges_test_clip_new (void)
|
||||
|
@ -379,8 +379,8 @@ ges_test_clip_new (void)
|
|||
*
|
||||
* Creates a new #GESTestClip for the provided @nick.
|
||||
*
|
||||
* Returns: The newly created #GESTestClip, or NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESTestClip,
|
||||
* or %NULL if there was an error.
|
||||
*/
|
||||
GESTestClip *
|
||||
ges_test_clip_new_for_nick (gchar * nick)
|
||||
|
|
|
@ -38,7 +38,6 @@ G_DEFINE_TYPE (GESTextOverlayClip, ges_text_overlay_clip,
|
|||
#define DEFAULT_PROP_FONT_DESC "Serif 36"
|
||||
#define DEFAULT_PROP_VALIGNMENT GES_TEXT_VALIGN_BASELINE
|
||||
#define DEFAULT_PROP_HALIGNMENT GES_TEXT_HALIGN_CENTER
|
||||
#
|
||||
|
||||
struct _GESTextOverlayClipPrivate
|
||||
{
|
||||
|
@ -583,8 +582,8 @@ ges_text_overlay_clip_create_track_element (GESClip * clip, GESTrackType type)
|
|||
*
|
||||
* Creates a new #GESTextOverlayClip
|
||||
*
|
||||
* Returns: The newly created #GESTextOverlayClip, or NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created
|
||||
* #GESTextOverlayClip, or %NULL if there was an error.
|
||||
*/
|
||||
GESTextOverlayClip *
|
||||
ges_text_overlay_clip_new (void)
|
||||
|
|
|
@ -425,8 +425,8 @@ ges_text_overlay_get_ypos (GESTextOverlay * self)
|
|||
*
|
||||
* Creates a new #GESTextOverlay.
|
||||
*
|
||||
* Returns: The newly created #GESTextOverlay or %NULL if something went
|
||||
* wrong.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESTextOverlay or
|
||||
* %NULL if something went wrong.
|
||||
*/
|
||||
GESTextOverlay *
|
||||
ges_text_overlay_new (void)
|
||||
|
|
|
@ -553,8 +553,8 @@ had_parent:
|
|||
* Returns the parent of @self. This function increases the refcount
|
||||
* of the parent object so you should gst_object_unref() it after usage.
|
||||
*
|
||||
* Returns: (transfer full): parent of @self, this can be %NULL if @self
|
||||
* has no parent. unref after usage.
|
||||
* Returns: (transfer full) (nullable): parent of @self, this can be %NULL if
|
||||
* @self has no parent. unref after usage.
|
||||
*/
|
||||
GESTimelineElement *
|
||||
ges_timeline_element_get_parent (GESTimelineElement * self)
|
||||
|
@ -629,8 +629,8 @@ had_timeline:
|
|||
* Returns the timeline of @self. This function increases the refcount
|
||||
* of the timeline so you should gst_object_unref() it after usage.
|
||||
*
|
||||
* Returns: (transfer full): timeline of @self, this can be %NULL if @self
|
||||
* has no timeline. unref after usage.
|
||||
* Returns: (transfer full) (nullable): timeline of @self, this can be %NULL if
|
||||
* @self has no timeline. unref after usage.
|
||||
*/
|
||||
GESTimeline *
|
||||
ges_timeline_element_get_timeline (GESTimelineElement * self)
|
||||
|
|
|
@ -2786,7 +2786,7 @@ timeline_fill_gaps (GESTimeline * timeline)
|
|||
*
|
||||
* Creates a new empty #GESTimeline.
|
||||
*
|
||||
* Returns: The new timeline.
|
||||
* Returns: (transfer floating): The new timeline.
|
||||
*/
|
||||
|
||||
GESTimeline *
|
||||
|
@ -2808,8 +2808,8 @@ ges_timeline_new (void)
|
|||
*
|
||||
* Creates a timeline from the given URI.
|
||||
*
|
||||
* Returns: A new timeline if the uri was loaded successfully, or NULL if the
|
||||
* uri could not be loaded
|
||||
* Returns (transfer floating) (nullable): A new timeline if the uri was loaded
|
||||
* successfully, or NULL if the uri could not be loaded.
|
||||
*/
|
||||
GESTimeline *
|
||||
ges_timeline_new_from_uri (const gchar * uri, GError ** error)
|
||||
|
@ -2831,7 +2831,7 @@ ges_timeline_new_from_uri (const gchar * uri, GError ** error)
|
|||
*
|
||||
* Loads the contents of URI into the given timeline.
|
||||
*
|
||||
* Returns: TRUE if the timeline was loaded successfully, or FALSE if the uri
|
||||
* Returns: %TRUE if the timeline was loaded successfully, or %FALSE if the uri
|
||||
* could not be loaded.
|
||||
*/
|
||||
gboolean
|
||||
|
@ -2864,8 +2864,8 @@ ges_timeline_load_from_uri (GESTimeline * timeline, const gchar * uri,
|
|||
*
|
||||
* Saves the timeline to the given location
|
||||
*
|
||||
* Returns: TRUE if the timeline was successfully saved to the given location,
|
||||
* else FALSE.
|
||||
* Returns: %TRUE if the timeline was successfully saved to the given location,
|
||||
* else %FALSE.
|
||||
*/
|
||||
gboolean
|
||||
ges_timeline_save_to_uri (GESTimeline * timeline, const gchar * uri,
|
||||
|
@ -2921,12 +2921,12 @@ ges_timeline_append_layer (GESTimeline * timeline)
|
|||
/**
|
||||
* ges_timeline_add_layer:
|
||||
* @timeline: a #GESTimeline
|
||||
* @layer: the #GESLayer to add
|
||||
* @layer: (transfer full): the #GESLayer to add
|
||||
*
|
||||
* Add the layer to the timeline. The reference to the @layer will be stolen
|
||||
* by the @timeline.
|
||||
*
|
||||
* Returns: TRUE if the layer was properly added, else FALSE.
|
||||
* Returns: %TRUE if the layer was properly added, else %FALSE.
|
||||
*/
|
||||
gboolean
|
||||
ges_timeline_add_layer (GESTimeline * timeline, GESLayer * layer)
|
||||
|
@ -3001,7 +3001,7 @@ ges_timeline_add_layer (GESTimeline * timeline, GESLayer * layer)
|
|||
* the layer will be dropped. If you wish to use the @layer after calling this
|
||||
* method, you need to take a reference before calling.
|
||||
*
|
||||
* Returns: TRUE if the layer was properly removed, else FALSE.
|
||||
* Returns: %TRUE if the layer was properly removed, else %FALSE.
|
||||
*/
|
||||
|
||||
gboolean
|
||||
|
@ -3051,12 +3051,12 @@ ges_timeline_remove_layer (GESTimeline * timeline, GESLayer * layer)
|
|||
/**
|
||||
* ges_timeline_add_track:
|
||||
* @timeline: a #GESTimeline
|
||||
* @track: the #GESTrack to add
|
||||
* @track: (transfer full): the #GESTrack to add
|
||||
*
|
||||
* Add a track to the timeline. The reference to the track will be stolen by the
|
||||
* pipeline.
|
||||
*
|
||||
* Returns: TRUE if the track was properly added, else FALSE.
|
||||
* Returns: %TRUE if the track was properly added, else %FALSE.
|
||||
*/
|
||||
|
||||
/* FIXME: create track elements for clips which have already been
|
||||
|
@ -3143,7 +3143,7 @@ ges_timeline_add_track (GESTimeline * timeline, GESTrack * track)
|
|||
* @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.
|
||||
*
|
||||
* Returns: TRUE if the @track was properly removed, else FALSE.
|
||||
* Returns: %TRUE if the @track was properly removed, else %FALSE.
|
||||
*/
|
||||
|
||||
/* FIXME: release any track elements associated with this layer. currenly this
|
||||
|
@ -3222,8 +3222,8 @@ ges_timeline_remove_track (GESTimeline * timeline, GESTrack * track)
|
|||
*
|
||||
* Search the #GESTrack corresponding to the given @timeline's @pad.
|
||||
*
|
||||
* Returns: (transfer none): The corresponding #GESTrack if it is found,
|
||||
* or %NULL if there is an error.
|
||||
* Returns: (transfer none) (nullable): The corresponding #GESTrack if it is
|
||||
* found, or %NULL if there is an error.
|
||||
*/
|
||||
|
||||
GESTrack *
|
||||
|
@ -3251,8 +3251,8 @@ ges_timeline_get_track_for_pad (GESTimeline * timeline, GstPad * pad)
|
|||
*
|
||||
* Search the #GstPad corresponding to the given @timeline's @track.
|
||||
*
|
||||
* Returns: (transfer none): The corresponding #GstPad if it is found,
|
||||
* or %NULL if there is an error.
|
||||
* Returns: (transfer none) (nullable): The corresponding #GstPad if it is
|
||||
* found, or %NULL if there is an error.
|
||||
*/
|
||||
|
||||
GstPad *
|
||||
|
@ -3573,7 +3573,7 @@ ges_timeline_set_snapping_distance (GESTimeline * timeline,
|
|||
*
|
||||
* Gets a #GESTimelineElement contained in the timeline
|
||||
*
|
||||
* Returns: (transfer full): The #GESTimelineElement or %NULL if
|
||||
* Returns: (transfer full) (nullable): The #GESTimelineElement or %NULL if
|
||||
* not found.
|
||||
*/
|
||||
GESTimelineElement *
|
||||
|
@ -3641,7 +3641,8 @@ ges_timeline_is_empty (GESTimeline * timeline)
|
|||
*
|
||||
* Retrieve the layer with @priority as a priority
|
||||
*
|
||||
* Returns: (transfer full): A #GESLayer or %NULL if no layer with @priority was found
|
||||
* Returns: (transfer full) (nullable): A #GESLayer or %NULL if no layer with
|
||||
* @priority was found
|
||||
*
|
||||
* Since 1.6
|
||||
*/
|
||||
|
|
|
@ -688,8 +688,8 @@ ges_title_clip_create_track_element (GESClip * clip, GESTrackType type)
|
|||
*
|
||||
* Creates a new #GESTitleClip
|
||||
*
|
||||
* Returns: The newly created #GESTitleClip, or NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESTitleClip,
|
||||
* or %NULL if there was an error.
|
||||
*/
|
||||
GESTitleClip *
|
||||
ges_title_clip_new (void)
|
||||
|
|
|
@ -601,8 +601,8 @@ ges_title_source_get_ypos (GESTitleSource * source)
|
|||
*
|
||||
* Creates a new #GESTitleSource.
|
||||
*
|
||||
* Returns: The newly created #GESTitleSource, or %NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESTitleSource,
|
||||
* or %NULL if there was an error.
|
||||
*/
|
||||
GESTitleSource *
|
||||
ges_title_source_new (void)
|
||||
|
|
|
@ -853,8 +853,8 @@ _ges_track_element_get_layer_priority (GESTrackElement * element)
|
|||
*
|
||||
* Get the #GESTrack to which this object belongs.
|
||||
*
|
||||
* Returns: (transfer none): The #GESTrack to which this object belongs. Can be %NULL if it
|
||||
* is not in any track
|
||||
* Returns: (transfer none) (nullable): The #GESTrack to which this object
|
||||
* belongs. Can be %NULL if it is not in any track
|
||||
*/
|
||||
GESTrack *
|
||||
ges_track_element_get_track (GESTrackElement * object)
|
||||
|
@ -1525,8 +1525,8 @@ ges_track_element_set_control_source (GESTrackElement * object,
|
|||
* Looks up the various controlled properties for that #GESTrackElement,
|
||||
* and returns the #GstControlBinding which controls @property_name.
|
||||
*
|
||||
* Returns: (transfer none): the #GstControlBinding associated with @property_name, or %NULL
|
||||
* if that property is not controlled.
|
||||
* Returns: (transfer none) (nullable): the #GstControlBinding associated with
|
||||
* @property_name, or %NULL if that property is not controlled.
|
||||
*/
|
||||
GstControlBinding *
|
||||
ges_track_element_get_control_binding (GESTrackElement * object,
|
||||
|
|
|
@ -711,7 +711,7 @@ ges_track_init (GESTrack * self)
|
|||
* 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.
|
||||
*
|
||||
* Returns: A new #GESTrack.
|
||||
* Returns: (transfer floating): A new #GESTrack.
|
||||
*/
|
||||
GESTrack *
|
||||
ges_track_new (GESTrackType type, GstCaps * caps)
|
||||
|
@ -1059,7 +1059,7 @@ ges_track_get_caps (GESTrack * track)
|
|||
*
|
||||
* Get the #GESTimeline this track belongs to. Can be %NULL.
|
||||
*
|
||||
* Returns: The #GESTimeline this track belongs to. Can be %NULL.
|
||||
* Returns: (nullable): The #GESTimeline this track belongs to. Can be %NULL.
|
||||
*/
|
||||
const GESTimeline *
|
||||
ges_track_get_timeline (GESTrack * track)
|
||||
|
|
|
@ -337,8 +337,8 @@ _create_track_element (GESClip * clip, GESTrackType type)
|
|||
*
|
||||
* Creates a new #GESTransitionClip.
|
||||
*
|
||||
* Returns: a newly created #GESTransitionClip, or %NULL if something
|
||||
* went wrong.
|
||||
* Returns: (transfer floating) (nullable): a newly created #GESTransitionClip,
|
||||
* or %NULL if something went wrong.
|
||||
*/
|
||||
GESTransitionClip *
|
||||
ges_transition_clip_new (GESVideoStandardTransitionType vtype)
|
||||
|
@ -372,8 +372,8 @@ ges_transition_clip_new (GESVideoStandardTransitionType vtype)
|
|||
*
|
||||
* Creates a new #GESTransitionClip for the provided @nick.
|
||||
*
|
||||
* Returns: The newly created #GESTransitionClip, or %NULL if something
|
||||
* went wrong
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESTransitionClip,
|
||||
* or %NULL if something went wrong
|
||||
*/
|
||||
|
||||
GESTransitionClip *
|
||||
|
|
|
@ -476,7 +476,8 @@ ges_uri_clip_asset_new (const gchar * uri, GCancellable * cancellable,
|
|||
* Creates a #GESUriClipAsset for @uri syncronously. You should avoid
|
||||
* to use it in application, and rather create #GESUriClipAsset asynchronously
|
||||
*
|
||||
* Returns: (transfer none): A reference to the requested asset or %NULL if an error happend
|
||||
* Returns: (transfer none) (nullable): A reference to the requested asset or
|
||||
* %NULL if an error happened
|
||||
*/
|
||||
GESUriClipAsset *
|
||||
ges_uri_clip_asset_request_sync (const gchar * uri, GError ** error)
|
||||
|
|
|
@ -517,8 +517,8 @@ ges_uri_clip_create_track_element (GESClip * clip, GESTrackType type)
|
|||
*
|
||||
* Creates a new #GESUriClip for the provided @uri.
|
||||
*
|
||||
* Returns: The newly created #GESUriClip, or NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESUriClip, or
|
||||
* %NULL if there was an error.
|
||||
*/
|
||||
GESUriClip *
|
||||
ges_uri_clip_new (gchar * uri)
|
||||
|
|
|
@ -35,11 +35,11 @@ static GstElementFactory *compositor_factory = NULL;
|
|||
|
||||
/**
|
||||
* ges_timeline_new_audio_video:
|
||||
*
|
||||
*
|
||||
* Creates a new #GESTimeline containing a raw audio and a
|
||||
* raw video track.
|
||||
*
|
||||
* Returns: The newly created #GESTimeline.
|
||||
* Returns: (transfer floating): The newly created #GESTimeline.
|
||||
*/
|
||||
|
||||
GESTimeline *
|
||||
|
|
|
@ -130,8 +130,8 @@ ges_video_test_source_get_pattern (GESVideoTestSource * source)
|
|||
*
|
||||
* Creates a new #GESVideoTestSource.
|
||||
*
|
||||
* Returns: The newly created #GESVideoTestSource, or %NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created
|
||||
* #GESVideoTestSource, or %NULL if there was an error.
|
||||
*/
|
||||
GESVideoTestSource *
|
||||
ges_video_test_source_new (void)
|
||||
|
|
|
@ -133,7 +133,7 @@ ges_video_track_class_init (GESVideoTrackClass * klass)
|
|||
* Creates a new #GESVideoTrack of type #GES_TRACK_TYPE_VIDEO and with generic
|
||||
* raw video caps ("video/x-raw");
|
||||
*
|
||||
* Returns: A new #GESTrack.
|
||||
* Returns: (transfer floating): A new #GESTrack.
|
||||
*/
|
||||
GESVideoTrack *
|
||||
ges_video_track_new (void)
|
||||
|
|
|
@ -649,8 +649,8 @@ ges_video_transition_get_transition_type (GESVideoTransition * trans)
|
|||
*
|
||||
* Creates a new #GESVideoTransition.
|
||||
*
|
||||
* Returns: The newly created #GESVideoTransition, or %NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created
|
||||
* #GESVideoTransition, or %NULL if there was an error.
|
||||
*/
|
||||
GESVideoTransition *
|
||||
ges_video_transition_new (void)
|
||||
|
|
|
@ -186,8 +186,8 @@ ges_video_uri_source_init (GESVideoUriSource * self)
|
|||
*
|
||||
* Creates a new #GESVideoUriSource for the provided @uri.
|
||||
*
|
||||
* Returns: The newly created #GESVideoUriSource, or %NULL if there was an
|
||||
* error.
|
||||
* Returns: (transfer floating) (nullable): The newly created #GESVideoUriSource,
|
||||
* or %NULL if there was an error.
|
||||
*/
|
||||
GESVideoUriSource *
|
||||
ges_video_uri_source_new (gchar * uri)
|
||||
|
|
Loading…
Reference in a new issue