diff --git a/gir-files/GES-1.0.gir b/gir-files/GES-1.0.gir index 1a22dcd96..a75ba4906 100644 --- a/gir-files/GES-1.0.gir +++ b/gir-files/GES-1.0.gir @@ -213,7 +213,7 @@ call g_main_context_push_thread_default() in a new thread before calling ges_init(). Example of an asynchronous asset request: -|[ +``` c // The request callback static void asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data) @@ -223,20 +223,20 @@ asset_loaded_cb (GESAsset * source, GAsyncResult * res, gpointer user_data) asset = ges_asset_request_finish (res, &error); 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)); } 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); } - gst_object_unref (mfs); + gst_object_unref (asset); } // The request: ges_asset_request_async (GES_TYPE_URI_CLIP, some_uri, NULL, (GAsyncReadyCallback) asset_loaded_cb, user_data); -]| +``` @@ -1593,7 +1593,7 @@ elements of the clip. - + Adds the track element child of the clip to a specific track. If the given child is already in another track, this will create a copy @@ -1858,7 +1858,7 @@ be performed. - + Convert the internal source time from the child to a timeline time. This will take any time effects placed on the clip into account (see #GESBaseEffect for what time effects are supported, and how to @@ -2219,7 +2219,7 @@ the start and end of the clip - + The maximum #GESTimelineElement:duration that can be *currently* set for the clip, taking into account the #GESTimelineElement:in-point, #GESTimelineElement:max-duration, #GESTrackElement:active, and @@ -2271,10 +2271,11 @@ from it can potentialy create #GESTrackElement for. - + Result: %TRUE if @self has a natural framerate %FALSE otherwise + %TRUE if @self has a natural framerate @FALSE otherwise. @@ -2292,7 +2293,7 @@ from it can potentialy create #GESTrackElement for. - + Converts the given frame number into a timestamp, using the "natural" frame rate of the asset. @@ -2316,7 +2317,7 @@ natural frame rate. - + Result: %TRUE if @self has a natural framerate %FALSE otherwise @@ -2394,6 +2395,7 @@ a layer + %TRUE if @self has a natural framerate @FALSE otherwise. @@ -3127,13 +3129,15 @@ if no track elements are created or an error occurred. Represent the fact we are not working with any edge of an object. - + + A human friendly name for @edge + The #GESEdge to get the name of @@ -3319,9 +3323,14 @@ and [clip management](http://pitivi.org/manual/usingclips.html). - Currently we only support effects with 1 sinkpad and 1 sourcepad -with the exception of `gesaudiomixer` and `gescompositor` which -can be used as effects. + Currently we only support effects with N sinkpads and one single srcpad. +Apart from `gesaudiomixer` and `gescompositor` which can be used as effects +and where sinkpads will be requested as needed based on the timeline topology +GES will always request at most one sinkpad per effect (when required). + +> Note: GES always adds converters (`audioconvert ! audioresample ! +> audioconvert` for audio effects and `videoconvert` for video effects) to +> make it simpler for end users. @@ -3568,6 +3577,8 @@ desired operation. (Since: 1.18) The operation would break one of the overlap conditions for the #GESTimeline. (Since: 1.18) + + A #GObject that implements the #GESExtractable interface can be @@ -4575,7 +4586,7 @@ if @layer refused to add @clip. - + Gets whether the layer is active for the given track. See ges_layer_set_active_for_tracks(). @@ -4732,7 +4743,7 @@ operation failed. - + Activate or deactivate track elements in @tracks (or in all tracks if @tracks is %NULL). @@ -4868,7 +4879,7 @@ will make sure there is never 'gaps' between layer priorities. - + Will be emitted whenever the layer is activated or deactivated for some #GESTrack. See ges_layer_set_active_for_tracks(). @@ -5031,10 +5042,11 @@ assets (string). - + + A timed #GESMetaContainer object. - + Current position (in nanoseconds) of the #GESMarker @@ -5957,7 +5969,7 @@ and the field was successfully set to @value. - + Registers a static metadata field on the container to only hold the specified type. After calling this, setting a value under this field can only succeed if its type matches the registered type of the field. @@ -6705,9 +6717,14 @@ native size Sets the #GESPipeline:mode of the pipeline. -Note that the pipeline will be set to #GST_STATE_NULL during this call -to perform the necessary changes. You will need to set the state again -yourself after calling this. +Note that the pipeline will be set to #GST_STATE_NULL during this call to +perform the necessary changes. You will need to set the state again yourself +after calling this. + +> **NOTE**: [Rendering settings](ges_pipeline_set_render_settings) need to be +> set before setting @mode to #GES_PIPELINE_MODE_RENDER or +> #GES_PIPELINE_MODE_SMART_RENDER, the call to this method will fail +> otherwise. %TRUE if the mode of @pipeline was successfully set to @mode. @@ -7019,16 +7036,18 @@ the URI it will keep refering to. - + - + + The self + The loading timeline @@ -7601,13 +7620,15 @@ only to find out what the new location is. - + + The self + The loading timeline @@ -7683,7 +7704,8 @@ or %NULL if there was an error. - + + An asset types from which #GESSourceClip will be extracted @@ -9026,7 +9048,7 @@ with the given @name, or %NULL if it was not found. - + This method allows you to convert a timeline #GstClockTime into its corresponding #GESFrameNumber in the timeline's output. @@ -9045,7 +9067,7 @@ corresponding #GESFrameNumber in the timeline's output. - + This method allows you to convert a timeline output frame number into a timeline #GstClockTime. For example, this time could be used to seek to a particular frame in the timeline's output, or as the edit position for @@ -10109,7 +10131,10 @@ See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and - + + Method for setting the child property given by +@pspec on @child to @value. Default implementation will use +g_object_set_property(). @@ -10129,7 +10154,10 @@ See ges_timeline_element_edit() with #GES_EDIT_MODE_ROLL and - + + Similar to @set_child_property, except setting can fail, with the @error +being optionally set. Default implementation will call @set_child_property +and return %TRUE. @@ -11450,7 +11478,7 @@ to any source content. - + Emitted when the element has a new child property registered. See ges_timeline_element_add_child_property(). @@ -11471,7 +11499,7 @@ ges_timeline_element_list_children_properties() to list these. - + Emitted when the element has a child property unregistered. See ges_timeline_element_remove_child_property(). @@ -11913,7 +11941,7 @@ not the case. - + @@ -12960,7 +12988,7 @@ width=400". The capabilities used to choose the output of the #GESTrack's elements. Internally, this is used to select output streams when several may be available, by determining whether its #GstPad is -compatible (see #nlecomposition:caps for #nlecomposition). As such, +compatible (see #NleObject:caps for #nlecomposition). As such, this is used as a weaker indication of the desired output type of the track, **before** the #GESTrack:restriction-caps is applied. Therefore, this should be set to a *generic* superset of the @@ -13406,7 +13434,7 @@ is much more convenient for C programming. Use #ges_timeline_element_get_child_property - %TRUE if the property was found, %FALSE otherwize. + %TRUE if the property was found, %FALSE otherwise. @@ -13572,7 +13600,7 @@ or %NULL if it does not belong to a track. - + Gets #GESTrackElement:has-internal-source for the element. @@ -13783,7 +13811,7 @@ is much more convenient for C programming. use #ges_timeline_element_set_child_property instead - %TRUE if the property was set, %FALSE otherwize. + %TRUE if the property was set, %FALSE otherwise. @@ -13885,14 +13913,16 @@ gst_direct_control_binding_new_absolute() instead. - + Sets #GESTrackElement:has-internal-source for the element. If this is set to %FALSE, this method will also set the #GESTimelineElement:in-point of the element to 0 and its #GESTimelineElement:max-duration to #GST_CLOCK_TIME_NONE. - + %FALSE if @has_internal_source is forbidden for @object and +%TRUE in any other case. + @@ -13929,7 +13959,7 @@ set to %FALSE, this method will also set the the output of the track. - + Whether the control sources on the element (see ges_track_element_set_control_source()) will be automatically updated whenever the #GESTimelineElement:in-point or out-point of the @@ -13941,7 +13971,7 @@ per control source. Default value: %TRUE - + This property is used to determine whether the 'internal time' properties of the element have any meaning. In particular, unless this is set to %TRUE, the #GESTimelineElement:in-point and @@ -14039,10 +14069,11 @@ property of the track element. - + Result: %TRUE if @self has a natural framerate %FALSE otherwise + %TRUE if @self has a natural framerate @FALSE otherwise. @@ -14060,7 +14091,7 @@ property of the track element. - + Result: %TRUE if @self has a natural framerate %FALSE otherwise @@ -14138,6 +14169,7 @@ should get into + %TRUE if @self has a natural framerate @FALSE otherwise. @@ -14458,7 +14490,12 @@ the URI points to a file of some 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**. The newly created #GESUriClip, or @@ -14726,7 +14763,7 @@ are different as those can be extended 'infinitely'. - + Gets Whether the file represented by @self is an image or not @@ -14881,7 +14918,7 @@ by #GESUriClipAsset-s. - + Check if @asset contains a single image @@ -14927,7 +14964,7 @@ contains one frame) - + Retrieves the natural size of the video stream. The natural size, is the size at which it will be displayed if no scaling is being applied. @@ -15707,13 +15744,15 @@ After this call GES should not be used until another ges_init() call. - + + A human friendly name for @edge + The #GESEdge to get the name of diff --git a/gir-files/Gst-1.0.gir b/gir-files/Gst-1.0.gir index 659a61cfa..9bf55a726 100644 --- a/gir-files/Gst-1.0.gir +++ b/gir-files/Gst-1.0.gir @@ -1656,7 +1656,7 @@ The @deep_element_added vfunc will be called when a new element has been added to any bin inside this bin, so it will also be called if a new child was added to a sub-bin of this bin. #GstBin implementations that override this message should chain up to the parent class implementation so the -element-added-deep signal is emitted on all parents. +#GstBin::deep-element-added signal is emitted on all parents. bin parent class @@ -2729,16 +2729,20 @@ gst_buffer_resize_range(). - + + Gives the status of a specific flag on a buffer. + %TRUE if all flags in @flags are found on @buffer. + a #GstBuffer + the #GstBufferFlags flag to check. @@ -12773,7 +12777,7 @@ metadata. Free with g_strfreev() when no longer needed. A fundamental type that describes a #gdouble range - + #GstDynamicTypeFactory is used to represent a type that can be automatically loaded the first time it is used. For example, a non-standard type for use in caps fields. @@ -19258,13 +19262,15 @@ owned by a ghost pad. - + Finish initialization of a newly allocated ghost pad. This function is most useful in language bindings and when subclassing #GstGhostPad; plugin and application developers normally will not call this function. Call this function directly after a call to g_object_new (GST_TYPE_GHOST_PAD, "direction", @dir, ..., NULL). + This function is deprecated since 1.18 and does nothing +anymore. %TRUE if the construction succeeds, %FALSE otherwise. @@ -30980,7 +30986,7 @@ pad functions cannot be called from within the callback. - + A fundamental type that describes a #GParamSpec for arrays of values @@ -31075,7 +31081,7 @@ Free-function: gst_parse_context_free - + Copies the @context. @@ -37147,6 +37153,15 @@ static GstStaticPadTemplate my_src_template = * GST_STATIC_PAD_TEMPLATE("src" + + printf format type used to debug GStreamer signed time value pointers. You +can use this in combination with GStreamer's debug logging system as well as +the functions gst_info_vasprintf(), gst_info_strdup_vprintf() and +gst_info_strdup_printf() to pretty-print signed time (pointers to +#GstClockTimeDiff or #gint64). + + + Format @t for the #GST_STIME_FORMAT format string. Note: @t will be evaluated more than once. @@ -39806,7 +39821,7 @@ release with either g_free() or the suitable function for the boxed type. - + This is useful in language bindings where unknown #GValue types are not supported. This function will convert the %GST_TYPE_ARRAY into a newly allocated #GValueArray and return it through @array. Be aware that this is @@ -41819,6 +41834,15 @@ The higher the value, the more the user likes this media + + printf format type used to debug GStreamer ClockTime pointers. You can use +this in combination with GStreamer's debug logging system as well as the +functions gst_info_vasprintf(), gst_info_strdup_vprintf() and +gst_info_strdup_printf() to pretty-print #GstClockTime pointers. This can +only be used on pointers to GstClockTime values. + + + Convert a struct timespec (see man pselect) to a #GstClockTime. @@ -45093,7 +45117,7 @@ Free-function: gst_plugin_feature_list_free - + Get the #GType for elements managed by this factory. The type can only be retrieved if the element factory is loaded, which can be assured with gst_plugin_feature_load(). @@ -45121,7 +45145,7 @@ the factory is not loaded. Tracing modules will create instances of this class to announce the data they will log and create a log formatter. - + Create a new tracer record. The record instance can be used to efficiently log entries using gst_tracer_record_log(). @@ -45160,7 +45184,7 @@ handle that right now. - + Serialzes the trace event into the log. Right now this is using the gstreamer debug log with the level TRACE (7) and @@ -46989,7 +47013,7 @@ determine a order for the two provided values. - + The micro version of GStreamer at compile time: @@ -46999,7 +47023,7 @@ determine a order for the two provided values. - + The nano version of GStreamer at compile time: Actual releases have 0, GIT versions have 1, prerelease versions have 2-... @@ -48446,7 +48470,7 @@ After this call GStreamer (including this method) should not be used anymore. - + Registers a new #GstDynamicTypeFactory in the registry @@ -49075,7 +49099,7 @@ or gst_init_check(). - + Create a #GstStructure to be used with #gst_element_message_full_with_details @@ -49728,7 +49752,7 @@ yourself). a newly-created element, which is guaranteed to be a bin unless - GST_FLAG_NO_SINGLE_ELEMENT_BINS was passed, or %NULL if an error + #GST_PARSE_FLAG_NO_SINGLE_ELEMENT_BINS was passed, or %NULL if an error occurred. @@ -50739,7 +50763,7 @@ the entirety of the run-time of the process or till gst_deinit() is called. - + Register @func to be called when the trace hook @detail is getting invoked. Use %NULL for @detail to register to all hooks. diff --git a/gir-files/GstAudio-1.0.gir b/gir-files/GstAudio-1.0.gir index 28ee2826e..9322f69b6 100644 --- a/gir-files/GstAudio-1.0.gir +++ b/gir-files/GstAudio-1.0.gir @@ -691,7 +691,7 @@ return to upstream/caller (indicating either GST_FLOW_ERROR or GST_FLOW_OK). - + List of all audio formats, for use in template caps strings. Formats are sorted by decreasing "quality", using these criteria by priority: @@ -3039,7 +3039,7 @@ be used. - + This object is used to convert audio samples from one format to another. The object can perform conversion of: @@ -3288,7 +3288,7 @@ are matching and @in and @out point to enough memory. - + Returns whether the audio converter can perform the conversion in-place. The return value would be typically input to gst_base_transform_set_in_place() @@ -4322,6 +4322,11 @@ handler with %GST_PAD_SET_ACCEPT_INTERSECT and + + Maximum number of tolerated consecutive decode errors. See +gst_audio_decoder_set_max_errors() for more details. + + @@ -6852,11 +6857,11 @@ the @dither and @ns parameters. samples are non-interleaved - + #GstAudioResampler is a structure which holds the information required to perform various kinds of resampling filtering. - + Free a previously allocated #GstAudioResampler @resampler. @@ -7083,7 +7088,7 @@ for @quality in @options. - + The different filter interpolation methods. no interpolation @@ -7097,7 +7102,7 @@ for @quality in @options. filter coefficients. - + Select for the filter tables should be set up. Use interpolated filter tables. This @@ -7113,7 +7118,7 @@ for @quality in @options. and full filter tables. - + Different resampler flags. no flags @@ -7134,7 +7139,7 @@ for @quality in @options. when #GST_AUDIO_RESAMPLER_FILTER_MODE_AUTO is configured. - + Different subsampling and upsampling methods Duplicates the samples when diff --git a/gir-files/GstBase-1.0.gir b/gir-files/GstBase-1.0.gir index abd1f7b4d..f7c1ab8a2 100644 --- a/gir-files/GstBase-1.0.gir +++ b/gir-files/GstBase-1.0.gir @@ -309,13 +309,21 @@ the value of the @size argument an empty #GBytes structure may be returned. - + + Get the distance in bytes since the last buffer with the +%GST_BUFFER_FLAG_DISCONT flag. + +The distance will be reset to 0 for all buffers with +%GST_BUFFER_FLAG_DISCONT on them, and then calculated for all other +following buffers based on their size. + The offset. Can be %GST_BUFFER_OFFSET_NONE. + a #GstAdapter @@ -2093,7 +2101,7 @@ usage. - + Start at running time 0. @@ -3506,7 +3514,7 @@ then use gst_base_parse_frame_init() to initialise it. - + Copies a #GstBaseParseFrame. diff --git a/gir-files/GstPbutils-1.0.gir b/gir-files/GstPbutils-1.0.gir index 46640c96c..4c4c8780b 100644 --- a/gir-files/GstPbutils-1.0.gir +++ b/gir-files/GstPbutils-1.0.gir @@ -2201,6 +2201,19 @@ count. + + + + The path to the @target file. + + + + + a #GstEncodingTarget + + + + @@ -2496,13 +2509,16 @@ gst_install_plugins_context_free() when no longer needed - + + Copies a #GstInstallPluginsContext. + A copy of @ctx + a #GstInstallPluginsContext @@ -2740,7 +2756,7 @@ in debugging. - + The micro version of GStreamer's gst-plugins-base libraries at compile time. @@ -2750,7 +2766,7 @@ in debugging. - + The nano version of GStreamer's gst-plugins-base libraries at compile time. Actual releases have 0, GIT versions have 1, prerelease versions have 2-... diff --git a/gir-files/GstRtp-1.0.gir b/gir-files/GstRtp-1.0.gir index 70480a005..9790c8631 100644 --- a/gir-files/GstRtp-1.0.gir +++ b/gir-files/GstRtp-1.0.gir @@ -382,7 +382,7 @@ The size of the structure is made public to allow stack allocations. - + Add profile-specific extension @data to @packet. If @packet already contains profile-specific extension @data will be appended to the existing extension. @@ -720,7 +720,7 @@ present. - + The profile-specific extension data is copied into a new allocated memory area @data. This must be freed with g_free() after usage. @@ -930,7 +930,7 @@ valid packet. - + %TRUE if there was valid data. @@ -953,7 +953,7 @@ valid packet. - + The number of 32-bit words containing profile-specific extension diff --git a/gir-files/GstRtsp-1.0.gir b/gir-files/GstRtsp-1.0.gir index 5a39e6a65..de1fa1901 100644 --- a/gir-files/GstRtsp-1.0.gir +++ b/gir-files/GstRtsp-1.0.gir @@ -17,7 +17,7 @@ and/or use gtk-doc annotations. --> - + RTSP Authentication credentials @@ -45,7 +45,7 @@ and/or use gtk-doc annotations. --> digest authentication - + RTSP Authentication parameter diff --git a/gir-files/GstVideo-1.0.gir b/gir-files/GstVideo-1.0.gir index 7adc7eb44..316aa63eb 100644 --- a/gir-files/GstVideo-1.0.gir +++ b/gir-files/GstVideo-1.0.gir @@ -6539,6 +6539,11 @@ handler with %GST_PAD_SET_ACCEPT_INTERSECT and + + Maximum number of tolerated consecutive decode errors. See +gst_video_decoder_set_max_errors() for more details. + + If set to %TRUE the decoder will handle QoS events received from downstream elements. @@ -9152,7 +9157,10 @@ separate step after unpacking. - Copy the plane with index @plane from @src to @dest. + Copy the plane with index @plane from @src to @dest. + +Note: Since: 1.18, @dest dimensions are allowed to be +smaller than @src dimensions. TRUE if the contents could be copied. @@ -11186,13 +11194,13 @@ main (int argc, char **argv) ## GstVideoOverlay and Qt |[ -#include &lt;glib.h&gt; -#include &lt;gst/gst.h&gt; -#include &lt;gst/video/videooverlay.h&gt; +#include <glib.h>; +#include <gst/gst.h>; +#include <gst/video/videooverlay.h>; -#include &lt;QApplication&gt; -#include &lt;QTimer&gt; -#include &lt;QWidget&gt; +#include <QApplication>; +#include <QTimer>; +#include <QWidget>; int main(int argc, char *argv[]) { @@ -12252,7 +12260,8 @@ gst_video_overlay_composition_copy(). - list of #GstStructure containing element-specific params for downstream, see gst_video_region_of_interest_meta_add_params(). (Since: 1.14) + list of #GstStructure containing element-specific params for downstream, + see gst_video_region_of_interest_meta_add_param(). (Since: 1.14) @@ -14179,6 +14188,7 @@ parameters. Gets the #GstVideoAFDMeta that might be present on @b. + Note: there may be two #GstVideoAFDMeta structs for interlaced video. @@ -14195,6 +14205,7 @@ Note: there may be two #GstVideoAFDMeta structs for interlaced video. + Gets the #GstVideoBarMeta that might be present on @b.