From 7819907118fa71909c5d6f98d100e8711904d546 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Sebastian=20Dr=C3=B6ge?= Date: Thu, 15 Mar 2018 09:44:58 +0200 Subject: [PATCH] Update gir-files to GStreamer 1.13.91 --- gir-files/Gst-1.0.gir | 82 ++++++++++++++++++++++++--------- gir-files/GstBase-1.0.gir | 17 +++++++ gir-files/GstPbutils-1.0.gir | 4 +- gir-files/GstRtspServer-1.0.gir | 7 ++- gir-files/GstVideo-1.0.gir | 6 +-- 5 files changed, 89 insertions(+), 27 deletions(-) diff --git a/gir-files/Gst-1.0.gir b/gir-files/Gst-1.0.gir index a4e40a3ba..7a32293ca 100644 --- a/gir-files/Gst-1.0.gir +++ b/gir-files/Gst-1.0.gir @@ -30890,7 +30890,7 @@ application. the directory or %NULL, don't free or modify the string - + @@ -30904,7 +30904,7 @@ system presets. the application specific preset dir - + @@ -31488,11 +31488,20 @@ application of the status of asynchronous tasks. The #GstPromise object implements the container for values that may be available later. i.e. a Future or a Promise in <ulink url="https://en.wikipedia.org/wiki/Futures_and_promises">https://en.wikipedia.org/wiki/Futures_and_promises</ulink> +As with all Future/Promise-like functionality, there is the concept of the +producer of the value and the consumer of the value. -A #GstPromise can be created with gst_promise_new(), replied to -with gst_promise_reply(), interrupted with gst_promise_interrupt() and -expired with gst_promise_expire(). A callback can also be installed at -#GstPromise creation for result changes with gst_promise_new_with_change_func(). +A #GstPromise is created with gst_promise_new() by the consumer and passed +to the producer to avoid thread safety issues with the change callback. +A #GstPromise can be replied to with a value (or an error) by the producer +with gst_promise_reply(). gst_promise_interrupt() is for the consumer to +indicate to the producer that the value is not needed anymore and producing +that value can stop. The @GST_PROMISE_RESULT_EXPIRED state set by a call +to gst_promise_expire() indicates to the consumer that a value will never +be produced and is intended to be called by a third party that implements +some notion of message handling such as #GstBus. +A callback can also be installed at #GstPromise creation for +result changes with gst_promise_new_with_change_func(). The change callback can be used to chain #GstPromises's together as in the following example. |[<!-- language="C" --> @@ -31508,18 +31517,25 @@ pass p to promise-using API ]| Each #GstPromise starts out with a #GstPromiseResult of -%GST_PROMISE_RESULT_PENDING and only ever transitions out of that result -into one of the other #GstPromiseResult. +%GST_PROMISE_RESULT_PENDING and only ever transitions once +into one of the other #GstPromiseResult's. In order to support multi-threaded code, gst_promise_reply(), gst_promise_interrupt() and gst_promise_expire() may all be from -different threads with some restrictions, the final result of the promise +different threads with some restrictions and the final result of the promise is whichever call is made first. There are two restrictions on ordering: 1. That gst_promise_reply() and gst_promise_interrupt() cannot be called after gst_promise_expire() 2. That gst_promise_reply() and gst_promise_interrupt() -cannot be called twice. +cannot be called twice. + +The change function set with gst_promise_new_with_change_func() is +called directly from either the gst_promise_reply(), +gst_promise_interrupt() or gst_promise_expire() and can be called +from an arbitrary thread. #GstPromise using APIs can restrict this to +a single thread or a subset of threads but that is entirely up to the API +that uses #GstPromise. parent #GstMiniObject @@ -31564,7 +31580,8 @@ states. Expire a @promise. This will wake up any waiters with -%GST_PROMISE_RESULT_EXPIRED +%GST_PROMISE_RESULT_EXPIRED. Called by a message loop when the parent +message is handled and/or destroyed (possibly unanswered). @@ -31579,7 +31596,7 @@ states. c:identifier="gst_promise_get_reply" version="1.14"> Retrieve the reply set on @promise. @promise must be in -%GST_PROMISE_RESULT_REPLIED and is owned by @promise +%GST_PROMISE_RESULT_REPLIED and the returned structure is owned by @promise The reply set on @promise @@ -31595,7 +31612,8 @@ states. c:identifier="gst_promise_interrupt" version="1.14"> Interrupt waiting for a @promise. This will wake up any waiters with -%GST_PROMISE_RESULT_INTERRUPTED +%GST_PROMISE_RESULT_INTERRUPTED. Called when the consumer does not want +the value produced anymore. @@ -31608,7 +31626,11 @@ states. Set a reply on @promise. This will wake up any waiters with -%GST_PROMISE_RESULT_REPLIED. +%GST_PROMISE_RESULT_REPLIED. Called by the producer of the value to +indicate success (or failure). + +If @promise has already been interrupted by the consumer, then this reply +is not visible to the consumer. @@ -44695,7 +44717,7 @@ determine a order for the two provided values. The major version of GStreamer at compile time: - + The micro version of GStreamer at compile time: @@ -44703,7 +44725,7 @@ determine a order for the two provided values. The minor version of GStreamer at compile time: - + The nano version of GStreamer at compile time: Actual releases have 0, GIT versions have 1, prerelease versions have 2-... @@ -45201,11 +45223,17 @@ Only one logger at a time is possible. + To aid debugging applications one can use this method to obtain the whole +network of gstreamer elements that form the pipeline into an dot file. +This data can be processed with graphviz to get an image. + a string containing the pipeline in graphviz +dot format. + the top-level pipeline that should be analyzed @@ -45215,35 +45243,47 @@ Only one logger at a time is possible. + To aid debugging applications one can use this method to write out the whole +network of gstreamer elements that form the pipeline into an dot file. +This file can be processed with graphviz to get an image. +<informalexample><programlisting> + dot -Tpng -oimage.png graph_lowlevel.dot +</programlisting></informalexample> + the top-level pipeline that should be analyzed - + output base filename (e.g. "myplayer") + + This works like gst_debug_bin_to_dot_file(), but adds the current timestamp +to the filename, so that it can be used to take multiple snapshots. + the top-level pipeline that should be analyzed - + output base filename (e.g. "myplayer") + @@ -45811,7 +45851,7 @@ On Windows #filename should be in UTF-8 encoding. absolute or relative file name path - + @@ -46788,7 +46828,7 @@ application. the directory or %NULL, don't free or modify the string - + the application specific preset dir - + diff --git a/gir-files/GstBase-1.0.gir b/gir-files/GstBase-1.0.gir index 5dd9f7239..b84ba5911 100644 --- a/gir-files/GstBase-1.0.gir +++ b/gir-files/GstBase-1.0.gir @@ -11717,6 +11717,23 @@ it from the queue. version="1.14" introspectable="0"> Returns the tail of the queue @array and removes +it from the queue. + + The tail of the queue + + + + + a #GstQueueArray object + + + + + + Returns the tail of the queue @array and removes it from the queue. The tail of the queue diff --git a/gir-files/GstPbutils-1.0.gir b/gir-files/GstPbutils-1.0.gir index 3413a4619..596a61bed 100644 --- a/gir-files/GstPbutils-1.0.gir +++ b/gir-files/GstPbutils-1.0.gir @@ -2744,7 +2744,7 @@ in debugging. The micro version of GStreamer's gst-plugins-base libraries at compile time. @@ -2756,7 +2756,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/GstRtspServer-1.0.gir b/gir-files/GstRtspServer-1.0.gir index 17b1674ba..255babec8 100644 --- a/gir-files/GstRtspServer-1.0.gir +++ b/gir-files/GstRtspServer-1.0.gir @@ -5852,7 +5852,12 @@ which can be accomplished by enclosing the description with brackets '(' The description should return a pipeline with a single depayloader named depay_backchannel. A caps query on the depayloader's sinkpad should return all possible, complete RTP caps that are going to be supported. At least -the payload type, clock-rate and encoding-name need to be specified. +the payload type, clock-rate and encoding-name need to be specified. + +Note: The pipeline part passed here must end in sinks that are not waiting +until pre-rolling before reaching the PAUSED state, i.e. setting +async=false on #GstBaseSink. Otherwise the whole media will not be able to +prepare. diff --git a/gir-files/GstVideo-1.0.gir b/gir-files/GstVideo-1.0.gir index d373c4719..d50ff30a5 100644 --- a/gir-files/GstVideo-1.0.gir +++ b/gir-files/GstVideo-1.0.gir @@ -6367,19 +6367,19 @@ to implement frame dropping. value="78" c:identifier="GST_VIDEO_FORMAT_GRAY10_LE32" glib:nick="gray10-le32"> - 10-bit grayscale, packet in 32bit words (2 bits padding) + 10-bit grayscale, packed into 32bit words (2 bits padding) (Since: 1.14) - 10-bit variant of @GST_VIDEO_FORMAT_NV12, packet in 32bit words (MSB 2 bits padding) (Since: 1.14) + 10-bit variant of @GST_VIDEO_FORMAT_NV12, packed into 32bit words (MSB 2 bits padding) (Since: 1.14) - 10-bit variant of @GST_VIDEO_FORMAT_NV16, packet in 32bit words (MSB 2 bits padding) (Since: 1.14) + 10-bit variant of @GST_VIDEO_FORMAT_NV16, packed into 32bit words (MSB 2 bits padding) (Since: 1.14) Converts a FOURCC value into the corresponding #GstVideoFormat.