GitLab

Essentially this moves the truncation logic out of gst_audio_buffer_clip()
so that it can be used in other places, like in audiorate.

Modernizing the documentation, making it simpler to read an
modify and allowing us to possibly switch to hotdoc in the
future.

gst_buffer_copy_region() can return NULL when the buffer meta-data is invalid.

See https://bugzilla.gnome.org/show_bug.cgi?id=772200

There was a second '*' at the start of the line. Reword + reformat to make it
obvious.

e.g., allows this to be used with the reference retrieved by
gst_event_parse_segment().

https://bugzilla.gnome.org/show_bug.cgi?id=765663

https://bugzilla.gnome.org/show_bug.cgi?id=708952

https://bugzilla.gnome.org/show_bug.cgi?id=687520

when nothing is clipped, return the input buffer instead of creating and
returning an identical copy.

... as there may be other than raw audio formats using a channel mask,
and there is already one to convert the other way around.

..and turn the GST_WARNING() into a g_warning(). This is a programming
error and should be fixed.

Also reset the flag when parsing caps.

We fail (and return) if the size is *NOT* a multiple of samples.

This can be used to differentiate between interleaved
and non-interleaved audio and whatever comes in the future.

The available channel positions are all channels from SMPTE 2036-2-2008
(in that order) and DTS Coherent Acoustics, which are basically all 28
channels that currently can appear.

The channels are now expressed in the caps as a channel-mask, which
describes which of the channels are present, and an optional
channel-reorder-map, which must only be used after negotiation for
fixated caps.

For negotiation only the channel-mask and the channel count is relevant
and all elements are expected to handle all reorder maps. Elements that
don't can use the new API to reorder an audio buffer from any order to
another order.

This simplifies negotiation a lot while still having as few reorderings
necassary as possible and still allow all kinds of channel layouts.

Check if thr layout is explicitly unpositioned and set a flag in the
audio info structure.

Fix typos in code and docs. Fixes. #658984

Add const to some methods.
Add padding.
Add GType for GstAudioInfo and GstAudioFormatInfo.
Add new/copy/free for GstAudioInfo.

This is to prevent e.g. GST_AUDIO_INFO_FORMAT() from crashing on a NULL pointer
dereference when used with an unset info.