mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2024-12-30 04:00:37 +00:00
Code Issues 1 Projects Releases Wiki Activity

core: Add/fix various annotations

Browse source 
And fix memory leaks/null pointer dereferences in GstUri in error cases.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/3194>
This commit is contained in:
Sebastian Dröge 2022-10-15 12:31:17 +03:00
parent 0a513e9168
commit 749423bb7f
17 changed files with 380 additions and 364 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
subprojects/gstreamer/gst/gstatomicqueue.c
View file

@ -264,7 +264,7 @@ gst_atomic_queue_peek (GstAtomicQueue * queue)
* *
* Get the head element of the queue. * Get the head element of the queue.
* *
* Returns: (transfer full): the head element of @queue or %NULL when * Returns: (transfer full) (nullable): the head element of @queue or %NULL when
* the queue is empty. * the queue is empty.
*/ */
gpointer gpointer

4
subprojects/gstreamer/gst/gstbuffer.c
View file

@ -2141,8 +2141,8 @@ gst_buffer_memset (GstBuffer * buffer, gsize offset, guint8 val, gsize size)
* duration and offset end fields are also copied. If not they will be set * duration and offset end fields are also copied. If not they will be set
* to #GST_CLOCK_TIME_NONE and #GST_BUFFER_OFFSET_NONE. * to #GST_CLOCK_TIME_NONE and #GST_BUFFER_OFFSET_NONE.
* *
* Returns: (transfer full): the new #GstBuffer or %NULL if the arguments were * Returns: (transfer full) (nullable): the new #GstBuffer or %NULL if copying
* invalid. * failed.
*/ */
GstBuffer * GstBuffer *
gst_buffer_copy_region (GstBuffer * buffer, GstBufferCopyFlags flags, gst_buffer_copy_region (GstBuffer * buffer, GstBufferCopyFlags flags,

6
subprojects/gstreamer/gst/gstbufferpool.c
View file

@ -1258,8 +1258,8 @@ default_reset_buffer (GstBufferPool * pool, GstBuffer * buffer)
/** /**
* gst_buffer_pool_acquire_buffer: * gst_buffer_pool_acquire_buffer:
* @pool: a #GstBufferPool * @pool: a #GstBufferPool
* @buffer: (out): a location for a #GstBuffer * @buffer: (out) (transfer full) (nullable): a location for a #GstBuffer
* @params: (transfer none) (allow-none): parameters. * @params: (transfer none) (nullable): parameters.
* *
* Acquires a buffer from @pool. @buffer should point to a memory location that * Acquires a buffer from @pool. @buffer should point to a memory location that
* can hold a pointer to the new buffer. When the pool is empty, this function * can hold a pointer to the new buffer. When the pool is empty, this function
@ -1281,6 +1281,8 @@ gst_buffer_pool_acquire_buffer (GstBufferPool * pool, GstBuffer ** buffer,
g_return_val_if_fail (GST_IS_BUFFER_POOL (pool), GST_FLOW_ERROR); g_return_val_if_fail (GST_IS_BUFFER_POOL (pool), GST_FLOW_ERROR);
g_return_val_if_fail (buffer != NULL, GST_FLOW_ERROR); g_return_val_if_fail (buffer != NULL, GST_FLOW_ERROR);
*buffer = NULL;
pclass = GST_BUFFER_POOL_GET_CLASS (pool); pclass = GST_BUFFER_POOL_GET_CLASS (pool);
/* assume we'll have one more outstanding buffer we need to do that so /* assume we'll have one more outstanding buffer we need to do that so

8
subprojects/gstreamer/gst/gstbufferpool.h
View file

@ -176,8 +176,8 @@ struct _GstBufferPoolClass {
/** /**
* GstBufferPoolClass::acquire_buffer: * GstBufferPoolClass::acquire_buffer:
* @pool: the #GstBufferPool * @pool: the #GstBufferPool
* @buffer: (out): a location for a #GstBuffer * @buffer: (out) (transfer full) (nullable): a location for a #GstBuffer
* @params: (transfer none) (allow-none): parameters. * @params: (transfer none) (nullable): parameters.
* *
* Get a new buffer from the pool. The default implementation * Get a new buffer from the pool. The default implementation
* will take a buffer from the queue and optionally wait for a buffer to * will take a buffer from the queue and optionally wait for a buffer to
@ -192,8 +192,8 @@ struct _GstBufferPoolClass {
/** /**
* GstBufferPoolClass::alloc_buffer: * GstBufferPoolClass::alloc_buffer:
* @pool: the #GstBufferPool * @pool: the #GstBufferPool
* @buffer: (out): a location for a #GstBuffer * @buffer: (out) (transfer full) (nullable): a location for a #GstBuffer
* @params: (transfer none) (allow-none): parameters. * @params: (transfer none) (nullable): parameters.
* *
* Allocate a buffer. the default implementation allocates * Allocate a buffer. the default implementation allocates
* buffers from the configured memory allocator and with the configured * buffers from the configured memory allocator and with the configured

2
subprojects/gstreamer/gst/gstelement.c
View file

@ -417,7 +417,7 @@ gst_element_set_clock_func (GstElement * element, GstClock * clock)
/** /**
* gst_element_set_clock: * gst_element_set_clock:
* @element: a #GstElement to set the clock for. * @element: a #GstElement to set the clock for.
* @clock: (transfer none) (allow-none): the #GstClock to set for the element. * @clock: (transfer none) (nullable): the #GstClock to set for the element.
* *
* Sets the clock for the element. This function increases the * Sets the clock for the element. This function increases the
* refcount on the clock. Any previously set clock on the object * refcount on the clock. Any previously set clock on the object

122
subprojects/gstreamer/gst/gstevent.c
View file

@ -298,7 +298,7 @@ gst_event_init (GstEventImpl * event, GstEventType type)
* New custom events can also be created by subclassing the event type if * New custom events can also be created by subclassing the event type if
* needed. * needed.
* *
* Returns: (transfer full) (nullable): the new custom event. * Returns: (transfer full): the new custom event.
*/ */
GstEvent * GstEvent *
gst_event_new_custom (GstEventType type, GstStructure * structure) gst_event_new_custom (GstEventType type, GstStructure * structure)
@ -591,7 +591,7 @@ gst_event_new_flush_stop (gboolean reset_time)
/** /**
* gst_event_parse_flush_stop: * gst_event_parse_flush_stop:
* @event: The event to parse * @event: The event to parse
* @reset_time: (out): if time should be reset * @reset_time: (out) (optional): if time should be reset
* *
* Parse the FLUSH_STOP event and retrieve the @reset_time member. * Parse the FLUSH_STOP event and retrieve the @reset_time member.
*/ */
@ -626,8 +626,7 @@ gst_event_parse_flush_stop (GstEvent * event, gboolean * reset_time)
* *
* Note: The list of @streams can not be empty. * Note: The list of @streams can not be empty.
* *
* Returns: (transfer full): a new select-streams event or %NULL in case of * Returns: (transfer full): a new select-streams event.
* an error (like an empty streams list).
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -661,7 +660,7 @@ gst_event_new_select_streams (GList * streams)
/** /**
* gst_event_parse_select_streams: * gst_event_parse_select_streams:
* @event: The event to parse * @event: The event to parse
* @streams: (out) (element-type utf8) (transfer full): the streams * @streams: (out) (optional) (element-type utf8) (transfer full): the streams
* *
* Parse the SELECT_STREAMS event and retrieve the contained streams. * Parse the SELECT_STREAMS event and retrieve the contained streams.
* *
@ -724,7 +723,7 @@ gst_event_new_stream_group_done (guint group_id)
/** /**
* gst_event_parse_stream_group_done: * gst_event_parse_stream_group_done:
* @event: a stream-group-done event. * @event: a stream-group-done event.
* @group_id: (out): address of variable to store the group id into * @group_id: (out) (optional): address of variable to store the group id into
* *
* Parse a stream-group-done @event and store the result in the given * Parse a stream-group-done @event and store the result in the given
* @group_id location. * @group_id location.
@ -804,9 +803,9 @@ gst_event_new_gap (GstClockTime timestamp, GstClockTime duration)
/** /**
* gst_event_parse_gap: * gst_event_parse_gap:
* @event: a #GstEvent of type #GST_EVENT_GAP * @event: a #GstEvent of type #GST_EVENT_GAP
* @timestamp: (out) (allow-none): location where to store the * @timestamp: (out) (optional): location where to store the
* start time (pts) of the gap, or %NULL * start time (pts) of the gap, or %NULL
* @duration: (out) (allow-none): location where to store the duration of * @duration: (out) (optional): location where to store the duration of
* the gap, or %NULL * the gap, or %NULL
* *
* Extract timestamp and duration from a new GAP event. * Extract timestamp and duration from a new GAP event.
@ -850,7 +849,7 @@ gst_event_set_gap_flags (GstEvent * event, GstGapFlags flags)
/** /**
* gst_event_parse_gap_flags: * gst_event_parse_gap_flags:
* @event: a #GstEvent of type #GST_EVENT_GAP * @event: a #GstEvent of type #GST_EVENT_GAP
* @flags: (out): a #GstGapFlags or %NULL * @flags: (out) (optional): a #GstGapFlags or %NULL
* *
* Retrieve the gap flags that may have been set on a gap event with * Retrieve the gap flags that may have been set on a gap event with
* gst_event_set_gap_flags(). * gst_event_set_gap_flags().
@ -879,7 +878,7 @@ gst_event_parse_gap_flags (GstEvent * event, GstGapFlags * flags)
* synchronized with the buffer flow and contains the format of the buffers * synchronized with the buffer flow and contains the format of the buffers
* that will follow after the event. * that will follow after the event.
* *
* Returns: (transfer full) (nullable): the new CAPS event. * Returns: (transfer full): the new CAPS event.
*/ */
GstEvent * GstEvent *
gst_event_new_caps (GstCaps * caps) gst_event_new_caps (GstCaps * caps)
@ -901,7 +900,7 @@ gst_event_new_caps (GstCaps * caps)
/** /**
* gst_event_parse_caps: * gst_event_parse_caps:
* @event: The event to parse * @event: The event to parse
* @caps: (out) (transfer none): A pointer to the caps * @caps: (out) (optional) (transfer none): A pointer to the caps
* *
* Get the caps from @event. The caps remains valid as long as @event remains * Get the caps from @event. The caps remains valid as long as @event remains
* valid. * valid.
@ -957,7 +956,7 @@ gst_event_parse_caps (GstEvent * event, GstCaps ** caps)
* *
* time + (TIMESTAMP(buf) - start) * ABS (rate * applied_rate) * time + (TIMESTAMP(buf) - start) * ABS (rate * applied_rate)
* *
* Returns: (transfer full) (nullable): the new SEGMENT event. * Returns: (transfer full): the new SEGMENT event.
*/ */
GstEvent * GstEvent *
gst_event_new_segment (const GstSegment * segment) gst_event_new_segment (const GstSegment * segment)
@ -982,7 +981,7 @@ gst_event_new_segment (const GstSegment * segment)
/** /**
* gst_event_parse_segment: * gst_event_parse_segment:
* @event: The event to parse * @event: The event to parse
* @segment: (out) (transfer none): a pointer to a #GstSegment * @segment: (out) (optional) (transfer none): a pointer to a #GstSegment
* *
* Parses a segment @event and stores the result in the given @segment location. * Parses a segment @event and stores the result in the given @segment location.
* @segment remains valid only until the @event is freed. Don't modify the segment * @segment remains valid only until the @event is freed. Don't modify the segment
@ -1059,7 +1058,7 @@ gst_event_new_tag (GstTagList * taglist)
/** /**
* gst_event_parse_tag: * gst_event_parse_tag:
* @event: a tag event * @event: a tag event
* @taglist: (out) (transfer none): pointer to metadata list * @taglist: (out) (optional) (transfer none): pointer to metadata list
* *
* Parses a tag @event and stores the results in the given @taglist location. * Parses a tag @event and stores the results in the given @taglist location.
* No reference to the taglist will be returned, it remains valid only until * No reference to the taglist will be returned, it remains valid only until
@ -1121,10 +1120,10 @@ gst_event_new_buffer_size (GstFormat format, gint64 minsize,
/** /**
* gst_event_parse_buffer_size: * gst_event_parse_buffer_size:
* @event: The event to query * @event: The event to query
* @format: (out): A pointer to store the format in * @format: (out) (optional): A pointer to store the format in
* @minsize: (out): A pointer to store the minsize in * @minsize: (out) (optional): A pointer to store the minsize in
* @maxsize: (out): A pointer to store the maxsize in * @maxsize: (out) (optional): A pointer to store the maxsize in
* @async: (out): A pointer to store the async-flag in * @async: (out) (optional): A pointer to store the async-flag in
* *
* Get the format, minsize, maxsize and async-flag in the buffersize event. * Get the format, minsize, maxsize and async-flag in the buffersize event.
*/ */
@ -1206,7 +1205,7 @@ gst_event_parse_buffer_size (GstEvent * event, GstFormat * format,
* The application can use general event probes to intercept the QoS * The application can use general event probes to intercept the QoS
* event and implement custom application specific QoS handling. * event and implement custom application specific QoS handling.
* *
* Returns: (transfer full) (nullable): a new QOS event. * Returns: (transfer full): a new QOS event.
*/ */
GstEvent * GstEvent *
gst_event_new_qos (GstQOSType type, gdouble proportion, gst_event_new_qos (GstQOSType type, gdouble proportion,
@ -1236,10 +1235,10 @@ gst_event_new_qos (GstQOSType type, gdouble proportion,
/** /**
* gst_event_parse_qos: * gst_event_parse_qos:
* @event: The event to query * @event: The event to query
* @type: (out): A pointer to store the QoS type in * @type: (out) (optional): A pointer to store the QoS type in
* @proportion: (out): A pointer to store the proportion in * @proportion: (out) (optional): A pointer to store the proportion in
* @diff: (out): A pointer to store the diff in * @diff: (out) (optional): A pointer to store the diff in
* @timestamp: (out): A pointer to store the timestamp in * @timestamp: (out) (optional): A pointer to store the timestamp in
* *
* Get the type, proportion, diff and timestamp in the qos event. See * Get the type, proportion, diff and timestamp in the qos event. See
* gst_event_new_qos() for more information about the different QoS values. * gst_event_new_qos() for more information about the different QoS values.
@ -1332,7 +1331,7 @@ gst_event_parse_qos (GstEvent * event, GstQOSType * type,
* #GST_QUERY_POSITION and update the playback segment current position with a * #GST_QUERY_POSITION and update the playback segment current position with a
* #GST_SEEK_TYPE_SET to the desired position. * #GST_SEEK_TYPE_SET to the desired position.
* *
* Returns: (transfer full) (nullable): a new seek event. * Returns: (transfer full): a new seek event.
*/ */
GstEvent * GstEvent *
gst_event_new_seek (gdouble rate, GstFormat format, GstSeekFlags flags, gst_event_new_seek (gdouble rate, GstFormat format, GstSeekFlags flags,
@ -1393,13 +1392,13 @@ gst_event_new_seek (gdouble rate, GstFormat format, GstSeekFlags flags,
/** /**
* gst_event_parse_seek: * gst_event_parse_seek:
* @event: a seek event * @event: a seek event
* @rate: (out): result location for the rate * @rate: (out) (optional): result location for the rate
* @format: (out): result location for the stream format * @format: (out) (optional): result location for the stream format
* @flags: (out): result location for the #GstSeekFlags * @flags: (out) (optional): result location for the #GstSeekFlags
* @start_type: (out): result location for the #GstSeekType of the start position * @start_type: (out) (optional): result location for the #GstSeekType of the start position
* @start: (out): result location for the start position expressed in @format * @start: (out) (optional): result location for the start position expressed in @format
* @stop_type: (out): result location for the #GstSeekType of the stop position * @stop_type: (out) (optional): result location for the #GstSeekType of the stop position
* @stop: (out): result location for the stop position expressed in @format * @stop: (out) (optional): result location for the stop position expressed in @format
* *
* Parses a seek @event and stores the results in the given result locations. * Parses a seek @event and stores the results in the given result locations.
*/ */
@ -1467,7 +1466,7 @@ gst_event_set_seek_trickmode_interval (GstEvent * event, GstClockTime interval)
/** /**
* gst_event_parse_seek_trickmode_interval: * gst_event_parse_seek_trickmode_interval:
* @interval: (out) * @interval: (out) (optional): interval
* *
* Retrieve the trickmode interval that may have been set on a * Retrieve the trickmode interval that may have been set on a
* seek event with gst_event_set_seek_trickmode_interval(). * seek event with gst_event_set_seek_trickmode_interval().
@ -1541,7 +1540,7 @@ gst_event_new_latency (GstClockTime latency)
/** /**
* gst_event_parse_latency: * gst_event_parse_latency:
* @event: The event to query * @event: The event to query
* @latency: (out): A pointer to store the latency in. * @latency: (out) (optional): A pointer to store the latency in.
* *
* Get the latency in the latency event. * Get the latency in the latency event.
*/ */
@ -1579,7 +1578,7 @@ gst_event_parse_latency (GstEvent * event, GstClockTime * latency)
* The @intermediate flag instructs the pipeline that this step operation is * The @intermediate flag instructs the pipeline that this step operation is
* part of a larger step operation. * part of a larger step operation.
* *
* Returns: (transfer full) (nullable): a new #GstEvent * Returns: (transfer full): a new #GstEvent
*/ */
GstEvent * GstEvent *
gst_event_new_step (GstFormat format, guint64 amount, gdouble rate, gst_event_new_step (GstFormat format, guint64 amount, gdouble rate,
@ -1606,11 +1605,11 @@ gst_event_new_step (GstFormat format, guint64 amount, gdouble rate,
/** /**
* gst_event_parse_step: * gst_event_parse_step:
* @event: The event to query * @event: The event to query
* @format: (out) (allow-none): a pointer to store the format in * @format: (out) (optional): a pointer to store the format in
* @amount: (out) (allow-none): a pointer to store the amount in * @amount: (out) (optional): a pointer to store the amount in
* @rate: (out) (allow-none): a pointer to store the rate in * @rate: (out) (optional): a pointer to store the rate in
* @flush: (out) (allow-none): a pointer to store the flush boolean in * @flush: (out) (optional): a pointer to store the flush boolean in
* @intermediate: (out) (allow-none): a pointer to store the intermediate * @intermediate: (out) (optional): a pointer to store the intermediate
* boolean in * boolean in
* *
* Parse the step event. * Parse the step event.
@ -1699,7 +1698,7 @@ gst_event_new_sink_message (const gchar * name, GstMessage * msg)
/** /**
* gst_event_parse_sink_message: * gst_event_parse_sink_message:
* @event: The event to query * @event: The event to query
* @msg: (out) (transfer full): a pointer to store the #GstMessage in. * @msg: (out) (optional) (transfer full): a pointer to store the #GstMessage in.
* *
* Parse the sink-message event. Unref @msg after usage. * Parse the sink-message event. Unref @msg after usage.
*/ */
@ -1763,7 +1762,7 @@ gst_event_new_stream_start (const gchar * stream_id)
/** /**
* gst_event_parse_stream_start: * gst_event_parse_stream_start:
* @event: a stream-start event. * @event: a stream-start event.
* @stream_id: (out) (transfer none): pointer to store the stream-id * @stream_id: (out) (optional) (transfer none): pointer to store the stream-id
* *
* Parse a stream-id @event and store the result in the given @stream_id * Parse a stream-id @event and store the result in the given @stream_id
* location. The string stored in @stream_id must not be modified and will * location. The string stored in @stream_id must not be modified and will
@ -1809,7 +1808,7 @@ gst_event_set_stream (GstEvent * event, GstStream * stream)
/** /**
* gst_event_parse_stream: * gst_event_parse_stream:
* @event: a stream-start event * @event: a stream-start event
* @stream: (out) (transfer full): address of variable to store the stream * @stream: (out) (optional) (transfer full): address of variable to store the stream
* *
* Parse a stream-start @event and extract the #GstStream from it. * Parse a stream-start @event and extract the #GstStream from it.
* *
@ -1849,7 +1848,7 @@ gst_event_set_stream_flags (GstEvent * event, GstStreamFlags flags)
/** /**
* gst_event_parse_stream_flags: * gst_event_parse_stream_flags:
* @event: a stream-start event * @event: a stream-start event
* @flags: (out): address of variable where to store the stream flags * @flags: (out) (optional): address of variable where to store the stream flags
* *
* Since: 1.2 * Since: 1.2
*/ */
@ -1896,7 +1895,7 @@ gst_event_set_group_id (GstEvent * event, guint group_id)
/** /**
* gst_event_parse_group_id: * gst_event_parse_group_id:
* @event: a stream-start event * @event: a stream-start event
* @group_id: (out): address of variable where to store the group id * @group_id: (out) (optional): address of variable where to store the group id
* *
* Returns: %TRUE if a group id was set on the event and could be parsed, * Returns: %TRUE if a group id was set on the event and could be parsed,
* %FALSE otherwise. * %FALSE otherwise.
@ -1953,7 +1952,7 @@ gst_event_new_stream_collection (GstStreamCollection * collection)
/** /**
* gst_event_parse_stream_collection: * gst_event_parse_stream_collection:
* @event: a stream-collection event * @event: a stream-collection event
* @collection: (out): pointer to store the collection * @collection: (out) (optional): pointer to store the collection
* *
* Retrieve new #GstStreamCollection from STREAM_COLLECTION event @event. * Retrieve new #GstStreamCollection from STREAM_COLLECTION event @event.
* *
@ -2013,8 +2012,8 @@ gst_event_new_toc (GstToc * toc, gboolean updated)
/** /**
* gst_event_parse_toc: * gst_event_parse_toc:
* @event: a TOC event. * @event: a TOC event.
* @toc: (out) (transfer full): pointer to #GstToc structure. * @toc: (out) (optional) (transfer full): pointer to #GstToc structure.
* @updated: (out): pointer to store TOC updated flag. * @updated: (out) (optional): pointer to store TOC updated flag.
* *
* Parse a TOC @event and store the results in the given @toc and @updated locations. * Parse a TOC @event and store the results in the given @toc and @updated locations.
*/ */
@ -2062,7 +2061,7 @@ gst_event_new_toc_select (const gchar * uid)
/** /**
* gst_event_parse_toc_select: * gst_event_parse_toc_select:
* @event: a TOC select event. * @event: a TOC select event.
* @uid: (out) (transfer full) (allow-none): storage for the selection UID. * @uid: (out) (transfer full) (optional): storage for the selection UID.
* *
* Parse a TOC select @event and store the results in the given @uid location. * Parse a TOC select @event and store the results in the given @uid location.
*/ */
@ -2123,8 +2122,7 @@ gst_event_parse_toc_select (GstEvent * event, gchar ** uid)
* event of a particular @origin and @system_id will * event of a particular @origin and @system_id will
* be stuck to the output pad of the sending element. * be stuck to the output pad of the sending element.
* *
* Returns: a #GST_EVENT_PROTECTION event, if successful; %NULL * Returns: (transfer full): a #GST_EVENT_PROTECTION event.
* if unsuccessful.
* *
* Since: 1.6 * Since: 1.6
*/ */
@ -2158,11 +2156,11 @@ gst_event_new_protection (const gchar * system_id,
/** /**
* gst_event_parse_protection: * gst_event_parse_protection:
* @event: a #GST_EVENT_PROTECTION event. * @event: a #GST_EVENT_PROTECTION event.
* @system_id: (out) (allow-none) (transfer none): pointer to store the UUID * @system_id: (out) (optional) (transfer none): pointer to store the UUID
* string uniquely identifying a content protection system. * string uniquely identifying a content protection system.
* @data: (out) (allow-none) (transfer none): pointer to store a #GstBuffer * @data: (out) (optional) (transfer none): pointer to store a #GstBuffer
* holding protection system specific information. * holding protection system specific information.
* @origin: (out) (allow-none) (transfer none): pointer to store a value that * @origin: (out) (optional) (transfer none): pointer to store a value that
* indicates where the protection information carried by @event was extracted * indicates where the protection information carried by @event was extracted
* from. * from.
* *
@ -2226,8 +2224,8 @@ gst_event_new_segment_done (GstFormat format, gint64 position)
/** /**
* gst_event_parse_segment_done: * gst_event_parse_segment_done:
* @event: A valid #GstEvent of type GST_EVENT_SEGMENT_DONE. * @event: A valid #GstEvent of type GST_EVENT_SEGMENT_DONE.
* @format: (out) (allow-none): Result location for the format, or %NULL * @format: (out) (optional): Result location for the format, or %NULL
* @position: (out) (allow-none): Result location for the position, or %NULL * @position: (out) (optional): Result location for the position, or %NULL
* *
* Extracts the position and format from the segment done message. * Extracts the position and format from the segment done message.
* *
@ -2296,9 +2294,9 @@ gst_event_new_instant_rate_change (gdouble rate_multiplier,
/** /**
* gst_event_parse_instant_rate_change: * gst_event_parse_instant_rate_change:
* @event: a #GstEvent of type #GST_EVENT_INSTANT_RATE_CHANGE * @event: a #GstEvent of type #GST_EVENT_INSTANT_RATE_CHANGE
* @rate_multiplier: (out) (allow-none): location in which to store the rate * @rate_multiplier: (out) (optional): location in which to store the rate
* multiplier of the instant-rate-change event, or %NULL * multiplier of the instant-rate-change event, or %NULL
* @new_flags: (out) (allow-none): location in which to store the new * @new_flags: (out) (optional): location in which to store the new
* segment flags of the instant-rate-change event, or %NULL * segment flags of the instant-rate-change event, or %NULL
* *
* Extract rate and flags from an instant-rate-change event. * Extract rate and flags from an instant-rate-change event.
@ -2372,11 +2370,11 @@ gst_event_new_instant_rate_sync_time (gdouble rate_multiplier,
/** /**
* gst_event_parse_instant_rate_sync_time: * gst_event_parse_instant_rate_sync_time:
* @event: a #GstEvent of type #GST_EVENT_INSTANT_RATE_CHANGE * @event: a #GstEvent of type #GST_EVENT_INSTANT_RATE_CHANGE
* @rate_multiplier: (out) (allow-none): location where to store the rate of * @rate_multiplier: (out) (optional): location where to store the rate of
* the instant-rate-sync-time event, or %NULL * the instant-rate-sync-time event, or %NULL
* @running_time: (out) (allow-none): location in which to store the running time * @running_time: (out) (optional): location in which to store the running time
* of the instant-rate-sync-time event, or %NULL * of the instant-rate-sync-time event, or %NULL
* @upstream_running_time: (out) (allow-none): location in which to store the * @upstream_running_time: (out) (optional): location in which to store the
* upstream running time of the instant-rate-sync-time event, or %NULL * upstream running time of the instant-rate-sync-time event, or %NULL
* *
* Extract the rate multiplier and running times from an instant-rate-sync-time event. * Extract the rate multiplier and running times from an instant-rate-sync-time event.
@ -2404,7 +2402,7 @@ gst_event_parse_instant_rate_sync_time (GstEvent * event,
* gst_event_replace: (skip) * gst_event_replace: (skip)
* @old_event: (inout) (transfer full) (nullable): pointer to a * @old_event: (inout) (transfer full) (nullable): pointer to a
* pointer to a #GstEvent to be replaced. * pointer to a #GstEvent to be replaced.
* @new_event: (allow-none) (transfer none): pointer to a #GstEvent that will * @new_event: (nullable) (transfer none): pointer to a #GstEvent that will
* replace the event pointed to by @old_event. * replace the event pointed to by @old_event.
* *
* Modifies a pointer to a #GstEvent to point to a different #GstEvent. The * Modifies a pointer to a #GstEvent to point to a different #GstEvent. The
@ -2443,7 +2441,7 @@ gst_event_steal (GstEvent ** old_event)
* gst_event_take: (skip) * gst_event_take: (skip)
* @old_event: (inout) (transfer full) (nullable): pointer to a * @old_event: (inout) (transfer full) (nullable): pointer to a
* pointer to a #GstEvent to be stolen. * pointer to a #GstEvent to be stolen.
* @new_event: (allow-none) (transfer full): pointer to a #GstEvent that will * @new_event: (nullable) (transfer full): pointer to a #GstEvent that will
* replace the event pointed to by @old_event. * replace the event pointed to by @old_event.
* *
* Modifies a pointer to a #GstEvent to point to a different #GstEvent. This * Modifies a pointer to a #GstEvent to point to a different #GstEvent. This

2
subprojects/gstreamer/gst/gstinfo.c
View file

@ -3377,7 +3377,7 @@ gst_ring_buffer_logger_log (GstDebugCategory * category,
* Fetches the current logs per thread from the ring buffer logger. See * Fetches the current logs per thread from the ring buffer logger. See
* gst_debug_add_ring_buffer_logger() for details. * gst_debug_add_ring_buffer_logger() for details.
* *
* Returns: (transfer full) (array zero-terminated): NULL-terminated array of * Returns: (transfer full) (array zero-terminated=1): NULL-terminated array of
* strings with the debug output per thread * strings with the debug output per thread
* *
* Since: 1.14 * Since: 1.14

290
subprojects/gstreamer/gst/gstmessage.c
View file

@ -281,15 +281,15 @@ gst_message_init (GstMessageImpl * message, GstMessageType type,
/** /**
* gst_message_new_custom: * gst_message_new_custom:
* @type: The #GstMessageType to distinguish messages * @type: The #GstMessageType to distinguish messages
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @structure: (transfer full) (allow-none): the structure for the * @structure: (transfer full) (nullable): the structure for the
* message. The message will take ownership of the structure. * message. The message will take ownership of the structure.
* *
* Create a new custom-typed message. This can be used for anything not * Create a new custom-typed message. This can be used for anything not
* handled by other message-specific functions to pass a message to the * handled by other message-specific functions to pass a message to the
* app. The structure field can be %NULL. * app. The structure field can be %NULL.
* *
* Returns: (transfer full) (nullable): The new message. * Returns: (transfer full): The new message.
* *
* MT safe. * MT safe.
*/ */
@ -379,7 +379,7 @@ gst_message_set_seqnum (GstMessage * message, guint32 seqnum)
/** /**
* gst_message_new_eos: * gst_message_new_eos:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* *
* Create a new eos message. This message is generated and posted in * Create a new eos message. This message is generated and posted in
* the sink elements of a GstBin. The bin will only forward the EOS * the sink elements of a GstBin. The bin will only forward the EOS
@ -401,17 +401,17 @@ gst_message_new_eos (GstObject * src)
/** /**
* gst_message_new_error_with_details: * gst_message_new_error_with_details:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @error: (transfer none): The GError for this message. * @error: (transfer none): The GError for this message.
* @debug: A debugging string. * @debug: A debugging string.
* @details: (transfer full) (allow-none): A GstStructure with details * @details: (transfer full) (nullable): A GstStructure with details
* *
* Create a new error message. The message will copy @error and * Create a new error message. The message will copy @error and
* @debug. This message is posted by element when a fatal event * @debug. This message is posted by element when a fatal event
* occurred. The pipeline will probably (partially) stop. The application * occurred. The pipeline will probably (partially) stop. The application
* receiving this message should stop the pipeline. * receiving this message should stop the pipeline.
* *
* Returns: (transfer full) (nullable): the new error message. * Returns: (transfer full): the new error message.
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -446,7 +446,7 @@ gst_message_new_error_with_details (GstObject * src, GError * error,
/** /**
* gst_message_new_error: * gst_message_new_error:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @error: (transfer none): The GError for this message. * @error: (transfer none): The GError for this message.
* @debug: A debugging string. * @debug: A debugging string.
* *
@ -468,7 +468,7 @@ gst_message_new_error (GstObject * src, GError * error, const gchar * debug)
/** /**
* gst_message_parse_error_details: * gst_message_parse_error_details:
* @message: The message object * @message: The message object
* @structure: (transfer none) (out): A pointer to the returned details * @structure: (optional) (nullable) (transfer none) (out): A pointer to the returned details
* *
* Returns the optional details structure, may be NULL if none. * Returns the optional details structure, may be NULL if none.
* The returned structure must not be freed. * The returned structure must not be freed.
@ -495,15 +495,15 @@ gst_message_parse_error_details (GstMessage * message,
/** /**
* gst_message_new_warning_with_details: * gst_message_new_warning_with_details:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @error: (transfer none): The GError for this message. * @error: (transfer none): The GError for this message.
* @debug: A debugging string. * @debug: A debugging string.
* @details: (transfer full) (allow-none): A GstStructure with details * @details: (transfer full) (nullable): A GstStructure with details
* *
* Create a new warning message. The message will make copies of @error and * Create a new warning message. The message will make copies of @error and
* @debug. * @debug.
* *
* Returns: (transfer full) (nullable): the new warning message. * Returns: (transfer full): the new warning message.
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -538,7 +538,7 @@ gst_message_new_warning_with_details (GstObject * src, GError * error,
/** /**
* gst_message_new_warning: * gst_message_new_warning:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @error: (transfer none): The GError for this message. * @error: (transfer none): The GError for this message.
* @debug: A debugging string. * @debug: A debugging string.
* *
@ -558,7 +558,7 @@ gst_message_new_warning (GstObject * src, GError * error, const gchar * debug)
/** /**
* gst_message_parse_warning_details: * gst_message_parse_warning_details:
* @message: The message object * @message: The message object
* @structure: (transfer none) (out): A pointer to the returned details structure * @structure: (optional) (nullable) (transfer none) (out): A pointer to the returned details
* *
* Returns the optional details structure, may be NULL if none * Returns the optional details structure, may be NULL if none
* The returned structure must not be freed. * The returned structure must not be freed.
@ -585,15 +585,15 @@ gst_message_parse_warning_details (GstMessage * message,
/** /**
* gst_message_new_info_with_details: * gst_message_new_info_with_details:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @error: (transfer none): The GError for this message. * @error: (transfer none): The GError for this message.
* @debug: A debugging string. * @debug: A debugging string.
* @details: (transfer full) (allow-none): A GstStructure with details * @details: (transfer full) (nullable): A GstStructure with details
* *
* Create a new info message. The message will make copies of @error and * Create a new info message. The message will make copies of @error and
* @debug. * @debug.
* *
* Returns: (transfer full) (nullable): the new warning message. * Returns: (transfer full): the new warning message.
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -628,7 +628,7 @@ gst_message_new_info_with_details (GstObject * src, GError * error,
/** /**
* gst_message_new_info: * gst_message_new_info:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @error: (transfer none): The GError for this message. * @error: (transfer none): The GError for this message.
* @debug: A debugging string. * @debug: A debugging string.
* *
@ -648,7 +648,7 @@ gst_message_new_info (GstObject * src, GError * error, const gchar * debug)
/** /**
* gst_message_parse_info_details: * gst_message_parse_info_details:
* @message: The message object * @message: The message object
* @structure: (transfer none) (out): A pointer to the returned details structure * @structure: (optional) (nullable) (transfer none) (out): A pointer to the returned details
* *
* Returns the optional details structure, may be NULL if none * Returns the optional details structure, may be NULL if none
* The returned structure must not be freed. * The returned structure must not be freed.
@ -675,7 +675,7 @@ gst_message_parse_info_details (GstMessage * message,
/** /**
* gst_message_new_tag: * gst_message_new_tag:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @tag_list: (transfer full): the tag list for the message. * @tag_list: (transfer full): the tag list for the message.
* *
* Create a new tag message. The message will take ownership of the tag list. * Create a new tag message. The message will take ownership of the tag list.
@ -704,7 +704,7 @@ gst_message_new_tag (GstObject * src, GstTagList * tag_list)
/** /**
* gst_message_new_buffering: * gst_message_new_buffering:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @percent: The buffering percent * @percent: The buffering percent
* *
* Create a new buffering message. This message can be posted by an element that * Create a new buffering message. This message can be posted by an element that
@ -720,7 +720,7 @@ gst_message_new_tag (GstObject * src, GstTagList * tag_list)
* *
* MT safe. * MT safe.
* *
* Returns: (transfer full) (nullable): The new buffering message. * Returns: (transfer full): The new buffering message.
*/ */
GstMessage * GstMessage *
gst_message_new_buffering (GstObject * src, gint percent) gst_message_new_buffering (GstObject * src, gint percent)
@ -746,7 +746,7 @@ gst_message_new_buffering (GstObject * src, gint percent)
/** /**
* gst_message_new_state_changed: * gst_message_new_state_changed:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @oldstate: the previous state * @oldstate: the previous state
* @newstate: the new (current) state * @newstate: the new (current) state
* @pending: the pending (target) state * @pending: the pending (target) state
@ -776,7 +776,7 @@ gst_message_new_state_changed (GstObject * src,
/** /**
* gst_message_new_state_dirty: * gst_message_new_state_dirty:
* @src: (transfer none) (allow-none): The object originating the message * @src: (transfer none) (nullable): The object originating the message
* *
* Create a state dirty message. This message is posted whenever an element * Create a state dirty message. This message is posted whenever an element
* changed its state asynchronously and is used internally to update the * changed its state asynchronously and is used internally to update the
@ -798,7 +798,7 @@ gst_message_new_state_dirty (GstObject * src)
/** /**
* gst_message_new_clock_provide: * gst_message_new_clock_provide:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @clock: (transfer none): the clock it provides * @clock: (transfer none): the clock it provides
* @ready: %TRUE if the sender can provide a clock * @ready: %TRUE if the sender can provide a clock
* *
@ -830,7 +830,7 @@ gst_message_new_clock_provide (GstObject * src, GstClock * clock,
/** /**
* gst_message_new_clock_lost: * gst_message_new_clock_lost:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @clock: (transfer none): the clock that was lost * @clock: (transfer none): the clock that was lost
* *
* Create a clock lost message. This message is posted whenever the * Create a clock lost message. This message is posted whenever the
@ -859,7 +859,7 @@ gst_message_new_clock_lost (GstObject * src, GstClock * clock)
/** /**
* gst_message_new_new_clock: * gst_message_new_new_clock:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @clock: (transfer none): the new selected clock * @clock: (transfer none): the new selected clock
* *
* Create a new clock message. This message is posted whenever the * Create a new clock message. This message is posted whenever the
@ -884,7 +884,7 @@ gst_message_new_new_clock (GstObject * src, GstClock * clock)
/** /**
* gst_message_new_structure_change: * gst_message_new_structure_change:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @type: The change type. * @type: The change type.
* @owner: (transfer none): The owner element of @src. * @owner: (transfer none): The owner element of @src.
* @busy: Whether the structure change is busy. * @busy: Whether the structure change is busy.
@ -923,7 +923,7 @@ gst_message_new_structure_change (GstObject * src, GstStructureChangeType type,
/** /**
* gst_message_new_segment_start: * gst_message_new_segment_start:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @format: The format of the position being played * @format: The format of the position being played
* @position: The position of the segment being played * @position: The position of the segment being played
* *
@ -953,7 +953,7 @@ gst_message_new_segment_start (GstObject * src, GstFormat format,
/** /**
* gst_message_new_segment_done: * gst_message_new_segment_done:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @format: The format of the position being done * @format: The format of the position being done
* @position: The position of the segment being done * @position: The position of the segment being done
* *
@ -983,14 +983,14 @@ gst_message_new_segment_done (GstObject * src, GstFormat format,
/** /**
* gst_message_new_application: * gst_message_new_application:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @structure: (transfer full): the structure for the message. The message * @structure: (transfer full): the structure for the message. The message
* will take ownership of the structure. * will take ownership of the structure.
* *
* Create a new application-typed message. GStreamer will never create these * Create a new application-typed message. GStreamer will never create these
* messages; they are a gift from us to you. Enjoy. * messages; they are a gift from us to you. Enjoy.
* *
* Returns: (transfer full) (nullable): The new application message. * Returns: (transfer full): The new application message.
* *
* MT safe. * MT safe.
*/ */
@ -1004,7 +1004,7 @@ gst_message_new_application (GstObject * src, GstStructure * structure)
/** /**
* gst_message_new_element: * gst_message_new_element:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @structure: (transfer full): The structure for the * @structure: (transfer full): The structure for the
* message. The message will take ownership of the structure. * message. The message will take ownership of the structure.
* *
@ -1013,7 +1013,7 @@ gst_message_new_application (GstObject * src, GstStructure * structure)
* "the firewire cable was unplugged". The format of the message should be * "the firewire cable was unplugged". The format of the message should be
* documented in the element's documentation. The structure field can be %NULL. * documented in the element's documentation. The structure field can be %NULL.
* *
* Returns: (transfer full) (nullable): The new element message. * Returns: (transfer full): The new element message.
* *
* MT safe. * MT safe.
*/ */
@ -1027,7 +1027,7 @@ gst_message_new_element (GstObject * src, GstStructure * structure)
/** /**
* gst_message_new_duration_changed: * gst_message_new_duration_changed:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* *
* Create a new duration changed message. This message is posted by elements * Create a new duration changed message. This message is posted by elements
* that know the duration of a stream when the duration changes. This message * that know the duration of a stream when the duration changes. This message
@ -1051,7 +1051,7 @@ gst_message_new_duration_changed (GstObject * src)
/** /**
* gst_message_new_async_start: * gst_message_new_async_start:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* *
* This message is posted by elements when they start an ASYNC state change. * This message is posted by elements when they start an ASYNC state change.
* *
@ -1071,7 +1071,7 @@ gst_message_new_async_start (GstObject * src)
/** /**
* gst_message_new_async_done: * gst_message_new_async_done:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @running_time: the desired running_time * @running_time: the desired running_time
* *
* The message is posted when elements completed an ASYNC state change. * The message is posted when elements completed an ASYNC state change.
@ -1099,7 +1099,7 @@ gst_message_new_async_done (GstObject * src, GstClockTime running_time)
/** /**
* gst_message_new_latency: * gst_message_new_latency:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* *
* This message can be posted by elements when their latency requirements have * This message can be posted by elements when their latency requirements have
* changed. * changed.
@ -1120,7 +1120,7 @@ gst_message_new_latency (GstObject * src)
/** /**
* gst_message_new_request_state: * gst_message_new_request_state:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @state: The new requested state * @state: The new requested state
* *
* This message can be posted by elements when they want to have their state * This message can be posted by elements when they want to have their state
@ -1267,7 +1267,7 @@ gst_message_parse_tag (GstMessage * message, GstTagList ** tag_list)
/** /**
* gst_message_parse_buffering: * gst_message_parse_buffering:
* @message: A valid #GstMessage of type GST_MESSAGE_BUFFERING. * @message: A valid #GstMessage of type GST_MESSAGE_BUFFERING.
* @percent: (out) (allow-none): Return location for the percent. * @percent: (out) (optional): Return location for the percent.
* *
* Extracts the buffering percent from the GstMessage. see also * Extracts the buffering percent from the GstMessage. see also
* gst_message_new_buffering(). * gst_message_new_buffering().
@ -1313,10 +1313,10 @@ gst_message_set_buffering_stats (GstMessage * message, GstBufferingMode mode,
/** /**
* gst_message_parse_buffering_stats: * gst_message_parse_buffering_stats:
* @message: A valid #GstMessage of type GST_MESSAGE_BUFFERING. * @message: A valid #GstMessage of type GST_MESSAGE_BUFFERING.
* @mode: (out) (allow-none): a buffering mode, or %NULL * @mode: (out) (optional): a buffering mode, or %NULL
* @avg_in: (out) (allow-none): the average input rate, or %NULL * @avg_in: (out) (optional): the average input rate, or %NULL
* @avg_out: (out) (allow-none): the average output rate, or %NULL * @avg_out: (out) (optional): the average output rate, or %NULL
* @buffering_left: (out) (allow-none): amount of buffering time left in * @buffering_left: (out) (optional): amount of buffering time left in
* milliseconds, or %NULL * milliseconds, or %NULL
* *
* Extracts the buffering stats values from @message. * Extracts the buffering stats values from @message.
@ -1350,9 +1350,9 @@ gst_message_parse_buffering_stats (GstMessage * message,
/** /**
* gst_message_parse_state_changed: * gst_message_parse_state_changed:
* @message: a valid #GstMessage of type GST_MESSAGE_STATE_CHANGED * @message: a valid #GstMessage of type GST_MESSAGE_STATE_CHANGED
* @oldstate: (out) (allow-none): the previous state, or %NULL * @oldstate: (out) (optional): the previous state, or %NULL
* @newstate: (out) (allow-none): the new (current) state, or %NULL * @newstate: (out) (optional): the new (current) state, or %NULL
* @pending: (out) (allow-none): the pending (target) state, or %NULL * @pending: (out) (optional): the pending (target) state, or %NULL
* *
* Extracts the old and new states from the GstMessage. * Extracts the old and new states from the GstMessage.
* *
@ -1404,9 +1404,9 @@ gst_message_parse_state_changed (GstMessage * message,
/** /**
* gst_message_parse_clock_provide: * gst_message_parse_clock_provide:
* @message: A valid #GstMessage of type GST_MESSAGE_CLOCK_PROVIDE. * @message: A valid #GstMessage of type GST_MESSAGE_CLOCK_PROVIDE.
* @clock: (out) (allow-none) (transfer none): a pointer to hold a clock * @clock: (out) (optional) (transfer none): a pointer to hold a clock
* object, or %NULL * object, or %NULL
* @ready: (out) (allow-none): a pointer to hold the ready flag, or %NULL * @ready: (out) (optional): a pointer to hold the ready flag, or %NULL
* *
* Extracts the clock and ready flag from the GstMessage. * Extracts the clock and ready flag from the GstMessage.
* The clock object returned remains valid until the message is freed. * The clock object returned remains valid until the message is freed.
@ -1439,7 +1439,7 @@ gst_message_parse_clock_provide (GstMessage * message, GstClock ** clock,
/** /**
* gst_message_parse_clock_lost: * gst_message_parse_clock_lost:
* @message: A valid #GstMessage of type GST_MESSAGE_CLOCK_LOST. * @message: A valid #GstMessage of type GST_MESSAGE_CLOCK_LOST.
* @clock: (out) (allow-none) (transfer none): a pointer to hold the lost clock * @clock: (out) (optional) (transfer none): a pointer to hold the lost clock
* *
* Extracts the lost clock from the GstMessage. * Extracts the lost clock from the GstMessage.
* The clock object returned remains valid until the message is freed. * The clock object returned remains valid until the message is freed.
@ -1467,7 +1467,7 @@ gst_message_parse_clock_lost (GstMessage * message, GstClock ** clock)
/** /**
* gst_message_parse_new_clock: * gst_message_parse_new_clock:
* @message: A valid #GstMessage of type GST_MESSAGE_NEW_CLOCK. * @message: A valid #GstMessage of type GST_MESSAGE_NEW_CLOCK.
* @clock: (out) (allow-none) (transfer none): a pointer to hold the selected * @clock: (out) (optional) (transfer none): a pointer to hold the selected
* new clock * new clock
* *
* Extracts the new clock from the GstMessage. * Extracts the new clock from the GstMessage.
@ -1497,9 +1497,9 @@ gst_message_parse_new_clock (GstMessage * message, GstClock ** clock)
* gst_message_parse_structure_change: * gst_message_parse_structure_change:
* @message: A valid #GstMessage of type GST_MESSAGE_STRUCTURE_CHANGE. * @message: A valid #GstMessage of type GST_MESSAGE_STRUCTURE_CHANGE.
* @type: (out): A pointer to hold the change type * @type: (out): A pointer to hold the change type
* @owner: (out) (allow-none) (transfer none): The owner element of the * @owner: (out) (optional) (transfer none): The owner element of the
* message source * message source
* @busy: (out) (allow-none): a pointer to hold whether the change is in * @busy: (out) (optional): a pointer to hold whether the change is in
* progress or has been completed * progress or has been completed
* *
* Extracts the change type and completion status from the GstMessage. * Extracts the change type and completion status from the GstMessage.
@ -1536,8 +1536,8 @@ gst_message_parse_structure_change (GstMessage * message,
/** /**
* gst_message_parse_error: * gst_message_parse_error:
* @message: A valid #GstMessage of type GST_MESSAGE_ERROR. * @message: A valid #GstMessage of type GST_MESSAGE_ERROR.
* @gerror: (out) (allow-none) (transfer full): location for the GError * @gerror: (out) (optional) (transfer full): location for the GError
* @debug: (out) (allow-none) (transfer full): location for the debug message, * @debug: (out) (optional) (nullable) (transfer full): location for the debug message,
* or %NULL * or %NULL
* *
* Extracts the GError and debug string from the GstMessage. The values returned * Extracts the GError and debug string from the GstMessage. The values returned
@ -1580,8 +1580,8 @@ gst_message_parse_error (GstMessage * message, GError ** gerror, gchar ** debug)
/** /**
* gst_message_parse_warning: * gst_message_parse_warning:
* @message: A valid #GstMessage of type GST_MESSAGE_WARNING. * @message: A valid #GstMessage of type GST_MESSAGE_WARNING.
* @gerror: (out) (allow-none) (transfer full): location for the GError * @gerror: (out) (optional) (transfer full): location for the GError
* @debug: (out) (allow-none) (transfer full): location for the debug message, * @debug: (out) (optional) (nullable) (transfer full): location for the debug message,
* or %NULL * or %NULL
* *
* Extracts the GError and debug string from the GstMessage. The values returned * Extracts the GError and debug string from the GstMessage. The values returned
@ -1604,8 +1604,8 @@ gst_message_parse_warning (GstMessage * message, GError ** gerror,
/** /**
* gst_message_parse_info: * gst_message_parse_info:
* @message: A valid #GstMessage of type GST_MESSAGE_INFO. * @message: A valid #GstMessage of type GST_MESSAGE_INFO.
* @gerror: (out) (allow-none) (transfer full): location for the GError * @gerror: (out) (optional) (transfer full): location for the GError
* @debug: (out) (allow-none) (transfer full): location for the debug message, * @debug: (out) (optional) (nullable) (transfer full): location for the debug message,
* or %NULL * or %NULL
* *
* Extracts the GError and debug string from the GstMessage. The values returned * Extracts the GError and debug string from the GstMessage. The values returned
@ -1627,8 +1627,8 @@ gst_message_parse_info (GstMessage * message, GError ** gerror, gchar ** debug)
/** /**
* gst_message_parse_segment_start: * gst_message_parse_segment_start:
* @message: A valid #GstMessage of type GST_MESSAGE_SEGMENT_START. * @message: A valid #GstMessage of type GST_MESSAGE_SEGMENT_START.
* @format: (out) (allow-none): Result location for the format, or %NULL * @format: (out) (optional): Result location for the format, or %NULL
* @position: (out) (allow-none): Result location for the position, or %NULL * @position: (out) (optional): Result location for the position, or %NULL
* *
* Extracts the position and format from the segment start message. * Extracts the position and format from the segment start message.
* *
@ -1657,8 +1657,8 @@ gst_message_parse_segment_start (GstMessage * message, GstFormat * format,
/** /**
* gst_message_parse_segment_done: * gst_message_parse_segment_done:
* @message: A valid #GstMessage of type GST_MESSAGE_SEGMENT_DONE. * @message: A valid #GstMessage of type GST_MESSAGE_SEGMENT_DONE.
* @format: (out) (allow-none): Result location for the format, or %NULL * @format: (out) (optional): Result location for the format, or %NULL
* @position: (out) (allow-none): Result location for the position, or %NULL * @position: (out) (optional): Result location for the position, or %NULL
* *
* Extracts the position and format from the segment done message. * Extracts the position and format from the segment done message.
* *
@ -1687,7 +1687,7 @@ gst_message_parse_segment_done (GstMessage * message, GstFormat * format,
/** /**
* gst_message_parse_async_done: * gst_message_parse_async_done:
* @message: A valid #GstMessage of type GST_MESSAGE_ASYNC_DONE. * @message: A valid #GstMessage of type GST_MESSAGE_ASYNC_DONE.
* @running_time: (out) (allow-none): Result location for the running_time or %NULL * @running_time: (out) (optional): Result location for the running_time or %NULL
* *
* Extract the running_time from the async_done message. * Extract the running_time from the async_done message.
* *
@ -1711,7 +1711,7 @@ gst_message_parse_async_done (GstMessage * message, GstClockTime * running_time)
/** /**
* gst_message_parse_request_state: * gst_message_parse_request_state:
* @message: A valid #GstMessage of type GST_MESSAGE_REQUEST_STATE. * @message: A valid #GstMessage of type GST_MESSAGE_REQUEST_STATE.
* @state: (out) (allow-none): Result location for the requested state or %NULL * @state: (out) (optional): Result location for the requested state or %NULL
* *
* Extract the requested state from the request_state message. * Extract the requested state from the request_state message.
* *
@ -1734,7 +1734,7 @@ gst_message_parse_request_state (GstMessage * message, GstState * state)
/** /**
* gst_message_new_stream_status: * gst_message_new_stream_status:
* @src: The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @type: The stream status type. * @type: The stream status type.
* @owner: (transfer none): the owner element of @src. * @owner: (transfer none): the owner element of @src.
* *
@ -1844,7 +1844,7 @@ gst_message_get_stream_status_object (GstMessage * message)
/** /**
* gst_message_new_step_done: * gst_message_new_step_done:
* @src: The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @format: the format of @amount * @format: the format of @amount
* @amount: the amount of stepped data * @amount: the amount of stepped data
* @rate: the rate of the stepped amount * @rate: the rate of the stepped amount
@ -1887,13 +1887,13 @@ gst_message_new_step_done (GstObject * src, GstFormat format, guint64 amount,
/** /**
* gst_message_parse_step_done: * gst_message_parse_step_done:
* @message: A valid #GstMessage of type GST_MESSAGE_STEP_DONE. * @message: A valid #GstMessage of type GST_MESSAGE_STEP_DONE.
* @format: (out) (allow-none): result location for the format * @format: (out) (optional): result location for the format
* @amount: (out) (allow-none): result location for the amount * @amount: (out) (optional): result location for the amount
* @rate: (out) (allow-none): result location for the rate * @rate: (out) (optional): result location for the rate
* @flush: (out) (allow-none): result location for the flush flag * @flush: (out) (optional): result location for the flush flag
* @intermediate: (out) (allow-none): result location for the intermediate flag * @intermediate: (out) (optional): result location for the intermediate flag
* @duration: (out) (allow-none): result location for the duration * @duration: (out) (optional): result location for the duration
* @eos: (out) (allow-none): result location for the EOS flag * @eos: (out) (optional): result location for the EOS flag
* *
* Extract the values the step_done message. * Extract the values the step_done message.
* *
@ -1922,7 +1922,7 @@ gst_message_parse_step_done (GstMessage * message, GstFormat * format,
/** /**
* gst_message_new_step_start: * gst_message_new_step_start:
* @src: The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @active: if the step is active or queued * @active: if the step is active or queued
* @format: the format of @amount * @format: the format of @amount
* @amount: the amount of stepped data * @amount: the amount of stepped data
@ -1967,12 +1967,12 @@ gst_message_new_step_start (GstObject * src, gboolean active, GstFormat format,
/** /**
* gst_message_parse_step_start: * gst_message_parse_step_start:
* @message: A valid #GstMessage of type GST_MESSAGE_STEP_DONE. * @message: A valid #GstMessage of type GST_MESSAGE_STEP_DONE.
* @active: (out) (allow-none): result location for the active flag * @active: (out) (optional): result location for the active flag
* @format: (out) (allow-none): result location for the format * @format: (out) (optional): result location for the format
* @amount: (out) (allow-none): result location for the amount * @amount: (out) (optional): result location for the amount
* @rate: (out) (allow-none): result location for the rate * @rate: (out) (optional): result location for the rate
* @flush: (out) (allow-none): result location for the flush flag * @flush: (out) (optional): result location for the flush flag
* @intermediate: (out) (allow-none): result location for the intermediate flag * @intermediate: (out) (optional): result location for the intermediate flag
* *
* Extract the values from step_start message. * Extract the values from step_start message.
* *
@ -2000,7 +2000,7 @@ gst_message_parse_step_start (GstMessage * message, gboolean * active,
/** /**
* gst_message_new_qos: * gst_message_new_qos:
* @src: The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @live: if the message was generated by a live element * @live: if the message was generated by a live element
* @running_time: the running time of the buffer that generated the message * @running_time: the running time of the buffer that generated the message
* @stream_time: the stream time of the buffer that generated the message * @stream_time: the stream time of the buffer that generated the message
@ -2116,14 +2116,14 @@ gst_message_set_qos_stats (GstMessage * message, GstFormat format,
/** /**
* gst_message_parse_qos: * gst_message_parse_qos:
* @message: A valid #GstMessage of type GST_MESSAGE_QOS. * @message: A valid #GstMessage of type GST_MESSAGE_QOS.
* @live: (out) (allow-none): if the message was generated by a live element * @live: (out) (optional): if the message was generated by a live element
* @running_time: (out) (allow-none): the running time of the buffer that * @running_time: (out) (optional): the running time of the buffer that
* generated the message * generated the message
* @stream_time: (out) (allow-none): the stream time of the buffer that * @stream_time: (out) (optional): the stream time of the buffer that
* generated the message * generated the message
* @timestamp: (out) (allow-none): the timestamps of the buffer that * @timestamp: (out) (optional): the timestamps of the buffer that
* generated the message * generated the message
* @duration: (out) (allow-none): the duration of the buffer that * @duration: (out) (optional): the duration of the buffer that
* generated the message * generated the message
* *
* Extract the timestamps and live status from the QoS message. * Extract the timestamps and live status from the QoS message.
@ -2156,11 +2156,11 @@ gst_message_parse_qos (GstMessage * message, gboolean * live,
/** /**
* gst_message_parse_qos_values: * gst_message_parse_qos_values:
* @message: A valid #GstMessage of type GST_MESSAGE_QOS. * @message: A valid #GstMessage of type GST_MESSAGE_QOS.
* @jitter: (out) (allow-none): The difference of the running-time against * @jitter: (out) (optional): The difference of the running-time against
* the deadline. * the deadline.
* @proportion: (out) (allow-none): Long term prediction of the ideal rate * @proportion: (out) (optional): Long term prediction of the ideal rate
* relative to normal rate to get optimal quality. * relative to normal rate to get optimal quality.
* @quality: (out) (allow-none): An element dependent integer value that * @quality: (out) (optional): An element dependent integer value that
* specifies the current quality level of the element. The default * specifies the current quality level of the element. The default
* maximum quality is 1000000. * maximum quality is 1000000.
* *
@ -2187,13 +2187,13 @@ gst_message_parse_qos_values (GstMessage * message, gint64 * jitter,
/** /**
* gst_message_parse_qos_stats: * gst_message_parse_qos_stats:
* @message: A valid #GstMessage of type GST_MESSAGE_QOS. * @message: A valid #GstMessage of type GST_MESSAGE_QOS.
* @format: (out) (allow-none): Units of the 'processed' and 'dropped' fields. * @format: (out) (optional): Units of the 'processed' and 'dropped' fields.
* Video sinks and video filters will use GST_FORMAT_BUFFERS (frames). * Video sinks and video filters will use GST_FORMAT_BUFFERS (frames).
* Audio sinks and audio filters will likely use GST_FORMAT_DEFAULT * Audio sinks and audio filters will likely use GST_FORMAT_DEFAULT
* (samples). * (samples).
* @processed: (out) (allow-none): Total number of units correctly processed * @processed: (out) (optional): Total number of units correctly processed
* since the last state change to READY or a flushing operation. * since the last state change to READY or a flushing operation.
* @dropped: (out) (allow-none): Total number of units dropped since the last * @dropped: (out) (optional): Total number of units dropped since the last
* state change to READY or a flushing operation. * state change to READY or a flushing operation.
* *
* Extract the QoS stats representing the history of the current continuous * Extract the QoS stats representing the history of the current continuous
@ -2222,7 +2222,7 @@ gst_message_parse_qos_stats (GstMessage * message, GstFormat * format,
/** /**
* gst_message_new_progress: * gst_message_new_progress:
* @src: The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @type: a #GstProgressType * @type: a #GstProgressType
* @code: a progress code * @code: a progress code
* @text: free, user visible text describing the progress * @text: free, user visible text describing the progress
@ -2233,7 +2233,7 @@ gst_message_parse_qos_stats (GstMessage * message, GstFormat * format,
* @code contains a well defined string describing the action. * @code contains a well defined string describing the action.
* @text should contain a user visible string detailing the current action. * @text should contain a user visible string detailing the current action.
* *
* Returns: (transfer full) (nullable): The new qos message. * Returns: (transfer full): The new qos message.
*/ */
GstMessage * GstMessage *
gst_message_new_progress (GstObject * src, GstProgressType type, gst_message_new_progress (GstObject * src, GstProgressType type,
@ -2263,9 +2263,9 @@ gst_message_new_progress (GstObject * src, GstProgressType type,
/** /**
* gst_message_parse_progress: * gst_message_parse_progress:
* @message: A valid #GstMessage of type GST_MESSAGE_PROGRESS. * @message: A valid #GstMessage of type GST_MESSAGE_PROGRESS.
* @type: (out) (allow-none): location for the type * @type: (out) (optional): location for the type
* @code: (out) (allow-none) (transfer full): location for the code * @code: (out) (optional) (transfer full): location for the code
* @text: (out) (allow-none) (transfer full): location for the text * @text: (out) (optional) (transfer full): location for the text
* *
* Parses the progress @type, @code and @text. * Parses the progress @type, @code and @text.
*/ */
@ -2287,7 +2287,7 @@ gst_message_parse_progress (GstMessage * message, GstProgressType * type,
/** /**
* gst_message_new_toc: * gst_message_new_toc:
* @src: the object originating the message. * @src: (transfer none) (nullable): the object originating the message.
* @toc: (transfer none): #GstToc structure for the message. * @toc: (transfer none): #GstToc structure for the message.
* @updated: whether TOC was updated or not. * @updated: whether TOC was updated or not.
* *
@ -2338,7 +2338,7 @@ gst_message_parse_toc (GstMessage * message, GstToc ** toc, gboolean * updated)
/** /**
* gst_message_new_reset_time: * gst_message_new_reset_time:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @running_time: the requested running-time * @running_time: the requested running-time
* *
* This message is posted when the pipeline running-time should be reset to * This message is posted when the pipeline running-time should be reset to
@ -2366,7 +2366,7 @@ gst_message_new_reset_time (GstObject * src, GstClockTime running_time)
/** /**
* gst_message_parse_reset_time: * gst_message_parse_reset_time:
* @message: A valid #GstMessage of type GST_MESSAGE_RESET_TIME. * @message: A valid #GstMessage of type GST_MESSAGE_RESET_TIME.
* @running_time: (out) (allow-none): Result location for the running_time or * @running_time: (out) (optional): Result location for the running_time or
* %NULL * %NULL
* *
* Extract the running-time from the RESET_TIME message. * Extract the running-time from the RESET_TIME message.
@ -2390,7 +2390,7 @@ gst_message_parse_reset_time (GstMessage * message, GstClockTime * running_time)
/** /**
* gst_message_new_stream_start: * gst_message_new_stream_start:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* *
* Create a new stream_start message. This message is generated and posted in * Create a new stream_start message. This message is generated and posted in
* the sink elements of a GstBin. The bin will only forward the STREAM_START * the sink elements of a GstBin. The bin will only forward the STREAM_START
@ -2448,7 +2448,7 @@ gst_message_set_group_id (GstMessage * message, guint group_id)
/** /**
* gst_message_parse_group_id: * gst_message_parse_group_id:
* @message: A valid #GstMessage of type GST_MESSAGE_STREAM_START. * @message: A valid #GstMessage of type GST_MESSAGE_STREAM_START.
* @group_id: (out) (allow-none): Result location for the group id or * @group_id: (out) (optional): Result location for the group id or
* %NULL * %NULL
* *
* Extract the group from the STREAM_START message. * Extract the group from the STREAM_START message.
@ -2486,7 +2486,7 @@ gst_message_parse_group_id (GstMessage * message, guint * group_id)
/** /**
* gst_message_new_need_context: * gst_message_new_need_context:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @context_type: The context type that is needed * @context_type: The context type that is needed
* *
* This message is posted when an element needs a specific #GstContext. * This message is posted when an element needs a specific #GstContext.
@ -2515,7 +2515,7 @@ gst_message_new_need_context (GstObject * src, const gchar * context_type)
/** /**
* gst_message_parse_context_type: * gst_message_parse_context_type:
* @message: a GST_MESSAGE_NEED_CONTEXT type message * @message: a GST_MESSAGE_NEED_CONTEXT type message
* @context_type: (out) (transfer none) (allow-none): the context type, or %NULL * @context_type: (out) (transfer none) (optional): the context type, or %NULL
* *
* Parse a context type from an existing GST_MESSAGE_NEED_CONTEXT message. * Parse a context type from an existing GST_MESSAGE_NEED_CONTEXT message.
* *
@ -2545,7 +2545,7 @@ gst_message_parse_context_type (GstMessage * message,
/** /**
* gst_message_new_have_context: * gst_message_new_have_context:
* @src: (transfer none) (allow-none): The object originating the message. * @src: (transfer none) (nullable): The object originating the message.
* @context: (transfer full): the context * @context: (transfer full): the context
* *
* This message is posted when an element has a new local #GstContext. * This message is posted when an element has a new local #GstContext.
@ -2573,7 +2573,7 @@ gst_message_new_have_context (GstObject * src, GstContext * context)
/** /**
* gst_message_parse_have_context: * gst_message_parse_have_context:
* @message: A valid #GstMessage of type GST_MESSAGE_HAVE_CONTEXT. * @message: A valid #GstMessage of type GST_MESSAGE_HAVE_CONTEXT.
* @context: (out) (transfer full) (allow-none): Result location for the * @context: (out) (transfer full) (optional): Result location for the
* context or %NULL * context or %NULL
* *
* Extract the context from the HAVE_CONTEXT message. * Extract the context from the HAVE_CONTEXT message.
@ -2595,14 +2595,14 @@ gst_message_parse_have_context (GstMessage * message, GstContext ** context)
/** /**
* gst_message_new_device_added: * gst_message_new_device_added:
* @src: The #GstObject that created the message * @src: (transfer none) (nullable): The #GstObject that created the message
* @device: (transfer none): The new #GstDevice * @device: (transfer none): The new #GstDevice
* *
* Creates a new device-added message. The device-added message is produced by * Creates a new device-added message. The device-added message is produced by
* #GstDeviceProvider or a #GstDeviceMonitor. They announce the appearance * #GstDeviceProvider or a #GstDeviceMonitor. They announce the appearance
* of monitored devices. * of monitored devices.
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.4 * Since: 1.4
*/ */
@ -2625,7 +2625,7 @@ gst_message_new_device_added (GstObject * src, GstDevice * device)
/** /**
* gst_message_parse_device_added: * gst_message_parse_device_added:
* @message: a #GstMessage of type %GST_MESSAGE_DEVICE_ADDED * @message: a #GstMessage of type %GST_MESSAGE_DEVICE_ADDED
* @device: (out) (allow-none) (transfer full): A location where to store a * @device: (out) (optional) (transfer full): A location where to store a
* pointer to the new #GstDevice, or %NULL * pointer to the new #GstDevice, or %NULL
* *
* Parses a device-added message. The device-added message is produced by * Parses a device-added message. The device-added message is produced by
@ -2647,14 +2647,14 @@ gst_message_parse_device_added (GstMessage * message, GstDevice ** device)
/** /**
* gst_message_new_device_removed: * gst_message_new_device_removed:
* @src: The #GstObject that created the message * @src: (transfer none) (nullable): The #GstObject that created the message
* @device: (transfer none): The removed #GstDevice * @device: (transfer none): The removed #GstDevice
* *
* Creates a new device-removed message. The device-removed message is produced * Creates a new device-removed message. The device-removed message is produced
* by #GstDeviceProvider or a #GstDeviceMonitor. They announce the * by #GstDeviceProvider or a #GstDeviceMonitor. They announce the
* disappearance of monitored devices. * disappearance of monitored devices.
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.4 * Since: 1.4
*/ */
@ -2677,7 +2677,7 @@ gst_message_new_device_removed (GstObject * src, GstDevice * device)
/** /**
* gst_message_parse_device_removed: * gst_message_parse_device_removed:
* @message: a #GstMessage of type %GST_MESSAGE_DEVICE_REMOVED * @message: a #GstMessage of type %GST_MESSAGE_DEVICE_REMOVED
* @device: (out) (allow-none) (transfer full): A location where to store a * @device: (out) (optional) (transfer full): A location where to store a
* pointer to the removed #GstDevice, or %NULL * pointer to the removed #GstDevice, or %NULL
* *
* Parses a device-removed message. The device-removed message is produced by * Parses a device-removed message. The device-removed message is produced by
@ -2699,15 +2699,16 @@ gst_message_parse_device_removed (GstMessage * message, GstDevice ** device)
/** /**
* gst_message_new_device_changed: * gst_message_new_device_changed:
* @src: The #GstObject that created the message * @src: (transfer none) (nullable): The #GstObject that created the message
* @device: (transfer none): The newly created device representing @replaced_device * @device: (transfer none): The newly created device representing @changed_device
* with its new configuration. * with its new configuration.
* @changed_device: (transfer none): The old version of the device.
* *
* Creates a new device-changed message. The device-changed message is produced * Creates a new device-changed message. The device-changed message is produced
* by #GstDeviceProvider or a #GstDeviceMonitor. They announce that a device * by #GstDeviceProvider or a #GstDeviceMonitor. They announce that a device
* properties has changed and @device represent the new modified version of @changed_device. * properties has changed and @device represent the new modified version of @changed_device.
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.16 * Since: 1.16
*/ */
@ -2732,9 +2733,9 @@ gst_message_new_device_changed (GstObject * src, GstDevice * device,
/** /**
* gst_message_parse_device_changed: * gst_message_parse_device_changed:
* @message: a #GstMessage of type %GST_MESSAGE_DEVICE_CHANGED * @message: a #GstMessage of type %GST_MESSAGE_DEVICE_CHANGED
* @device: (out) (allow-none) (transfer full): A location where to store a * @device: (out) (optional) (transfer full): A location where to store a
* pointer to the updated version of the #GstDevice, or %NULL * pointer to the updated version of the #GstDevice, or %NULL
* @changed_device: (out) (allow-none) (transfer full): A location where to store a * @changed_device: (out) (optional) (transfer full): A location where to store a
* pointer to the old version of the #GstDevice, or %NULL * pointer to the old version of the #GstDevice, or %NULL
* *
* Parses a device-changed message. The device-changed message is produced by * Parses a device-changed message. The device-changed message is produced by
@ -2762,11 +2763,11 @@ gst_message_parse_device_changed (GstMessage * message, GstDevice ** device,
/** /**
* gst_message_new_property_notify: * gst_message_new_property_notify:
* @src: The #GstObject whose property changed (may or may not be a #GstElement) * @src: (transfer none): The #GstObject whose property changed (may or may not be a #GstElement)
* @property_name: name of the property that changed * @property_name: name of the property that changed
* @val: (allow-none) (transfer full): new property value, or %NULL * @val: (nullable) (transfer full): new property value, or %NULL
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -2777,6 +2778,7 @@ gst_message_new_property_notify (GstObject * src, const gchar * property_name,
GstStructure *structure; GstStructure *structure;
GValue name_val = G_VALUE_INIT; GValue name_val = G_VALUE_INIT;
g_return_val_if_fail (GST_IS_OBJECT (src), NULL);
g_return_val_if_fail (property_name != NULL, NULL); g_return_val_if_fail (property_name != NULL, NULL);
structure = gst_structure_new_id_empty (GST_QUARK (MESSAGE_PROPERTY_NOTIFY)); structure = gst_structure_new_id_empty (GST_QUARK (MESSAGE_PROPERTY_NOTIFY));
@ -2793,11 +2795,11 @@ gst_message_new_property_notify (GstObject * src, const gchar * property_name,
/** /**
* gst_message_parse_property_notify: * gst_message_parse_property_notify:
* @message: a #GstMessage of type %GST_MESSAGE_PROPERTY_NOTIFY * @message: a #GstMessage of type %GST_MESSAGE_PROPERTY_NOTIFY
* @object: (out) (allow-none) (transfer none): location where to store a * @object: (out) (optional) (transfer none): location where to store a
* pointer to the object whose property got changed, or %NULL * pointer to the object whose property got changed, or %NULL
* @property_name: (out) (transfer none) (allow-none): return location for * @property_name: (out) (transfer none) (optional): return location for
* the name of the property that got changed, or %NULL * the name of the property that got changed, or %NULL
* @property_value: (out) (transfer none) (allow-none): return location for * @property_value: (out) (transfer none) (optional) (nullable): return location for
* the new value of the property that got changed, or %NULL. This will * the new value of the property that got changed, or %NULL. This will
* only be set if the property notify watch was told to include the value * only be set if the property notify watch was told to include the value
* when it was set up * when it was set up
@ -2834,13 +2836,13 @@ gst_message_parse_property_notify (GstMessage * message, GstObject ** object,
/** /**
* gst_message_new_stream_collection: * gst_message_new_stream_collection:
* @src: The #GstObject that created the message * @src: (transfer none) (nullable): The #GstObject that created the message
* @collection: (transfer none): The #GstStreamCollection * @collection: (transfer none): The #GstStreamCollection
* *
* Creates a new stream-collection message. The message is used to announce new * Creates a new stream-collection message. The message is used to announce new
* #GstStreamCollection * #GstStreamCollection
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -2866,7 +2868,7 @@ gst_message_new_stream_collection (GstObject * src,
/** /**
* gst_message_parse_stream_collection: * gst_message_parse_stream_collection:
* @message: a #GstMessage of type %GST_MESSAGE_STREAM_COLLECTION * @message: a #GstMessage of type %GST_MESSAGE_STREAM_COLLECTION
* @collection: (out) (allow-none) (transfer full): A location where to store a * @collection: (out) (optional) (transfer full): A location where to store a
* pointer to the #GstStreamCollection, or %NULL * pointer to the #GstStreamCollection, or %NULL
* *
* Parses a stream-collection message. * Parses a stream-collection message.
@ -2888,7 +2890,7 @@ gst_message_parse_stream_collection (GstMessage * message,
/** /**
* gst_message_new_streams_selected: * gst_message_new_streams_selected:
* @src: The #GstObject that created the message * @src: (transfer none) (nullable): The #GstObject that created the message
* @collection: (transfer none): The #GstStreamCollection * @collection: (transfer none): The #GstStreamCollection
* *
* Creates a new steams-selected message. The message is used to announce * Creates a new steams-selected message. The message is used to announce
@ -2902,7 +2904,7 @@ gst_message_parse_stream_collection (GstMessage * message,
* Users of gst_message_new_streams_selected() can add the selected streams with * Users of gst_message_new_streams_selected() can add the selected streams with
* gst_message_streams_selected_add(). * gst_message_streams_selected_add().
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -3014,7 +3016,7 @@ gst_message_streams_selected_get_stream (GstMessage * msg, guint idx)
/** /**
* gst_message_parse_streams_selected: * gst_message_parse_streams_selected:
* @message: a #GstMessage of type %GST_MESSAGE_STREAMS_SELECTED * @message: a #GstMessage of type %GST_MESSAGE_STREAMS_SELECTED
* @collection: (out) (allow-none) (transfer full): A location where to store a * @collection: (out) (optional) (transfer full): A location where to store a
* pointer to the #GstStreamCollection, or %NULL * pointer to the #GstStreamCollection, or %NULL
* *
* Parses a streams-selected message. * Parses a streams-selected message.
@ -3035,10 +3037,10 @@ gst_message_parse_streams_selected (GstMessage * message,
/** /**
* gst_message_new_redirect: * gst_message_new_redirect:
* @src: The #GstObject whose property changed (may or may not be a #GstElement) * @src: (transfer none) (nullable): The #GstObject whose property changed (may or may not be a #GstElement)
* @location: (transfer none): location string for the new entry * @location: (transfer none): location string for the new entry
* @tag_list: (transfer full) (allow-none): tag list for the new entry * @tag_list: (transfer full) (nullable): tag list for the new entry
* @entry_struct: (transfer full) (allow-none): structure for the new entry * @entry_struct: (transfer full) (nullable): structure for the new entry
* *
* Creates a new redirect message and adds a new entry to it. Redirect messages * Creates a new redirect message and adds a new entry to it. Redirect messages
* are posted when an element detects that the actual data has to be retrieved * are posted when an element detects that the actual data has to be retrieved
@ -3066,7 +3068,7 @@ gst_message_parse_streams_selected (GstMessage * message,
* The specified location string is copied. However, ownership over the tag * The specified location string is copied. However, ownership over the tag
* list and structure are transferred to the message. * list and structure are transferred to the message.
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.10 * Since: 1.10
*/ */
@ -3106,8 +3108,8 @@ gst_message_new_redirect (GstObject * src, const gchar * location,
* gst_message_add_redirect_entry: * gst_message_add_redirect_entry:
* @message: a #GstMessage of type %GST_MESSAGE_REDIRECT * @message: a #GstMessage of type %GST_MESSAGE_REDIRECT
* @location: (transfer none): location string for the new entry * @location: (transfer none): location string for the new entry
* @tag_list: (transfer full) (allow-none): tag list for the new entry * @tag_list: (transfer full) (nullable): tag list for the new entry
* @entry_struct: (transfer full) (allow-none): structure for the new entry * @entry_struct: (transfer full) (nullable): structure for the new entry
* *
* Creates and appends a new entry. * Creates and appends a new entry.
* *
@ -3165,11 +3167,11 @@ gst_message_add_redirect_entry (GstMessage * message, const gchar * location,
* gst_message_parse_redirect_entry: * gst_message_parse_redirect_entry:
* @message: a #GstMessage of type %GST_MESSAGE_REDIRECT * @message: a #GstMessage of type %GST_MESSAGE_REDIRECT
* @entry_index: index of the entry to parse * @entry_index: index of the entry to parse
* @location: (out) (transfer none) (allow-none): return location for * @location: (out) (transfer none) (optional): return location for
* the pointer to the entry's location string, or %NULL * the pointer to the entry's location string, or %NULL
* @tag_list: (out) (transfer none) (allow-none): return location for * @tag_list: (out) (transfer none) (optional) (nullable): return location for
* the pointer to the entry's tag list, or %NULL * the pointer to the entry's tag list, or %NULL
* @entry_struct: (out) (transfer none) (allow-none): return location * @entry_struct: (out) (transfer none) (optional) (nullable): return location
* for the pointer to the entry's structure, or %NULL * for the pointer to the entry's structure, or %NULL
* *
* Parses the location and/or structure from the entry with the given index. * Parses the location and/or structure from the entry with the given index.
@ -3275,7 +3277,7 @@ gst_message_get_num_redirect_entries (GstMessage * message)
/** /**
* gst_message_new_instant_rate_request: * gst_message_new_instant_rate_request:
* @src: The #GstObject that posted the message * @src: (transfer none) (nullable): The #GstObject that posted the message
* @rate_multiplier: the rate multiplier factor that should be applied * @rate_multiplier: the rate multiplier factor that should be applied
* *
* Creates a new instant-rate-request message. Elements handling the * Creates a new instant-rate-request message. Elements handling the
@ -3285,7 +3287,7 @@ gst_message_get_num_redirect_entries (GstMessage * message)
* @GST_EVENT_INSTANT_RATE_SYNC_TIME event to notify the elements * @GST_EVENT_INSTANT_RATE_SYNC_TIME event to notify the elements
* in the pipeline. * in the pipeline.
* *
* Returns: a newly allocated #GstMessage * Returns: (transfer full): a newly allocated #GstMessage
* *
* Since: 1.18 * Since: 1.18
*/ */
@ -3308,7 +3310,7 @@ gst_message_new_instant_rate_request (GstObject * src, gdouble rate_multiplier)
/** /**
* gst_message_parse_instant_rate_request: * gst_message_parse_instant_rate_request:
* @message: a #GstMessage of type %GST_MESSAGE_INSTANT_RATE_REQUEST * @message: a #GstMessage of type %GST_MESSAGE_INSTANT_RATE_REQUEST
* @rate_multiplier: (out) (allow-none): return location for the rate, or %NULL * @rate_multiplier: (out) (optional): return location for the rate, or %NULL
* *
* Parses the rate_multiplier from the instant-rate-request message. * Parses the rate_multiplier from the instant-rate-request message.
* *
@ -3397,7 +3399,7 @@ gst_message_copy (const GstMessage * msg)
* gst_message_replace: (skip) * gst_message_replace: (skip)
* @old_message: (inout) (transfer full) (nullable): pointer to a * @old_message: (inout) (transfer full) (nullable): pointer to a
* pointer to a #GstMessage to be replaced. * pointer to a #GstMessage to be replaced.
* @new_message: (allow-none) (transfer none): pointer to a #GstMessage that will * @new_message: (nullable) (transfer none): pointer to a #GstMessage that will
* replace the message pointed to by @old_message. * replace the message pointed to by @old_message.
* *
* Modifies a pointer to a #GstMessage to point to a different #GstMessage. The * Modifies a pointer to a #GstMessage to point to a different #GstMessage. The
@ -3420,7 +3422,7 @@ gst_message_replace (GstMessage ** old_message, GstMessage * new_message)
* gst_message_take: * gst_message_take:
* @old_message: (inout) (transfer full): pointer to a pointer to a #GstMessage * @old_message: (inout) (transfer full): pointer to a pointer to a #GstMessage
* to be replaced. * to be replaced.
* @new_message: (transfer full) (allow-none): pointer to a #GstMessage that * @new_message: (transfer full) (nullable): pointer to a #GstMessage that
* will replace the message pointed to by @old_message. * will replace the message pointed to by @old_message.
* *
* Modifies a pointer to a #GstMessage to point to a different #GstMessage. This * Modifies a pointer to a #GstMessage to point to a different #GstMessage. This

8
subprojects/gstreamer/gst/gstobject.c
View file

@ -324,7 +324,7 @@ gst_clear_object (GstObject ** object_ptr)
* gst_object_replace: * gst_object_replace:
* @oldobj: (inout) (transfer full) (nullable): pointer to a place of * @oldobj: (inout) (transfer full) (nullable): pointer to a place of
* a #GstObject to replace * a #GstObject to replace
* @newobj: (transfer none) (allow-none): a new #GstObject * @newobj: (transfer none) (nullable): a new #GstObject
* *
* Atomically modifies a pointer to point to a new object. * Atomically modifies a pointer to point to a new object.
* The reference count of @oldobj is decreased and the reference count of * The reference count of @oldobj is decreased and the reference count of
@ -630,7 +630,7 @@ had_parent:
/** /**
* gst_object_set_name: * gst_object_set_name:
* @object: a #GstObject * @object: a #GstObject
* @name: (allow-none): new name of object * @name: (nullable): new name of object
* *
* Sets the name of @object, or gives @object a guaranteed unique * Sets the name of @object, or gives @object a guaranteed unique
* name (if @name is %NULL). * name (if @name is %NULL).
@ -1342,7 +1342,7 @@ gst_object_remove_control_binding (GstObject * object,
* *
* Gets the value for the given controlled property at the requested time. * Gets the value for the given controlled property at the requested time.
* *
* Returns: (nullable): the GValue of the property at the given time, * Returns: (transfer full) (nullable): the GValue of the property at the given time,
* or %NULL if the property isn't controlled. * or %NULL if the property isn't controlled.
*/ */
GValue * GValue *
@ -1372,7 +1372,7 @@ gst_object_get_value (GstObject * object, const gchar * property_name,
* @timestamp: the time that should be processed * @timestamp: the time that should be processed
* @interval: the time spacing between subsequent values * @interval: the time spacing between subsequent values
* @n_values: the number of values * @n_values: the number of values
* @values: array to put control-values in * @values: (array length=n_values): array to put control-values in
* *
* Gets a number of values for the given controlled property starting at the * Gets a number of values for the given controlled property starting at the
* requested time. The array @values need to hold enough space for @n_values of * requested time. The array @values need to hold enough space for @n_values of

4
subprojects/gstreamer/gst/gstparse.c
View file

@ -230,7 +230,7 @@ gst_parse_launchv (const gchar ** argv, GError ** error)
/** /**
* gst_parse_launchv_full: * gst_parse_launchv_full:
* @argv: (in) (array zero-terminated=1): null-terminated array of arguments * @argv: (in) (array zero-terminated=1): null-terminated array of arguments
* @context: (allow-none): a parse context allocated with * @context: (nullable): a parse context allocated with
* gst_parse_context_new(), or %NULL * gst_parse_context_new(), or %NULL
* @flags: parsing options, or #GST_PARSE_FLAG_NONE * @flags: parsing options, or #GST_PARSE_FLAG_NONE
* @error: pointer to a #GError (which must be initialised to %NULL) * @error: pointer to a #GError (which must be initialised to %NULL)
@ -311,7 +311,7 @@ gst_parse_launch (const gchar * pipeline_description, GError ** error)
/** /**
* gst_parse_launch_full: * gst_parse_launch_full:
* @pipeline_description: the command line describing the pipeline * @pipeline_description: the command line describing the pipeline
* @context: (allow-none): a parse context allocated with * @context: (nullable): a parse context allocated with
* gst_parse_context_new(), or %NULL * gst_parse_context_new(), or %NULL
* @flags: parsing options, or #GST_PARSE_FLAG_NONE * @flags: parsing options, or #GST_PARSE_FLAG_NONE
* @error: the error message in case of an erroneous pipeline. * @error: the error message in case of an erroneous pipeline.

4
subprojects/gstreamer/gst/gstpipeline.c
View file

@ -334,7 +334,7 @@ reset_start_time (GstPipeline * pipeline, GstClockTime start_time)
/** /**
* gst_pipeline_new: * gst_pipeline_new:
* @name: (allow-none): name of new pipeline * @name: (nullable): name of new pipeline
* *
* Create a new pipeline with the given name. * Create a new pipeline with the given name.
* *
@ -867,7 +867,7 @@ gst_pipeline_use_clock (GstPipeline * pipeline, GstClock * clock)
/** /**
* gst_pipeline_set_clock: (skip) * gst_pipeline_set_clock: (skip)
* @pipeline: a #GstPipeline * @pipeline: a #GstPipeline
* @clock: (transfer none): the clock to set * @clock: (transfer none) (nullable): the clock to set
* *
* Set the clock for @pipeline. The clock will be distributed * Set the clock for @pipeline. The clock will be distributed
* to all the elements managed by the pipeline. * to all the elements managed by the pipeline.

142
subprojects/gstreamer/gst/gstquery.c
View file

@ -272,9 +272,9 @@ gst_query_set_position (GstQuery * query, GstFormat format, gint64 cur)
/** /**
* gst_query_parse_position: * gst_query_parse_position:
* @query: a #GstQuery * @query: a #GstQuery
* @format: (out) (allow-none): the storage for the #GstFormat of the * @format: (out) (optional): the storage for the #GstFormat of the
* position values (may be %NULL) * position values (may be %NULL)
* @cur: (out) (allow-none): the storage for the current position (may be %NULL) * @cur: (out) (optional): the storage for the current position (may be %NULL)
* *
* Parse a position query, writing the format into @format, and the position * Parse a position query, writing the format into @format, and the position
* into @cur, if the respective parameters are non-%NULL. * into @cur, if the respective parameters are non-%NULL.
@ -349,9 +349,9 @@ gst_query_set_duration (GstQuery * query, GstFormat format, gint64 duration)
/** /**
* gst_query_parse_duration: * gst_query_parse_duration:
* @query: a #GstQuery * @query: a #GstQuery
* @format: (out) (allow-none): the storage for the #GstFormat of the duration * @format: (out) (optional): the storage for the #GstFormat of the duration
* value, or %NULL. * value, or %NULL.
* @duration: (out) (allow-none): the storage for the total duration, or %NULL. * @duration: (out) (optional): the storage for the total duration, or %NULL.
* *
* Parse a duration query answer. Write the format of the duration into @format, * Parse a duration query answer. Write the format of the duration into @format,
* and the value into @duration, if the respective variables are non-%NULL. * and the value into @duration, if the respective variables are non-%NULL.
@ -430,9 +430,9 @@ gst_query_set_latency (GstQuery * query, gboolean live,
/** /**
* gst_query_parse_latency: * gst_query_parse_latency:
* @query: a #GstQuery * @query: a #GstQuery
* @live: (out) (allow-none): storage for live or %NULL * @live: (out) (optional): storage for live or %NULL
* @min_latency: (out) (allow-none): the storage for the min latency or %NULL * @min_latency: (out) (optional): the storage for the min latency or %NULL
* @max_latency: (out) (allow-none): the storage for the max latency or %NULL * @max_latency: (out) (optional): the storage for the max latency or %NULL
* *
* Parse a latency query answer. * Parse a latency query answer.
*/ */
@ -518,12 +518,12 @@ gst_query_set_convert (GstQuery * query, GstFormat src_format, gint64 src_value,
/** /**
* gst_query_parse_convert: * gst_query_parse_convert:
* @query: a #GstQuery * @query: a #GstQuery
* @src_format: (out) (allow-none): the storage for the #GstFormat of the * @src_format: (out) (optional): the storage for the #GstFormat of the
* source value, or %NULL * source value, or %NULL
* @src_value: (out) (allow-none): the storage for the source value, or %NULL * @src_value: (out) (optional): the storage for the source value, or %NULL
* @dest_format: (out) (allow-none): the storage for the #GstFormat of the * @dest_format: (out) (optional): the storage for the #GstFormat of the
* destination value, or %NULL * destination value, or %NULL
* @dest_value: (out) (allow-none): the storage for the destination value, * @dest_value: (out) (optional): the storage for the destination value,
* or %NULL * or %NULL
* *
* Parse a convert query answer. Any of @src_format, @src_value, @dest_format, * Parse a convert query answer. Any of @src_format, @src_value, @dest_format,
@ -622,11 +622,11 @@ gst_query_set_segment (GstQuery * query, gdouble rate, GstFormat format,
/** /**
* gst_query_parse_segment: * gst_query_parse_segment:
* @query: a #GstQuery * @query: a #GstQuery
* @rate: (out) (allow-none): the storage for the rate of the segment, or %NULL * @rate: (out) (optional): the storage for the rate of the segment, or %NULL
* @format: (out) (allow-none): the storage for the #GstFormat of the values, * @format: (out) (optional): the storage for the #GstFormat of the values,
* or %NULL * or %NULL
* @start_value: (out) (allow-none): the storage for the start value, or %NULL * @start_value: (out) (optional): the storage for the start value, or %NULL
* @stop_value: (out) (allow-none): the storage for the stop value, or %NULL * @stop_value: (out) (optional): the storage for the stop value, or %NULL
* *
* Parse a segment query answer. Any of @rate, @format, @start_value, and * Parse a segment query answer. Any of @rate, @format, @start_value, and
* @stop_value may be %NULL, which will cause this value to be omitted. * @stop_value may be %NULL, which will cause this value to be omitted.
@ -660,14 +660,14 @@ gst_query_parse_segment (GstQuery * query, gdouble * rate, GstFormat * format,
/** /**
* gst_query_new_custom: * gst_query_new_custom:
* @type: the query type * @type: the query type
* @structure: (allow-none) (transfer full): a structure for the query * @structure: (nullable) (transfer full): a structure for the query
* *
* Constructs a new custom query object. Use gst_query_unref() * Constructs a new custom query object. Use gst_query_unref()
* when done with it. * when done with it.
* *
* Free-function: gst_query_unref() * Free-function: gst_query_unref()
* *
* Returns: (transfer full) (nullable): a new #GstQuery * Returns: (transfer full): a new #GstQuery
*/ */
GstQuery * GstQuery *
gst_query_new_custom (GstQueryType type, GstStructure * structure) gst_query_new_custom (GstQueryType type, GstStructure * structure)
@ -810,11 +810,11 @@ gst_query_set_seeking (GstQuery * query, GstFormat format,
/** /**
* gst_query_parse_seeking: * gst_query_parse_seeking:
* @query: a GST_QUERY_SEEKING type query #GstQuery * @query: a GST_QUERY_SEEKING type query #GstQuery
* @format: (out) (allow-none): the format to set for the @segment_start * @format: (out) (optional): the format to set for the @segment_start
* and @segment_end values, or %NULL * and @segment_end values, or %NULL
* @seekable: (out) (allow-none): the seekable flag to set, or %NULL * @seekable: (out) (optional): the seekable flag to set, or %NULL
* @segment_start: (out) (allow-none): the segment_start to set, or %NULL * @segment_start: (out) (optional): the segment_start to set, or %NULL
* @segment_end: (out) (allow-none): the segment_end to set, or %NULL * @segment_end: (out) (optional): the segment_end to set, or %NULL
* *
* Parse a seeking query, writing the format into @format, and * Parse a seeking query, writing the format into @format, and
* other results into the passed parameters, if the respective parameters * other results into the passed parameters, if the respective parameters
@ -971,7 +971,7 @@ gst_query_set_formatsv (GstQuery * query, gint n_formats,
/** /**
* gst_query_parse_n_formats: * gst_query_parse_n_formats:
* @query: a #GstQuery * @query: a #GstQuery
* @n_formats: (out) (allow-none): the number of formats in this query. * @n_formats: (out) (optional): the number of formats in this query.
* *
* Parse the number of formats in the formats @query. * Parse the number of formats in the formats @query.
*/ */
@ -998,7 +998,7 @@ gst_query_parse_n_formats (GstQuery * query, guint * n_formats)
* gst_query_parse_nth_format: * gst_query_parse_nth_format:
* @query: a #GstQuery * @query: a #GstQuery
* @nth: the nth format to retrieve. * @nth: the nth format to retrieve.
* @format: (out) (allow-none): a pointer to store the nth format * @format: (out) (optional): a pointer to store the nth format
* *
* Parse the format query and retrieve the @nth format from it into * Parse the format query and retrieve the @nth format from it into
* @format. If the list contains less elements than @nth, @format will be * @format. If the list contains less elements than @nth, @format will be
@ -1091,8 +1091,8 @@ gst_query_set_buffering_percent (GstQuery * query, gboolean busy, gint percent)
/** /**
* gst_query_parse_buffering_percent: * gst_query_parse_buffering_percent:
* @query: A valid #GstQuery of type GST_QUERY_BUFFERING. * @query: A valid #GstQuery of type GST_QUERY_BUFFERING.
* @busy: (out) (allow-none): if buffering is busy, or %NULL * @busy: (out) (optional): if buffering is busy, or %NULL
* @percent: (out) (allow-none): a buffering percent, or %NULL * @percent: (out) (optional): a buffering percent, or %NULL
* *
* Get the percentage of buffered data. This is a value between 0 and 100. * Get the percentage of buffered data. This is a value between 0 and 100.
* The @busy indicator is %TRUE when the buffering is in progress. * The @busy indicator is %TRUE when the buffering is in progress.
@ -1144,10 +1144,10 @@ gst_query_set_buffering_stats (GstQuery * query, GstBufferingMode mode,
/** /**
* gst_query_parse_buffering_stats: * gst_query_parse_buffering_stats:
* @query: A valid #GstQuery of type GST_QUERY_BUFFERING. * @query: A valid #GstQuery of type GST_QUERY_BUFFERING.
* @mode: (out) (allow-none): a buffering mode, or %NULL * @mode: (out) (optional): a buffering mode, or %NULL
* @avg_in: (out) (allow-none): the average input rate, or %NULL * @avg_in: (out) (optional): the average input rate, or %NULL
* @avg_out: (out) (allow-none): the average output rat, or %NULL * @avg_out: (out) (optional): the average output rat, or %NULL
* @buffering_left: (out) (allow-none): amount of buffering time left in * @buffering_left: (out) (optional): amount of buffering time left in
* milliseconds, or %NULL * milliseconds, or %NULL
* *
* Extracts the buffering stats values from @query. * Extracts the buffering stats values from @query.
@ -1209,11 +1209,11 @@ gst_query_set_buffering_range (GstQuery * query, GstFormat format,
/** /**
* gst_query_parse_buffering_range: * gst_query_parse_buffering_range:
* @query: a GST_QUERY_BUFFERING type query #GstQuery * @query: a GST_QUERY_BUFFERING type query #GstQuery
* @format: (out) (allow-none): the format to set for the @segment_start * @format: (out) (optional): the format to set for the @segment_start
* and @segment_end values, or %NULL * and @segment_end values, or %NULL
* @start: (out) (allow-none): the start to set, or %NULL * @start: (out) (optional): the start to set, or %NULL
* @stop: (out) (allow-none): the stop to set, or %NULL * @stop: (out) (optional): the stop to set, or %NULL
* @estimated_total: (out) (allow-none): estimated total amount of download * @estimated_total: (out) (optional): estimated total amount of download
* time remaining in milliseconds, or %NULL * time remaining in milliseconds, or %NULL
* *
* Parse an available query, writing the format into @format, and * Parse an available query, writing the format into @format, and
@ -1325,8 +1325,8 @@ gst_query_get_n_buffering_ranges (GstQuery * query)
* gst_query_parse_nth_buffering_range: * gst_query_parse_nth_buffering_range:
* @query: a GST_QUERY_BUFFERING type query #GstQuery * @query: a GST_QUERY_BUFFERING type query #GstQuery
* @index: position in the buffered-ranges array to read * @index: position in the buffered-ranges array to read
* @start: (out) (allow-none): the start position to set, or %NULL * @start: (out) (optional): the start position to set, or %NULL
* @stop: (out) (allow-none): the stop position to set, or %NULL * @stop: (out) (optional): the stop position to set, or %NULL
* *
* Parse an available query and get the start and stop values stored * Parse an available query and get the start and stop values stored
* at the @index of the buffered ranges array. * at the @index of the buffered ranges array.
@ -1388,7 +1388,7 @@ gst_query_new_uri (void)
/** /**
* gst_query_set_uri: * gst_query_set_uri:
* @query: a #GstQuery with query type GST_QUERY_URI * @query: a #GstQuery with query type GST_QUERY_URI
* @uri: the URI to set * @uri: (nullable): the URI to set
* *
* Answer a URI query by setting the requested URI. * Answer a URI query by setting the requested URI.
*/ */
@ -1408,7 +1408,7 @@ gst_query_set_uri (GstQuery * query, const gchar * uri)
/** /**
* gst_query_parse_uri: * gst_query_parse_uri:
* @query: a #GstQuery * @query: a #GstQuery
* @uri: (out) (transfer full) (allow-none): the storage for the current URI * @uri: (out) (transfer full) (optional) (nullable): the storage for the current URI
* (may be %NULL) * (may be %NULL)
* *
* Parse an URI query, writing the URI into @uri as a newly * Parse an URI query, writing the URI into @uri as a newly
@ -1431,7 +1431,7 @@ gst_query_parse_uri (GstQuery * query, gchar ** uri)
/** /**
* gst_query_set_uri_redirection: * gst_query_set_uri_redirection:
* @query: a #GstQuery with query type GST_QUERY_URI * @query: a #GstQuery with query type GST_QUERY_URI
* @uri: the URI to set * @uri: (nullable): the URI to set
* *
* Answer a URI query by setting the requested URI redirection. * Answer a URI query by setting the requested URI redirection.
* *
@ -1454,7 +1454,7 @@ gst_query_set_uri_redirection (GstQuery * query, const gchar * uri)
/** /**
* gst_query_parse_uri_redirection: * gst_query_parse_uri_redirection:
* @query: a #GstQuery * @query: a #GstQuery
* @uri: (out) (transfer full) (allow-none): the storage for the redirect URI * @uri: (out) (transfer full) (optional) (nullable): the storage for the redirect URI
* (may be %NULL) * (may be %NULL)
* *
* Parse an URI query, writing the URI into @uri as a newly * Parse an URI query, writing the URI into @uri as a newly
@ -1504,7 +1504,7 @@ gst_query_set_uri_redirection_permanent (GstQuery * query, gboolean permanent)
/** /**
* gst_query_parse_uri_redirection_permanent: * gst_query_parse_uri_redirection_permanent:
* @query: a #GstQuery * @query: a #GstQuery
* @permanent: (out) (allow-none): if the URI redirection is permanent * @permanent: (out) (optional): if the URI redirection is permanent
* (may be %NULL) * (may be %NULL)
* *
* Parse an URI query, and set @permanent to %TRUE if there is a redirection * Parse an URI query, and set @permanent to %TRUE if there is a redirection
@ -1559,8 +1559,8 @@ gst_query_new_allocation (GstCaps * caps, gboolean need_pool)
/** /**
* gst_query_parse_allocation: * gst_query_parse_allocation:
* @query: a #GstQuery * @query: a #GstQuery
* @caps: (out) (transfer none) (allow-none): The #GstCaps * @caps: (out) (transfer none) (optional): The #GstCaps
* @need_pool: (out) (allow-none): Whether a #GstBufferPool is needed * @need_pool: (out) (optional): Whether a #GstBufferPool is needed
* *
* Parse an allocation query, writing the requested caps in @caps and * Parse an allocation query, writing the requested caps in @caps and
* whether a pool is needed in @need_pool, if the respective parameters * whether a pool is needed in @need_pool, if the respective parameters
@ -1604,7 +1604,7 @@ allocation_pool_free (AllocationPool * ap)
/** /**
* gst_query_add_allocation_pool: * gst_query_add_allocation_pool:
* @query: A valid #GstQuery of type GST_QUERY_ALLOCATION. * @query: A valid #GstQuery of type GST_QUERY_ALLOCATION.
* @pool: (transfer none) (allow-none): the #GstBufferPool * @pool: (transfer none) (nullable): the #GstBufferPool
* @size: the buffer size * @size: the buffer size
* @min_buffers: the min buffers * @min_buffers: the min buffers
* @max_buffers: the max buffers * @max_buffers: the max buffers
@ -1663,10 +1663,10 @@ gst_query_get_n_allocation_pools (GstQuery * query)
* gst_query_parse_nth_allocation_pool: * gst_query_parse_nth_allocation_pool:
* @query: A valid #GstQuery of type GST_QUERY_ALLOCATION. * @query: A valid #GstQuery of type GST_QUERY_ALLOCATION.
* @index: index to parse * @index: index to parse
* @pool: (out) (allow-none) (transfer full): the #GstBufferPool * @pool: (out) (optional) (transfer full) (nullable): the #GstBufferPool
* @size: (out) (allow-none): the buffer size * @size: (out) (optional): the buffer size
* @min_buffers: (out) (allow-none): the min buffers * @min_buffers: (out) (optional): the min buffers
* @max_buffers: (out) (allow-none): the max buffers * @max_buffers: (out) (optional): the max buffers
* *
* Get the pool parameters in @query. * Get the pool parameters in @query.
* *
@ -1705,7 +1705,7 @@ gst_query_parse_nth_allocation_pool (GstQuery * query, guint index,
* gst_query_set_nth_allocation_pool: * gst_query_set_nth_allocation_pool:
* @index: index to modify * @index: index to modify
* @query: A valid #GstQuery of type GST_QUERY_ALLOCATION. * @query: A valid #GstQuery of type GST_QUERY_ALLOCATION.
* @pool: (transfer none) (allow-none): the #GstBufferPool * @pool: (transfer none) (nullable): the #GstBufferPool
* @size: the buffer size * @size: the buffer size
* @min_buffers: the min buffers * @min_buffers: the min buffers
* @max_buffers: the max buffers * @max_buffers: the max buffers
@ -1782,7 +1782,7 @@ allocation_meta_free (AllocationMeta * am)
* gst_query_add_allocation_meta: * gst_query_add_allocation_meta:
* @query: a GST_QUERY_ALLOCATION type query #GstQuery * @query: a GST_QUERY_ALLOCATION type query #GstQuery
* @api: the metadata API * @api: the metadata API
* @params: (transfer none) (allow-none): API specific parameters * @params: (transfer none) (nullable): API specific parameters
* *
* Add @api with @params as one of the supported metadata API to @query. * Add @api with @params as one of the supported metadata API to @query.
*/ */
@ -1838,7 +1838,7 @@ gst_query_get_n_allocation_metas (GstQuery * query)
* gst_query_parse_nth_allocation_meta: * gst_query_parse_nth_allocation_meta:
* @query: a GST_QUERY_ALLOCATION type query #GstQuery * @query: a GST_QUERY_ALLOCATION type query #GstQuery
* @index: position in the metadata API array to read * @index: position in the metadata API array to read
* @params: (out) (transfer none) (allow-none): API specific parameters * @params: (out) (transfer none) (optional): API specific parameters
* *
* Parse an available query and get the metadata API * Parse an available query and get the metadata API
* at @index of the metadata API array. * at @index of the metadata API array.
@ -1899,7 +1899,7 @@ gst_query_remove_nth_allocation_meta (GstQuery * query, guint index)
* gst_query_find_allocation_meta: * gst_query_find_allocation_meta:
* @query: a GST_QUERY_ALLOCATION type query #GstQuery * @query: a GST_QUERY_ALLOCATION type query #GstQuery
* @api: the metadata API * @api: the metadata API
* @index: (out) (transfer none) (allow-none): the index * @index: (out) (transfer none) (optional): the index
* *
* Check if @query has metadata @api set. When this function returns %TRUE, * Check if @query has metadata @api set. When this function returns %TRUE,
* @index will contain the index where the requested API and the parameters * @index will contain the index where the requested API and the parameters
@ -1950,8 +1950,8 @@ allocation_param_free (AllocationParam * ap)
/** /**
* gst_query_add_allocation_param: * gst_query_add_allocation_param:
* @query: a GST_QUERY_ALLOCATION type query #GstQuery * @query: a GST_QUERY_ALLOCATION type query #GstQuery
* @allocator: (transfer none) (allow-none): the memory allocator * @allocator: (transfer none) (nullable): the memory allocator
* @params: (transfer none) (allow-none): a #GstAllocationParams * @params: (transfer none) (nullable): a #GstAllocationParams
* *
* Add @allocator and its @params as a supported memory allocator. * Add @allocator and its @params as a supported memory allocator.
*/ */
@ -2014,8 +2014,8 @@ gst_query_get_n_allocation_params (GstQuery * query)
* gst_query_parse_nth_allocation_param: * gst_query_parse_nth_allocation_param:
* @query: a GST_QUERY_ALLOCATION type query #GstQuery * @query: a GST_QUERY_ALLOCATION type query #GstQuery
* @index: position in the allocator array to read * @index: position in the allocator array to read
* @allocator: (out) (transfer full) (allow-none): variable to hold the result * @allocator: (out) (transfer full) (optional) (nullable): variable to hold the result
* @params: (out) (allow-none): parameters for the allocator * @params: (out) (optional): parameters for the allocator
* *
* Parse an available query and get the allocator and its params * Parse an available query and get the allocator and its params
* at @index of the allocator array. * at @index of the allocator array.
@ -2048,8 +2048,8 @@ gst_query_parse_nth_allocation_param (GstQuery * query, guint index,
* gst_query_set_nth_allocation_param: * gst_query_set_nth_allocation_param:
* @query: a GST_QUERY_ALLOCATION type query #GstQuery * @query: a GST_QUERY_ALLOCATION type query #GstQuery
* @index: position in the allocator array to set * @index: position in the allocator array to set
* @allocator: (transfer none) (allow-none): new allocator to set * @allocator: (transfer none) (nullable): new allocator to set
* @params: (transfer none) (allow-none): parameters for the allocator * @params: (transfer none) (nullable): parameters for the allocator
* *
* Parse an available query and get the allocator and its params * Parse an available query and get the allocator and its params
* at @index of the allocator array. * at @index of the allocator array.
@ -2164,10 +2164,10 @@ gst_query_set_scheduling (GstQuery * query, GstSchedulingFlags flags,
/** /**
* gst_query_parse_scheduling: * gst_query_parse_scheduling:
* @query: A valid #GstQuery of type GST_QUERY_SCHEDULING. * @query: A valid #GstQuery of type GST_QUERY_SCHEDULING.
* @flags: (out) (allow-none): #GstSchedulingFlags * @flags: (out) (optional): #GstSchedulingFlags
* @minsize: (out) (allow-none): the suggested minimum size of pull requests * @minsize: (out) (optional): the suggested minimum size of pull requests
* @maxsize: (out) (allow-none): the suggested maximum size of pull requests: * @maxsize: (out) (optional): the suggested maximum size of pull requests:
* @align: (out) (allow-none): the suggested alignment of pull requests * @align: (out) (optional): the suggested alignment of pull requests
* *
* Set the scheduling properties. * Set the scheduling properties.
*/ */
@ -2393,7 +2393,7 @@ gst_query_set_accept_caps_result (GstQuery * query, gboolean result)
/** /**
* gst_query_parse_accept_caps_result: * gst_query_parse_accept_caps_result:
* @query: a GST_QUERY_ACCEPT_CAPS type query #GstQuery * @query: a GST_QUERY_ACCEPT_CAPS type query #GstQuery
* @result: (out) (allow-none): location for the result * @result: (out) (nullable): location for the result
* *
* Parse the result from @query and store in @result. * Parse the result from @query and store in @result.
*/ */
@ -2474,7 +2474,7 @@ gst_query_parse_caps (GstQuery * query, GstCaps ** filter)
/** /**
* gst_query_set_caps_result: * gst_query_set_caps_result:
* @query: The query to use * @query: The query to use
* @caps: (in): A pointer to the caps * @caps: (nullable): A pointer to the caps
* *
* Set the @caps result in @query. * Set the @caps result in @query.
*/ */
@ -2493,7 +2493,7 @@ gst_query_set_caps_result (GstQuery * query, GstCaps * caps)
/** /**
* gst_query_parse_caps_result: * gst_query_parse_caps_result:
* @query: The query to parse * @query: The query to parse
* @caps: (out) (transfer none): A pointer to the caps * @caps: (out) (transfer none) (nullable): A pointer to the caps
* *
* Get the caps result from @query. The caps remains valid as long as * Get the caps result from @query. The caps remains valid as long as
* @query remains valid. * @query remains valid.
@ -2576,7 +2576,7 @@ gst_query_new_context (const gchar * context_type)
/** /**
* gst_query_set_context: * gst_query_set_context:
* @query: a #GstQuery with query type GST_QUERY_CONTEXT * @query: a #GstQuery with query type GST_QUERY_CONTEXT
* @context: the requested #GstContext * @context: (nullable): the requested #GstContext
* *
* Answer a context query by setting the requested context. * Answer a context query by setting the requested context.
* *
@ -2603,7 +2603,7 @@ gst_query_set_context (GstQuery * query, GstContext * context)
/** /**
* gst_query_parse_context: * gst_query_parse_context:
* @query: The query to parse * @query: The query to parse
* @context: (out) (transfer none): A pointer to store the #GstContext * @context: (out) (transfer none) (nullable): A pointer to store the #GstContext
* *
* Get the context from the context @query. The context remains valid as long as * Get the context from the context @query. The context remains valid as long as
* @query remains valid. * @query remains valid.
@ -2630,7 +2630,7 @@ gst_query_parse_context (GstQuery * query, GstContext ** context)
/** /**
* gst_query_parse_context_type: * gst_query_parse_context_type:
* @query: a GST_QUERY_CONTEXT type query * @query: a GST_QUERY_CONTEXT type query
* @context_type: (out) (transfer none) (allow-none): the context type, or %NULL * @context_type: (out) (transfer none) (optional): the context type, or %NULL
* *
* Parse a context type from an existing GST_QUERY_CONTEXT query. * Parse a context type from an existing GST_QUERY_CONTEXT query.
* *
@ -2706,7 +2706,7 @@ gst_query_set_bitrate (GstQuery * query, guint nominal_bitrate)
/** /**
* gst_query_parse_bitrate: * gst_query_parse_bitrate:
* @query: a GST_QUERY_BITRATE type #GstQuery * @query: a GST_QUERY_BITRATE type #GstQuery
* @nominal_bitrate: (out) (allow-none): The resulting bitrate in bits per second * @nominal_bitrate: (out) (optional): The resulting bitrate in bits per second
* *
* Get the results of a bitrate query. See also gst_query_set_bitrate(). * Get the results of a bitrate query. See also gst_query_set_bitrate().
* *
@ -2777,7 +2777,7 @@ gst_query_set_selectable (GstQuery * query, gboolean selectable)
/** /**
* gst_query_parse_selectable: * gst_query_parse_selectable:
* @query: a GST_QUERY_SELECTABLE type #GstQuery * @query: a GST_QUERY_SELECTABLE type #GstQuery
* @selectable: (out) (allow-none): The resulting stream selection capability * @selectable: (out) (optional): The resulting stream selection capability
* *
* Get the results of a selectable query. See also gst_query_set_selectable(). * Get the results of a selectable query. See also gst_query_set_selectable().
* *
@ -2868,7 +2868,7 @@ gst_query_copy (const GstQuery * q)
* gst_query_replace: (skip) * gst_query_replace: (skip)
* @old_query: (inout) (transfer full) (nullable): pointer to a pointer to a * @old_query: (inout) (transfer full) (nullable): pointer to a pointer to a
* #GstQuery to be replaced. * #GstQuery to be replaced.
* @new_query: (allow-none) (transfer none): pointer to a #GstQuery that will * @new_query: (nullable) (transfer none): pointer to a #GstQuery that will
* replace the query pointed to by @old_query. * replace the query pointed to by @old_query.
* *
* Modifies a pointer to a #GstQuery to point to a different #GstQuery. The * Modifies a pointer to a #GstQuery to point to a different #GstQuery. The
@ -2891,7 +2891,7 @@ gst_query_replace (GstQuery ** old_query, GstQuery * new_query)
* gst_query_take: * gst_query_take:
* @old_query: (inout) (transfer full) (nullable): pointer to a * @old_query: (inout) (transfer full) (nullable): pointer to a
* pointer to a #GstQuery to be stolen. * pointer to a #GstQuery to be stolen.
* @new_query: (allow-none) (transfer full): pointer to a #GstQuery that will * @new_query: (nullable) (transfer full): pointer to a #GstQuery that will
* replace the query pointed to by @old_query. * replace the query pointed to by @old_query.
* *
* Modifies a pointer to a #GstQuery to point to a different #GstQuery. This * Modifies a pointer to a #GstQuery to point to a different #GstQuery. This

10
subprojects/gstreamer/gst/gststructure.c
View file

@ -577,7 +577,7 @@ gst_clear_structure (GstStructure ** structure_ptr)
* gst_structure_take: * gst_structure_take:
* @oldstr_ptr: (inout) (transfer full) (nullable): pointer to a place of * @oldstr_ptr: (inout) (transfer full) (nullable): pointer to a place of
* a #GstStructure to take * a #GstStructure to take
* @newstr: (transfer full) (allow-none): a new #GstStructure * @newstr: (transfer full) (nullable): a new #GstStructure
* *
* Atomically modifies a pointer to point to a new structure. * Atomically modifies a pointer to point to a new structure.
* The #GstStructure @oldstr_ptr is pointing to is freed and * The #GstStructure @oldstr_ptr is pointing to is freed and
@ -1962,8 +1962,8 @@ gst_structure_get_fraction (const GstStructure * structure,
* gst_structure_get_flagset: * gst_structure_get_flagset:
* @structure: a #GstStructure * @structure: a #GstStructure
* @fieldname: the name of a field * @fieldname: the name of a field
* @value_flags: (out) (allow-none): a pointer to a guint for the flags field * @value_flags: (out) (optional): a pointer to a guint for the flags field
* @value_mask: (out) (allow-none): a pointer to a guint for the mask field * @value_mask: (out) (optional): a pointer to a guint for the mask field
* *
* Read the GstFlagSet flags and mask out of the structure into the * Read the GstFlagSet flags and mask out of the structure into the
* provided pointers. * provided pointers.
@ -2390,7 +2390,7 @@ gst_structure_new_from_string (const gchar * string)
/** /**
* gst_structure_from_string: (constructor): * gst_structure_from_string: (constructor):
* @string: a string representation of a #GstStructure. * @string: a string representation of a #GstStructure.
* @end: (out) (allow-none) (transfer none) (skip): pointer to store the end of the string in. * @end: (out) (optional) (transfer none) (skip): pointer to store the end of the string in.
* *
* Creates a #GstStructure from a string representation. * Creates a #GstStructure from a string representation.
* If end is not %NULL, a pointer to the place inside the given string * If end is not %NULL, a pointer to the place inside the given string
@ -3132,7 +3132,7 @@ gst_structure_is_equal (const GstStructure * structure1,
* *
* Intersects @struct1 and @struct2 and returns the intersection. * Intersects @struct1 and @struct2 and returns the intersection.
* *
* Returns: (nullable): Intersection of @struct1 and @struct2 * Returns: (transfer full) (nullable): Intersection of @struct1 and @struct2
*/ */
GstStructure * GstStructure *
gst_structure_intersect (const GstStructure * struct1, gst_structure_intersect (const GstStructure * struct1,

16
subprojects/gstreamer/gst/gsttaglist.c
View file

@ -605,7 +605,7 @@ gst_tag_get_type (const gchar * tag)
* Returns the human-readable name of this tag, You must not change or free * Returns the human-readable name of this tag, You must not change or free
* this string. * this string.
* *
* Returns: (nullable): the human-readable name of this tag * Returns: the human-readable name of this tag
*/ */
const gchar * const gchar *
gst_tag_get_nick (const gchar * tag) gst_tag_get_nick (const gchar * tag)
@ -630,7 +630,7 @@ gst_tag_get_nick (const gchar * tag)
* Returns the human-readable description of this tag, You must not change or * Returns the human-readable description of this tag, You must not change or
* free this string. * free this string.
* *
* Returns: (nullable): the human-readable description of this tag * Returns: the human-readable description of this tag
*/ */
const gchar * const gchar *
gst_tag_get_description (const gchar * tag) gst_tag_get_description (const gchar * tag)
@ -863,8 +863,8 @@ gst_tag_list_get_scope (const GstTagList * list)
* *
* Serializes a tag list to a string. * Serializes a tag list to a string.
* *
* Returns: (nullable): a newly-allocated string, or %NULL in case of * Returns: (transfer full): a newly-allocated string.
* an error. The string must be freed with g_free() when no longer * The string must be freed with g_free() when no longer
* needed. * needed.
*/ */
gchar * gchar *
@ -881,7 +881,7 @@ gst_tag_list_to_string (const GstTagList * list)
* *
* Deserializes a tag list. * Deserializes a tag list.
* *
* Returns: (nullable): a new #GstTagList, or %NULL in case of an * Returns: (transfer full) (nullable): a new #GstTagList, or %NULL in case of an
* error. * error.
*/ */
GstTagList * GstTagList *
@ -1148,8 +1148,8 @@ gst_tag_list_insert (GstTagList * into, const GstTagList * from,
/** /**
* gst_tag_list_merge: * gst_tag_list_merge:
* @list1: (allow-none): first list to merge * @list1: (nullable): first list to merge
* @list2: (allow-none): second list to merge * @list2: (nullable): second list to merge
* @mode: the mode to use * @mode: the mode to use
* *
* Merges the two given lists into a new list. If one of the lists is %NULL, a * Merges the two given lists into a new list. If one of the lists is %NULL, a
@ -2078,7 +2078,7 @@ gst_tag_list_get_sample_index (const GstTagList * list,
* *
* When you are finished with the taglist, call gst_tag_list_unref() on it. * When you are finished with the taglist, call gst_tag_list_unref() on it.
* *
* Returns: the new #GstTagList * Returns: (transfer full): the new #GstTagList
*/ */
GstTagList *(gst_tag_list_copy) (const GstTagList * taglist) GstTagList *(gst_tag_list_copy) (const GstTagList * taglist)
{ {

30
subprojects/gstreamer/gst/gsttoc.c
View file

@ -169,7 +169,7 @@ gst_toc_get_scope (const GstToc * toc)
/** /**
* gst_toc_set_tags: * gst_toc_set_tags:
* @toc: A #GstToc instance * @toc: A #GstToc instance
* @tags: (allow-none) (transfer full): A #GstTagList or %NULL * @tags: (nullable) (transfer full): A #GstTagList or %NULL
* *
* Set a #GstTagList with tags for the complete @toc. * Set a #GstTagList with tags for the complete @toc.
*/ */
@ -187,7 +187,7 @@ gst_toc_set_tags (GstToc * toc, GstTagList * tags)
/** /**
* gst_toc_merge_tags: * gst_toc_merge_tags:
* @toc: A #GstToc instance * @toc: A #GstToc instance
* @tags: (allow-none): A #GstTagList or %NULL * @tags: (nullable): A #GstTagList or %NULL
* @mode: A #GstTagMergeMode * @mode: A #GstTagMergeMode
* *
* Merge @tags into the existing tags of @toc using @mode. * Merge @tags into the existing tags of @toc using @mode.
@ -213,7 +213,7 @@ gst_toc_merge_tags (GstToc * toc, GstTagList * tags, GstTagMergeMode mode)
* *
* Gets the tags for @toc. * Gets the tags for @toc.
* *
* Returns: (transfer none): A #GstTagList for @entry * Returns: (transfer none) (nullable): A #GstTagList for @entry
*/ */
GstTagList * GstTagList *
gst_toc_get_tags (const GstToc * toc) gst_toc_get_tags (const GstToc * toc)
@ -290,7 +290,7 @@ gst_toc_entry_new_internal (GstTocEntryType type, const gchar * uid)
* *
* Create new #GstTocEntry structure. * Create new #GstTocEntry structure.
* *
* Returns: newly allocated #GstTocEntry structure, free it with gst_toc_entry_unref(). * Returns: (transfer full): newly allocated #GstTocEntry structure, free it with gst_toc_entry_unref().
*/ */
GstTocEntry * GstTocEntry *
gst_toc_entry_new (GstTocEntryType type, const gchar * uid) gst_toc_entry_new (GstTocEntryType type, const gchar * uid)
@ -415,8 +415,7 @@ gst_toc_deep_copy_toc_entries (GList * entry_list)
* *
* Copy #GstTocEntry with all subentries (deep copy). * Copy #GstTocEntry with all subentries (deep copy).
* *
* Returns: (nullable): newly allocated #GstTocEntry in case of * Returns: (transfer full): newly allocated #GstTocEntry; free it when done with
* success, %NULL otherwise; free it when done with
* gst_toc_entry_unref(). * gst_toc_entry_unref().
*/ */
static GstTocEntry * static GstTocEntry *
@ -450,8 +449,7 @@ gst_toc_entry_copy (const GstTocEntry * entry)
* *
* Copy #GstToc with all subentries (deep copy). * Copy #GstToc with all subentries (deep copy).
* *
* Returns: (nullable): newly allocated #GstToc in case of success, * Returns: (transfer full): newly allocated #GstToc; free it when done with gst_toc_unref().
* %NULL otherwise; free it when done with gst_toc_unref().
*/ */
static GstToc * static GstToc *
gst_toc_copy (const GstToc * toc) gst_toc_copy (const GstToc * toc)
@ -495,9 +493,9 @@ gst_toc_entry_set_start_stop_times (GstTocEntry * entry, gint64 start,
/** /**
* gst_toc_entry_get_start_stop_times: * gst_toc_entry_get_start_stop_times:
* @entry: #GstTocEntry to get values from. * @entry: #GstTocEntry to get values from.
* @start: (out) (allow-none): the storage for the start value, leave * @start: (out) (optional): the storage for the start value, leave
* %NULL if not need. * %NULL if not need.
* @stop: (out) (allow-none): the storage for the stop value, leave * @stop: (out) (optional): the storage for the stop value, leave
* %NULL if not need. * %NULL if not need.
* *
* Get @start and @stop values from the @entry and write them into appropriate * Get @start and @stop values from the @entry and write them into appropriate
@ -543,9 +541,9 @@ gst_toc_entry_set_loop (GstTocEntry * entry, GstTocLoopType loop_type,
/** /**
* gst_toc_entry_get_loop: * gst_toc_entry_get_loop:
* @entry: #GstTocEntry to get values from. * @entry: #GstTocEntry to get values from.
* @loop_type: (out) (allow-none): the storage for the loop_type * @loop_type: (out) (optional): the storage for the loop_type
* value, leave %NULL if not need. * value, leave %NULL if not need.
* @repeat_count: (out) (allow-none): the storage for the repeat_count * @repeat_count: (out) (optional): the storage for the repeat_count
* value, leave %NULL if not need. * value, leave %NULL if not need.
* *
* Get @loop_type and @repeat_count values from the @entry and write them into * Get @loop_type and @repeat_count values from the @entry and write them into
@ -708,7 +706,7 @@ gst_toc_entry_get_sub_entries (const GstTocEntry * entry)
/** /**
* gst_toc_entry_set_tags: * gst_toc_entry_set_tags:
* @entry: A #GstTocEntry instance * @entry: A #GstTocEntry instance
* @tags: (allow-none) (transfer full): A #GstTagList or %NULL * @tags: (nullable) (transfer full): A #GstTagList or %NULL
* *
* Set a #GstTagList with tags for the complete @entry. * Set a #GstTagList with tags for the complete @entry.
*/ */
@ -726,7 +724,7 @@ gst_toc_entry_set_tags (GstTocEntry * entry, GstTagList * tags)
/** /**
* gst_toc_entry_merge_tags: * gst_toc_entry_merge_tags:
* @entry: A #GstTocEntry instance * @entry: A #GstTocEntry instance
* @tags: (allow-none): A #GstTagList or %NULL * @tags: (nullable): A #GstTagList or %NULL
* @mode: A #GstTagMergeMode * @mode: A #GstTagMergeMode
* *
* Merge @tags into the existing tags of @entry using @mode. * Merge @tags into the existing tags of @entry using @mode.
@ -753,7 +751,7 @@ gst_toc_entry_merge_tags (GstTocEntry * entry, GstTagList * tags,
* *
* Gets the tags for @entry. * Gets the tags for @entry.
* *
* Returns: (transfer none): A #GstTagList for @entry * Returns: (nullable) (transfer none): A #GstTagList for @entry
*/ */
GstTagList * GstTagList *
gst_toc_entry_get_tags (const GstTocEntry * entry) gst_toc_entry_get_tags (const GstTocEntry * entry)
@ -769,7 +767,7 @@ gst_toc_entry_get_tags (const GstTocEntry * entry)
* *
* Gets the parent #GstToc of @entry. * Gets the parent #GstToc of @entry.
* *
* Returns: (transfer none): The parent #GstToc of @entry * Returns: (transfer none) (nullable): The parent #GstToc of @entry
*/ */
GstToc * GstToc *
gst_toc_entry_get_toc (GstTocEntry * entry) gst_toc_entry_get_toc (GstTocEntry * entry)

42
subprojects/gstreamer/gst/gsturi.c
View file

@ -500,8 +500,7 @@ gst_uri_get_location (const gchar * uri)
* *
* Free-function: g_free * Free-function: g_free
* *
* Returns: (transfer full): a new string for this URI. Returns %NULL if the * Returns: (transfer full): a new string for this URI.
* given URI protocol is not valid, or the given location is %NULL.
* *
* Deprecated: Use GstURI instead. * Deprecated: Use GstURI instead.
*/ */
@ -617,8 +616,8 @@ gst_uri_protocol_is_supported (const GstURIType type, const gchar * protocol)
* gst_element_make_from_uri: * gst_element_make_from_uri:
* @type: Whether to create a source or a sink * @type: Whether to create a source or a sink
* @uri: URI to create an element for * @uri: URI to create an element for
* @elementname: (allow-none): Name of created element, can be %NULL. * @elementname: (nullable): Name of created element, can be %NULL.
* @error: (allow-none): address where to store error information, or %NULL. * @error: (optional): address where to store error information, or %NULL.
* *
* Creates an element for handling the given URI. * Creates an element for handling the given URI.
* *
@ -732,7 +731,7 @@ gst_uri_handler_get_uri_type (GstURIHandler * handler)
* Gets the list of protocols supported by @handler. This list may not be * Gets the list of protocols supported by @handler. This list may not be
* modified. * modified.
* *
* Returns: (transfer none) (element-type utf8) (nullable): the * Returns: (transfer none) (element-type utf8) (nullable) (array zero-terminated=1): the
* supported protocols. Returns %NULL if the @handler isn't * supported protocols. Returns %NULL if the @handler isn't
* implemented properly, or the @handler doesn't support any * implemented properly, or the @handler doesn't support any
* protocols. * protocols.
@ -788,7 +787,7 @@ gst_uri_handler_get_uri (GstURIHandler * handler)
* gst_uri_handler_set_uri: * gst_uri_handler_set_uri:
* @handler: A #GstURIHandler * @handler: A #GstURIHandler
* @uri: URI to set * @uri: URI to set
* @error: (allow-none): address where to store a #GError in case of * @error: (optional): address where to store a #GError in case of
* an error, or %NULL * an error, or %NULL
* *
* Tries to set the URI of the given handler. * Tries to set the URI of the given handler.
@ -916,7 +915,7 @@ file_path_contains_relatives (const gchar * path)
* *
* On Windows @filename should be in UTF-8 encoding. * On Windows @filename should be in UTF-8 encoding.
* *
* Returns: newly-allocated URI string, or NULL on error. The caller must * Returns: (nullable): newly-allocated URI string, or NULL on error. The caller must
* free the URI string with g_free() when no longer needed. * free the URI string with g_free() when no longer needed.
*/ */
gchar * gchar *
@ -1690,7 +1689,7 @@ gst_uri_from_string_escaped (const gchar * uri)
* *
* Like gst_uri_from_string() but also joins with a base URI. * Like gst_uri_from_string() but also joins with a base URI.
* *
* Returns: (transfer full): A new #GstUri object. * Returns: (transfer full) (nullable): A new #GstUri object.
* *
* Since: 1.6 * Since: 1.6
*/ */
@ -1703,6 +1702,9 @@ gst_uri_from_string_with_base (GstUri * base, const gchar * uri)
g_return_val_if_fail (base == NULL || GST_IS_URI (base), NULL); g_return_val_if_fail (base == NULL || GST_IS_URI (base), NULL);
new_rel_uri = gst_uri_from_string (uri); new_rel_uri = gst_uri_from_string (uri);
if (!new_rel_uri)
return NULL;
new_uri = gst_uri_join (base, new_rel_uri); new_uri = gst_uri_join (base, new_rel_uri);
gst_uri_unref (new_rel_uri); gst_uri_unref (new_rel_uri);
@ -1917,7 +1919,7 @@ gst_uri_join (GstUri * base_uri, GstUri * ref_uri)
* This is a convenience function to join two URI strings and return the result. * This is a convenience function to join two URI strings and return the result.
* The returned string should be g_free()'d after use. * The returned string should be g_free()'d after use.
* *
* Returns: (transfer full): A string representing the percent-encoded join of * Returns: (transfer full) (nullable): A string representing the percent-encoded join of
* the two URIs. * the two URIs.
* *
* Since: 1.6 * Since: 1.6
@ -1929,7 +1931,15 @@ gst_uri_join_strings (const gchar * base_uri, const gchar * ref_uri)
gchar *result_uri; gchar *result_uri;
base = gst_uri_from_string (base_uri); base = gst_uri_from_string (base_uri);
if (!base)
return NULL;
result = gst_uri_from_string_with_base (base, ref_uri); result = gst_uri_from_string_with_base (base, ref_uri);
if (!result) {
gst_uri_unref (base);
return NULL;
}
result_uri = gst_uri_to_string (result); result_uri = gst_uri_to_string (result);
gst_uri_unref (base); gst_uri_unref (base);
gst_uri_unref (result); gst_uri_unref (result);
@ -2059,7 +2069,7 @@ gst_uri_to_string (const GstUri * uri)
/** /**
* gst_uri_is_normalized: * gst_uri_is_normalized:
* @uri: The #GstUri to test to see if it is normalized. * @uri: (nullable): The #GstUri to test to see if it is normalized.
* *
* Tests the @uri to see if it is normalized. A %NULL @uri is considered to be * Tests the @uri to see if it is normalized. A %NULL @uri is considered to be
* normalized. * normalized.
@ -2307,7 +2317,7 @@ gst_uri_set_port (GstUri * uri, guint port)
/** /**
* gst_uri_get_path: * gst_uri_get_path:
* @uri: The #GstUri to get the path from. * @uri: (nullable): The #GstUri to get the path from.
* *
* Extract the path string from the URI object. * Extract the path string from the URI object.
* *
@ -2346,7 +2356,7 @@ gst_uri_get_path (const GstUri * uri)
/** /**
* gst_uri_set_path: * gst_uri_set_path:
* @uri: (transfer none) (nullable): The #GstUri to modify. * @uri: (transfer none) (nullable): The #GstUri to modify.
* @path: The new path to set with path segments separated by '/', or use %NULL * @path: (nullable): The new path to set with path segments separated by '/', or use %NULL
* to unset the path. * to unset the path.
* *
* Sets or unsets the path in the URI. * Sets or unsets the path in the URI.
@ -2370,7 +2380,7 @@ gst_uri_set_path (GstUri * uri, const gchar * path)
/** /**
* gst_uri_get_path_string: * gst_uri_get_path_string:
* @uri: The #GstUri to get the path from. * @uri: (nullable): The #GstUri to get the path from.
* *
* Extract the path string from the URI object as a percent encoded URI path. * Extract the path string from the URI object as a percent encoded URI path.
* *
@ -2492,7 +2502,7 @@ gst_uri_set_path_segments (GstUri * uri, GList * path_segments)
/** /**
* gst_uri_append_path: * gst_uri_append_path:
* @uri: (transfer none)(nullable): The #GstUri to modify. * @uri: (transfer none)(nullable): The #GstUri to modify.
* @relative_path: Relative path to append to the end of the current path. * @relative_path: (nullable): Relative path to append to the end of the current path.
* *
* Append a path onto the end of the path in the URI. The path is not * Append a path onto the end of the path in the URI. The path is not
* normalized, call #gst_uri_normalize() to normalize the path. * normalized, call #gst_uri_normalize() to normalize the path.
@ -2530,7 +2540,7 @@ gst_uri_append_path (GstUri * uri, const gchar * relative_path)
/** /**
* gst_uri_append_path_segment: * gst_uri_append_path_segment:
* @uri: (transfer none)(nullable): The #GstUri to modify. * @uri: (transfer none)(nullable): The #GstUri to modify.
* @path_segment: The path segment string to append to the URI path. * @path_segment: (nullable): The path segment string to append to the URI path.
* *
* Append a single path segment onto the end of the URI path. * Append a single path segment onto the end of the URI path.
* *
@ -2602,7 +2612,7 @@ gst_uri_get_query_string (const GstUri * uri)
/** /**
* gst_uri_set_query_string: * gst_uri_set_query_string:
* @uri: (transfer none)(nullable): The #GstUri to modify. * @uri: (transfer none)(nullable): The #GstUri to modify.
* @query: The new percent encoded query string to use to populate the query * @query: (nullable): The new percent encoded query string to use to populate the query
* table, or use %NULL to unset the query table. * table, or use %NULL to unset the query table.
* *
* Sets or unsets the query table in the URI. * Sets or unsets the query table in the URI.

52
subprojects/gstreamer/gst/gstutils.c
View file

@ -1117,7 +1117,7 @@ gst_pad_check_link (GstPad * srcpad, GstPad * sinkpad)
* gst_element_get_compatible_pad: * gst_element_get_compatible_pad:
* @element: (transfer none): a #GstElement in which the pad should be found. * @element: (transfer none): a #GstElement in which the pad should be found.
* @pad: (transfer none): the #GstPad to find a compatible one for. * @pad: (transfer none): the #GstPad to find a compatible one for.
* @caps: (allow-none): the #GstCaps to use as a filter. * @caps: (nullable): the #GstCaps to use as a filter.
* *
* Looks for an unlinked pad to which the given pad can link. It is not * Looks for an unlinked pad to which the given pad can link. It is not
* guaranteed that linking the pads will work, though it should work in most * guaranteed that linking the pads will work, though it should work in most
@ -1779,10 +1779,10 @@ release_and_unref_pad (GstElement * element, GstPad * pad, gboolean requestpad)
/** /**
* gst_element_link_pads_full: * gst_element_link_pads_full:
* @src: a #GstElement containing the source pad. * @src: a #GstElement containing the source pad.
* @srcpadname: (allow-none): the name of the #GstPad in source element * @srcpadname: (nullable): the name of the #GstPad in source element
* or %NULL for any pad. * or %NULL for any pad.
* @dest: (transfer none): the #GstElement containing the destination pad. * @dest: (transfer none): the #GstElement containing the destination pad.
* @destpadname: (allow-none): the name of the #GstPad in destination element, * @destpadname: (nullable): the name of the #GstPad in destination element,
* or %NULL for any pad. * or %NULL for any pad.
* @flags: the #GstPadLinkCheck to be performed when linking pads. * @flags: the #GstPadLinkCheck to be performed when linking pads.
* *
@ -2102,10 +2102,10 @@ gst_element_link_pads_full (GstElement * src, const gchar * srcpadname,
/** /**
* gst_element_link_pads: * gst_element_link_pads:
* @src: a #GstElement containing the source pad. * @src: a #GstElement containing the source pad.
* @srcpadname: (allow-none): the name of the #GstPad in source element * @srcpadname: (nullable): the name of the #GstPad in source element
* or %NULL for any pad. * or %NULL for any pad.
* @dest: (transfer none): the #GstElement containing the destination pad. * @dest: (transfer none): the #GstElement containing the destination pad.
* @destpadname: (allow-none): the name of the #GstPad in destination element, * @destpadname: (nullable): the name of the #GstPad in destination element,
* or %NULL for any pad. * or %NULL for any pad.
* *
* Links the two named pads of the source and destination elements. * Links the two named pads of the source and destination elements.
@ -2126,12 +2126,12 @@ gst_element_link_pads (GstElement * src, const gchar * srcpadname,
/** /**
* gst_element_link_pads_filtered: * gst_element_link_pads_filtered:
* @src: a #GstElement containing the source pad. * @src: a #GstElement containing the source pad.
* @srcpadname: (allow-none): the name of the #GstPad in source element * @srcpadname: (nullable): the name of the #GstPad in source element
* or %NULL for any pad. * or %NULL for any pad.
* @dest: (transfer none): the #GstElement containing the destination pad. * @dest: (transfer none): the #GstElement containing the destination pad.
* @destpadname: (allow-none): the name of the #GstPad in destination element * @destpadname: (nullable): the name of the #GstPad in destination element
* or %NULL for any pad. * or %NULL for any pad.
* @filter: (transfer none) (allow-none): the #GstCaps to filter the link, * @filter: (transfer none) (nullable): the #GstCaps to filter the link,
* or %NULL for no filter. * or %NULL for no filter.
* *
* Links the two named pads of the source and destination elements. Side effect * Links the two named pads of the source and destination elements. Side effect
@ -2274,7 +2274,7 @@ gst_element_link_many (GstElement * element_1, GstElement * element_2, ...)
* gst_element_link_filtered: * gst_element_link_filtered:
* @src: a #GstElement containing the source pad. * @src: a #GstElement containing the source pad.
* @dest: (transfer none): the #GstElement containing the destination pad. * @dest: (transfer none): the #GstElement containing the destination pad.
* @filter: (transfer none) (allow-none): the #GstCaps to filter the link, * @filter: (transfer none) (nullable): the #GstCaps to filter the link,
* or %NULL for no filter. * or %NULL for no filter.
* *
* Links @src to @dest using the given caps as filtercaps. * Links @src to @dest using the given caps as filtercaps.
@ -2451,7 +2451,7 @@ gst_element_unlink (GstElement * src, GstElement * dest)
* gst_element_query_position: * gst_element_query_position:
* @element: a #GstElement to invoke the position query on. * @element: a #GstElement to invoke the position query on.
* @format: the #GstFormat requested * @format: the #GstFormat requested
* @cur: (out) (allow-none): a location in which to store the current * @cur: (out) (optional): a location in which to store the current
* position, or %NULL. * position, or %NULL.
* *
* Queries an element (usually top-level pipeline or playbin element) for the * Queries an element (usually top-level pipeline or playbin element) for the
@ -2494,7 +2494,7 @@ gst_element_query_position (GstElement * element, GstFormat format,
* gst_element_query_duration: * gst_element_query_duration:
* @element: a #GstElement to invoke the duration query on. * @element: a #GstElement to invoke the duration query on.
* @format: the #GstFormat requested * @format: the #GstFormat requested
* @duration: (out) (allow-none): A location in which to store the total duration, or %NULL. * @duration: (out) (optional): A location in which to store the total duration, or %NULL.
* *
* Queries an element (usually top-level pipeline or playbin element) for the * Queries an element (usually top-level pipeline or playbin element) for the
* total stream duration in nanoseconds. This query will only work once the * total stream duration in nanoseconds. This query will only work once the
@ -2559,6 +2559,8 @@ gst_element_query_convert (GstElement * element, GstFormat src_format,
return TRUE; return TRUE;
} }
*dest_val = -1;
query = gst_query_new_convert (src_format, src_val, dest_format); query = gst_query_new_convert (src_format, src_val, dest_format);
ret = gst_element_query (element, query); ret = gst_element_query (element, query);
@ -2661,7 +2663,7 @@ gst_pad_get_parent_element (GstPad * pad)
* gst_object_default_error: * gst_object_default_error:
* @source: the #GstObject that initiated the error. * @source: the #GstObject that initiated the error.
* @error: (in): the GError. * @error: (in): the GError.
* @debug: (in) (allow-none): an additional debug information string, or %NULL * @debug: (in) (nullable): an additional debug information string, or %NULL
* *
* A default error function that uses g_printerr() to display the error message * A default error function that uses g_printerr() to display the error message
* and the optional debug string.. * and the optional debug string..
@ -2875,7 +2877,7 @@ gst_pad_proxy_query_caps (GstPad * pad, GstQuery * query)
* gst_pad_query_position: * gst_pad_query_position:
* @pad: a #GstPad to invoke the position query on. * @pad: a #GstPad to invoke the position query on.
* @format: the #GstFormat requested * @format: the #GstFormat requested
* @cur: (out) (allow-none): A location in which to store the current position, or %NULL. * @cur: (out) (optional): A location in which to store the current position, or %NULL.
* *
* Queries a pad for the stream position. * Queries a pad for the stream position.
* *
@ -2906,7 +2908,7 @@ gst_pad_query_position (GstPad * pad, GstFormat format, gint64 * cur)
* @pad: a #GstPad on whose peer to invoke the position query on. * @pad: a #GstPad on whose peer to invoke the position query on.
* Must be a sink pad. * Must be a sink pad.
* @format: the #GstFormat requested * @format: the #GstFormat requested
* @cur: (out) (allow-none): a location in which to store the current * @cur: (out) (optional): a location in which to store the current
* position, or %NULL. * position, or %NULL.
* *
* Queries the peer of a given sink pad for the stream position. * Queries the peer of a given sink pad for the stream position.
@ -2937,7 +2939,7 @@ gst_pad_peer_query_position (GstPad * pad, GstFormat format, gint64 * cur)
* gst_pad_query_duration: * gst_pad_query_duration:
* @pad: a #GstPad to invoke the duration query on. * @pad: a #GstPad to invoke the duration query on.
* @format: the #GstFormat requested * @format: the #GstFormat requested
* @duration: (out) (allow-none): a location in which to store the total * @duration: (out) (optional): a location in which to store the total
* duration, or %NULL. * duration, or %NULL.
* *
* Queries a pad for the total stream duration. * Queries a pad for the total stream duration.
@ -2969,7 +2971,7 @@ gst_pad_query_duration (GstPad * pad, GstFormat format, gint64 * duration)
* @pad: a #GstPad on whose peer pad to invoke the duration query on. * @pad: a #GstPad on whose peer pad to invoke the duration query on.
* Must be a sink pad. * Must be a sink pad.
* @format: the #GstFormat requested * @format: the #GstFormat requested
* @duration: (out) (allow-none): a location in which to store the total * @duration: (out) (optional): a location in which to store the total
* duration, or %NULL. * duration, or %NULL.
* *
* Queries the peer pad of a given sink pad for the total stream duration. * Queries the peer pad of a given sink pad for the total stream duration.
@ -3025,6 +3027,8 @@ gst_pad_query_convert (GstPad * pad, GstFormat src_format, gint64 src_val,
return TRUE; return TRUE;
} }
*dest_val = -1;
query = gst_query_new_convert (src_format, src_val, dest_format); query = gst_query_new_convert (src_format, src_val, dest_format);
if ((ret = gst_pad_query (pad, query))) if ((ret = gst_pad_query (pad, query)))
gst_query_parse_convert (query, NULL, NULL, NULL, dest_val); gst_query_parse_convert (query, NULL, NULL, NULL, dest_val);
@ -3059,6 +3063,8 @@ gst_pad_peer_query_convert (GstPad * pad, GstFormat src_format, gint64 src_val,
g_return_val_if_fail (dest_format != GST_FORMAT_UNDEFINED, FALSE); g_return_val_if_fail (dest_format != GST_FORMAT_UNDEFINED, FALSE);
g_return_val_if_fail (dest_val != NULL, FALSE); g_return_val_if_fail (dest_val != NULL, FALSE);
*dest_val = -1;
query = gst_query_new_convert (src_format, src_val, dest_format); query = gst_query_new_convert (src_format, src_val, dest_format);
if ((ret = gst_pad_peer_query (pad, query))) if ((ret = gst_pad_peer_query (pad, query)))
gst_query_parse_convert (query, NULL, NULL, NULL, dest_val); gst_query_parse_convert (query, NULL, NULL, NULL, dest_val);
@ -3070,7 +3076,7 @@ gst_pad_peer_query_convert (GstPad * pad, GstFormat src_format, gint64 src_val,
/** /**
* gst_pad_query_caps: * gst_pad_query_caps:
* @pad: a #GstPad to get the capabilities of. * @pad: a #GstPad to get the capabilities of.
* @filter: (allow-none): suggested #GstCaps, or %NULL * @filter: (nullable): suggested #GstCaps, or %NULL
* *
* Gets the capabilities this pad can produce or consume. * Gets the capabilities this pad can produce or consume.
* Note that this method doesn't necessarily return the caps set by sending a * Note that this method doesn't necessarily return the caps set by sending a
@ -3121,7 +3127,7 @@ gst_pad_query_caps (GstPad * pad, GstCaps * filter)
/** /**
* gst_pad_peer_query_caps: * gst_pad_peer_query_caps:
* @pad: a #GstPad to get the capabilities of. * @pad: a #GstPad to get the capabilities of.
* @filter: (allow-none): a #GstCaps filter, or %NULL. * @filter: (nullable): a #GstCaps filter, or %NULL.
* *
* Gets the capabilities of the peer connected to this pad. Similar to * Gets the capabilities of the peer connected to this pad. Similar to
* gst_pad_query_caps(). * gst_pad_query_caps().
@ -3423,7 +3429,7 @@ gst_parse_bin_from_description (const gchar * bin_description,
* @bin_description: command line describing the bin * @bin_description: command line describing the bin
* @ghost_unlinked_pads: whether to automatically create ghost pads * @ghost_unlinked_pads: whether to automatically create ghost pads
* for unlinked source or sink pads within the bin * for unlinked source or sink pads within the bin
* @context: (transfer none) (allow-none): a parse context allocated with * @context: (transfer none) (nullable): a parse context allocated with
* gst_parse_context_new(), or %NULL * gst_parse_context_new(), or %NULL
* @flags: parsing options, or #GST_PARSE_FLAG_NONE * @flags: parsing options, or #GST_PARSE_FLAG_NONE
* @err: where to store the error message in case of an error, or %NULL * @err: where to store the error message in case of an error, or %NULL
@ -4047,7 +4053,7 @@ gst_pad_create_stream_id_internal (GstPad * pad, GstElement * parent,
* gst_pad_create_stream_id_printf_valist: * gst_pad_create_stream_id_printf_valist:
* @pad: A source #GstPad * @pad: A source #GstPad
* @parent: Parent #GstElement of @pad * @parent: Parent #GstElement of @pad
* @stream_id: (allow-none): The stream-id * @stream_id: (nullable): The stream-id
* @var_args: parameters for the @stream_id format string * @var_args: parameters for the @stream_id format string
* *
* Creates a stream-id for the source #GstPad @pad by combining the * Creates a stream-id for the source #GstPad @pad by combining the
@ -4086,7 +4092,7 @@ gst_pad_create_stream_id_printf_valist (GstPad * pad, GstElement * parent,
* gst_pad_create_stream_id_printf: * gst_pad_create_stream_id_printf:
* @pad: A source #GstPad * @pad: A source #GstPad
* @parent: Parent #GstElement of @pad * @parent: Parent #GstElement of @pad
* @stream_id: (allow-none): The stream-id * @stream_id: (nullable): The stream-id
* @...: parameters for the @stream_id format string * @...: parameters for the @stream_id format string
* *
* Creates a stream-id for the source #GstPad @pad by combining the * Creates a stream-id for the source #GstPad @pad by combining the
@ -4124,7 +4130,7 @@ gst_pad_create_stream_id_printf (GstPad * pad, GstElement * parent,
* gst_pad_create_stream_id: * gst_pad_create_stream_id:
* @pad: A source #GstPad * @pad: A source #GstPad
* @parent: Parent #GstElement of @pad * @parent: Parent #GstElement of @pad
* @stream_id: (allow-none): The stream-id * @stream_id: (nullable): The stream-id
* *
* Creates a stream-id for the source #GstPad @pad by combining the * Creates a stream-id for the source #GstPad @pad by combining the
* upstream information with the optional @stream_id of the stream * upstream information with the optional @stream_id of the stream
@ -4547,7 +4553,7 @@ gst_type_mark_as_plugin_api (GType type, GstPluginAPIFlags flags)
/** /**
* gst_type_is_plugin_api: * gst_type_is_plugin_api:
* @type: a GType * @type: a GType
* @flags: (out) (nullable): What #GstPluginAPIFlags the plugin was marked with * @flags: (out) (optional): What #GstPluginAPIFlags the plugin was marked with
* *
* Checks if @type is plugin API. See gst_type_mark_as_plugin_api() for * Checks if @type is plugin API. See gst_type_mark_as_plugin_api() for
* details. * details.