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 <glib.h>
-#include <gst/gst.h>
-#include <gst/video/videooverlay.h>
+#include <glib.h>;
+#include <gst/gst.h>;
+#include <gst/video/videooverlay.h>;
-#include <QApplication>
-#include <QTimer>
-#include <QWidget>
+#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.