diff --git a/Gst-1.0.gir b/Gst-1.0.gir index 8aa9e36200dd4a1a93dddaea990015ddc987aba4..9db6fad1516a9f8b357dc919d66b1cf7a7be6ffa 100644 --- a/Gst-1.0.gir +++ b/Gst-1.0.gir @@ -2206,8 +2206,8 @@ data to a newly allocated memory if needed (if the type of memory requires it), otherwise the underlying data is just referenced. Check gst_buffer_copy_deep() if you want to force the data to be copied to newly allocated memory.</doc> - <return-value transfer-ownership="full"> - <doc xml:space="preserve">a new copy of @buf.</doc> + <return-value transfer-ownership="full" nullable="1"> + <doc xml:space="preserve">a new copy of @buf if the copy succeeded, %NULL otherwise.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> <parameters> @@ -2220,8 +2220,8 @@ to be copied to newly allocated memory.</doc> <method name="copy_deep" c:identifier="gst_buffer_copy_deep" version="1.6"> <doc xml:space="preserve">Creates a copy of the given buffer. This will make a newly allocated copy of the data the source buffer contains.</doc> - <return-value transfer-ownership="full"> - <doc xml:space="preserve">a new copy of @buf.</doc> + <return-value transfer-ownership="full" nullable="1"> + <doc xml:space="preserve">a new copy of @buf if the copy succeeded, %NULL otherwise.</doc> <type name="Buffer" c:type="GstBuffer*"/> </return-value> <parameters> @@ -10507,29 +10507,29 @@ freed by the caller.</doc> </parameter> </parameters> </function-macro> - <function-macro name="DEBUG_OBJECT" c:identifier="GST_DEBUG_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output a debugging message belonging to the given object in the default -category. + <function-macro name="DEBUG_ID" c:identifier="GST_DEBUG_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output a debugging message for the given identifier in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="DEBUG_OBJECT_ID" c:identifier="GST_DEBUG_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output a debugging message for the given identifier in the default category. + <function-macro name="DEBUG_OBJECT" c:identifier="GST_DEBUG_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output a debugging message belonging to the given object in the default +category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -13525,28 +13525,28 @@ character, a newline character will be added automatically.</doc> </parameter> </parameters> </function-macro> - <function-macro name="ERROR_OBJECT" c:identifier="GST_ERROR_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output an error message belonging to the given object in the default category. + <function-macro name="ERROR_ID" c:identifier="GST_ERROR_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output an error message for the given identifier in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="ERROR_OBJECT_ID" c:identifier="GST_ERROR_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output an error message for the given identifier in the default category. + <function-macro name="ERROR_OBJECT" c:identifier="GST_ERROR_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output an error message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -19080,28 +19080,28 @@ character, a newline character will be added automatically.</doc> </parameter> </parameters> </function-macro> - <function-macro name="FIXME_OBJECT" c:identifier="GST_FIXME_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output a fixme message belonging to the given object in the default category. + <function-macro name="FIXME_ID" c:identifier="GST_FIXME_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output a fixme message for the given identifier in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="FIXME_OBJECT_ID" c:identifier="GST_FIXME_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output a fixme message for the given identifier in the default category. + <function-macro name="FIXME_OBJECT" c:identifier="GST_FIXME_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output a fixme message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -19621,30 +19621,30 @@ character, a newline character will be added automatically.</doc> </parameter> </parameters> </function-macro> - <function-macro name="INFO_OBJECT" c:identifier="GST_INFO_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output an informational message belonging to the given object in the default + <function-macro name="INFO_ID" c:identifier="GST_INFO_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output an informational message for the given identifier the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="INFO_OBJECT_ID" c:identifier="GST_INFO_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output an informational message for the given identifier the default + <function-macro name="INFO_OBJECT" c:identifier="GST_INFO_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output an informational message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -20840,28 +20840,28 @@ character, a newline character will be added automatically.</doc> </parameter> </parameters> </function-macro> - <function-macro name="LOG_OBJECT" c:identifier="GST_LOG_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output a logging message belonging to the given object in the default category. + <function-macro name="LOG_ID" c:identifier="GST_LOG_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output a logging message for the given identifier in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="LOG_OBJECT_ID" c:identifier="GST_LOG_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output a logging message for the given identifier in the default category. + <function-macro name="LOG_OBJECT" c:identifier="GST_LOG_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output a logging message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -21557,8 +21557,8 @@ The prefix/padding must be filled with 0 if @flags contains <doc xml:space="preserve">Return a copy of @size bytes from @mem starting from @offset. This copy is guaranteed to be writable. @size can be set to -1 to return a copy from @offset to the end of the memory region.</doc> - <return-value transfer-ownership="full"> - <doc xml:space="preserve">a new #GstMemory.</doc> + <return-value transfer-ownership="full" nullable="1"> + <doc xml:space="preserve">a new copy of @mem if the copy succeeded, %NULL otherwise.</doc> <type name="Memory" c:type="GstMemory*"/> </return-value> <parameters> @@ -25257,9 +25257,9 @@ returned. This gives away the reference to the original mini object, and returns a reference to the new object. MT safe</doc> - <return-value transfer-ownership="full"> - <doc xml:space="preserve">a mini-object (possibly the same pointer) that - is writable.</doc> + <return-value transfer-ownership="full" nullable="1"> + <doc xml:space="preserve">a writable mini-object (which may or may not be + the same as @mini_object) or %NULL if copying is required but not possible.</doc> <type name="MiniObject" c:type="GstMiniObject*"/> </return-value> <parameters> @@ -41599,28 +41599,28 @@ character, a newline character will be added automatically.</doc> </parameter> </parameters> </function-macro> - <function-macro name="TRACE_OBJECT" c:identifier="GST_TRACE_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output a tracing message belonging to the given object in the default category. + <function-macro name="TRACE_ID" c:identifier="GST_TRACE_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output a tracing message for the given identifier in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="TRACE_OBJECT_ID" c:identifier="GST_TRACE_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output a tracing message for the given identifier in the default category. + <function-macro name="TRACE_OBJECT" c:identifier="GST_TRACE_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output a tracing message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -46978,28 +46978,28 @@ character, a newline character will be added automatically.</doc> </parameter> </parameters> </function-macro> - <function-macro name="WARNING_OBJECT" c:identifier="GST_WARNING_OBJECT" introspectable="0"> - <doc xml:space="preserve">Output a warning message belonging to the given object in the default category. + <function-macro name="WARNING_ID" c:identifier="GST_WARNING_ID" version="1.22" introspectable="0"> + <doc xml:space="preserve">Output a warning message for the given identifier in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="obj"> - <doc xml:space="preserve">the #GObject the message belongs to</doc> + <parameter name="id"> + <doc xml:space="preserve">An identifier of the message provider</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> </parameter> </parameters> </function-macro> - <function-macro name="WARNING_OBJECT_ID" c:identifier="GST_WARNING_OBJECT_ID" version="1.22" introspectable="0"> - <doc xml:space="preserve">Output a warning message for the given identifier in the default category. + <function-macro name="WARNING_OBJECT" c:identifier="GST_WARNING_OBJECT" introspectable="0"> + <doc xml:space="preserve">Output a warning message belonging to the given object in the default category. There is no need to finish the end of the message string with a newline character, a newline character will be added automatically.</doc> <parameters> - <parameter name="id"> - <doc xml:space="preserve">An identifier of the message provider</doc> + <parameter name="obj"> + <doc xml:space="preserve">the #GObject the message belongs to</doc> </parameter> <parameter name="..."> <doc xml:space="preserve">printf-style message to output</doc> @@ -49190,12 +49190,7 @@ for how to disable automatic registry updates. WARNING: This function will terminate your program if it was unable to initialize GStreamer for some reason. If you want your program to fall back, -use gst_init_check() instead. - -WARNING: This function does not work in the same way as corresponding -functions in other glib-style libraries, such as gtk_init\(\). In -particular, unknown command line options cause this function to -abort program execution.</doc> +use gst_init_check() instead.</doc> <return-value transfer-ownership="none"> <type name="none" c:type="void"/> </return-value> @@ -49311,8 +49306,11 @@ or gst_init_check().</doc> </parameters> </function-macro> <function-macro name="memory_make_writable" c:identifier="gst_memory_make_writable" introspectable="0"> + <doc xml:space="preserve">Returns a writable copy of @m. If the source memory is +already writable, this will simply return the same memory.</doc> <parameters> <parameter name="m"> + <doc xml:space="preserve">a #GstMemory</doc> </parameter> </parameters> </function-macro> diff --git a/GstAudio-1.0.gir b/GstAudio-1.0.gir index 22bd8a2f123e0fff5cd5bac94906d75fc3c1e86b..9baaeac596e556dbff4ff752ea6bb23ca2ff14c6 100644 --- a/GstAudio-1.0.gir +++ b/GstAudio-1.0.gir @@ -673,6 +673,14 @@ Formats are sorted by decreasing "quality", using these criteria by priority: </parameter> </parameters> </function-macro> + <function-macro name="AUDIO_FORMAT_INFO_IS_VALID_RAW" c:identifier="GST_AUDIO_FORMAT_INFO_IS_VALID_RAW" version="1.22" introspectable="0"> + <doc xml:space="preserve">Tests that the given #GstAudioFormatInfo represents a valid un-encoded +format.</doc> + <parameters> + <parameter name="info"> + </parameter> + </parameters> + </function-macro> <function-macro name="AUDIO_FORMAT_INFO_NAME" c:identifier="GST_AUDIO_FORMAT_INFO_NAME" introspectable="0"> <parameters> <parameter name="info"> diff --git a/GstVideo-1.0.gir b/GstVideo-1.0.gir index c81c09216875690192179db842db4c9f1be6b412..02fb13a5e6eb9f064b86f970b522fb00a3a37b8c 100644 --- a/GstVideo-1.0.gir +++ b/GstVideo-1.0.gir @@ -1957,9 +1957,21 @@ Apple, CapsLock or ShiftLock.</doc> <member name="control_mask" value="4" c:identifier="GST_NAVIGATION_MODIFIER_CONTROL_MASK" glib:nick="control-mask" glib:name="GST_NAVIGATION_MODIFIER_CONTROL_MASK"> <doc xml:space="preserve">the Control key.</doc> </member> - <member name="alt_mask" value="8" c:identifier="GST_NAVIGATION_MODIFIER_ALT_MASK" glib:nick="alt-mask" glib:name="GST_NAVIGATION_MODIFIER_ALT_MASK"> + <member name="mod1_mask" value="8" c:identifier="GST_NAVIGATION_MODIFIER_MOD1_MASK" glib:nick="mod1-mask" glib:name="GST_NAVIGATION_MODIFIER_MOD1_MASK"> + <doc xml:space="preserve">the third modifier key</doc> + </member> + <member name="mod2_mask" value="16" c:identifier="GST_NAVIGATION_MODIFIER_MOD2_MASK" glib:nick="mod2-mask" glib:name="GST_NAVIGATION_MODIFIER_MOD2_MASK"> <doc xml:space="preserve">the fourth modifier key</doc> </member> + <member name="mod3_mask" value="32" c:identifier="GST_NAVIGATION_MODIFIER_MOD3_MASK" glib:nick="mod3-mask" glib:name="GST_NAVIGATION_MODIFIER_MOD3_MASK"> + <doc xml:space="preserve">the fifth modifier key</doc> + </member> + <member name="mod4_mask" value="64" c:identifier="GST_NAVIGATION_MODIFIER_MOD4_MASK" glib:nick="mod4-mask" glib:name="GST_NAVIGATION_MODIFIER_MOD4_MASK"> + <doc xml:space="preserve">the sixth modifier key</doc> + </member> + <member name="mod5_mask" value="128" c:identifier="GST_NAVIGATION_MODIFIER_MOD5_MASK" glib:nick="mod5-mask" glib:name="GST_NAVIGATION_MODIFIER_MOD5_MASK"> + <doc xml:space="preserve">the seventh modifier key</doc> + </member> <member name="button1_mask" value="256" c:identifier="GST_NAVIGATION_MODIFIER_BUTTON1_MASK" glib:nick="button1-mask" glib:name="GST_NAVIGATION_MODIFIER_BUTTON1_MASK"> <doc xml:space="preserve">the first mouse button (usually the left button).</doc> </member> @@ -1984,7 +1996,7 @@ Apple, CapsLock or ShiftLock.</doc> <member name="meta_mask" value="268435456" c:identifier="GST_NAVIGATION_MODIFIER_META_MASK" glib:nick="meta-mask" glib:name="GST_NAVIGATION_MODIFIER_META_MASK"> <doc xml:space="preserve">the Meta modifier</doc> </member> - <member name="mask" value="469769999" c:identifier="GST_NAVIGATION_MODIFIER_MASK" glib:nick="mask" glib:name="GST_NAVIGATION_MODIFIER_MASK"> + <member name="mask" value="469770239" c:identifier="GST_NAVIGATION_MODIFIER_MASK" glib:nick="mask" glib:name="GST_NAVIGATION_MODIFIER_MASK"> <doc xml:space="preserve">A mask covering all entries in #GdkModifierType.</doc> </member> </bitfield> @@ -2801,6 +2813,14 @@ subsampling.</doc> </parameter> </parameters> </function-macro> + <function-macro name="VIDEO_FORMAT_INFO_IS_VALID_RAW" c:identifier="GST_VIDEO_FORMAT_INFO_IS_VALID_RAW" version="1.22" introspectable="0"> + <doc xml:space="preserve">Tests that the given #GstVideoFormatInfo represents a valid un-encoded +format.</doc> + <parameters> + <parameter name="info"> + </parameter> + </parameters> + </function-macro> <function-macro name="VIDEO_FORMAT_INFO_IS_YUV" c:identifier="GST_VIDEO_FORMAT_INFO_IS_YUV" introspectable="0"> <parameters> <parameter name="info">