gl/meson: OSX support (CGL and Cocoa)

[Matthew Waters]: minor additions such as -fobjc-arc and relying on
dependency rather than cc.find_library()

Add GBM_CFLAGS and define EGL_PLATFORM_GBM_MESA

Building an image with yocto for an 'am335x' processor will fail,
because 'gbm.h' can not be found and 'EGL_PLATFORM_GBM_MESA' is not defined.

So simply adding define of 'EGL_PLATFORM_GBM_MESA' in 'gstgldisplay_egl.c'
and adding 'GBM_CFLAGS' in 'gst-gl.m4' to get rid of this errors and complete
a full build process.

ERRORs were:
-----------
gst-plugins-base-1.14.1/gst-libs/gst/gl/gbm/gstglwindow_gbm_egl.h:24:10:
fatal error: gbm.h: No such file or directory
  #include <gbm.h>
           ^~~~~~~

gst-plugins-base-1.14.1/gst-libs/gst/gl/egl/gstgldisplay_egl.c:157:39:
error: 'EGL_PLATFORM_GBM_MESA' undeclared (first use in this function);
did you mean 'EGL_PLATFORM_WAYLAND'?
  ret = _gst_eglGetPlatformDisplay (EGL_PLATFORM_GBM_MESA, (gpointer) display,
                                    ^~~~~~~~~~~~~~~~~~~~~

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

opusdec: Add property to control phase inversion

When enabled, phase-inversion slightly increase stereo quality, but
produce a stream that when downmixed to mono will present important
audio distortion. This patch disables this feature by default and
introduce a property that let user enable it if desired.

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

gl/gbm: allow headless mode

Don't require an output for the GBM backend.

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

gl: Add switches for explicitely enabling/disabling PNG and JPEG support

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

gl: Add switch for explicitely enabling/disabling GBM support

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

meson: Fix build with x11 dependency is disabled

gtk_x11_dep is used unconditionally in tests/icles/meson.build

meson: Fix detection of cdparanoia library

Without this the pkg-config file is required when the plugin is enabled.

tagdemux: Properly propagate gst_pad_pull_range() errors

And don't consider FLUSHING an actual error, just stop in that case.

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

meson: Add feature options for all plugins

GL dependency detection is still automagic.

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

gl: Also don't leak floating references to elements set via properties

Fixup for 58ac815eae6ed468d1db60a54a1bd34d6324c28c. Floating references
are such a mess.

gl: Don't steal callers reference when setting non-floating elements via properties

Introduced by fbef9220d3dc2f785081c4766901aab2ecfaed10. The code there
is only correct for elements we get from signals.

audio-buffer: fix typo in assignment that causes buggy behavior

gstaudiodecoder: take into account GstAudioMeta::samples on the output buffers

This is useful if the output buffers are planar and have extra padding
on each plane, in which case size/bpf does not represent the number of
valid samples.

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

gstaudiodecoder: do not aggregate output if buffers are planar

Aggregation will break the layout, as it concatenates buffers,
and fixing it here would be much more inefficient than configuring
the actual decoder implementation to output larger buffers.

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

meson: gl/gtk tests: Add video_dep to the helper

The gtk helper library includes videooverlay.h hence must have a
dependency on video_dep, this allow removing the dep from the dependant
executables.

meson: examples: fix wrong keyword for gtk examples

meson: Build gl/gtk examples

audiorate: accumulate offset by time diff

The fomula, 'offset = time / rate', is correct only if
the rate is never changed. When the rate is changed,
the offset should be re-calculated based on the previous
offset.

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

xvimage: Fix symbol redefine build error

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

glupload: Only offer DMABuf caps feature if using EGL

This was miss-leading VAAPI which was not forcing linear back buffers,
would still export DMABuf. That caused bad rendering as the buffers are
tiled and most likely compressed.

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

urisourcebin: Rename urisourcebin variable and query functions

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

urisourcebin: Set streams-aware flag

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

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

gl/build: fixed failed compilation due to missing EGLuint64KHR typedef

[Matthew Waters]: add meson differences

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

Revert "glupload: Only offer DMABuf caps feature if using EGL"

This reverts commit bc9afe724360cbbe5489ca1e1ea44f077810aca4.

glupload: Only offer DMABuf caps feature if using EGL

This was miss-leading VAAPI which was not forcing linear back buffers,
would still export DMABuf. That caused bad rendering as the buffers are
tiled and most likely compressed.

docs: libs: Add new symbols to section file

rawvideoparse: fix typo in 'plane-offsets' description

The property is 'plane-offsets', not 'plane-offset' so the example in
the description was wrong.

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

videodecoder: Don't always drain on gaps/discont

V4L2 and OMX decoder don't support draining and keeping reference
frames. As a side effect, these decoder just stops working on
gaps/discont. When this drain was introduced, the commit stated that
this was for TRICKMODE_KEY_UNITS, so only drain if running in this mode.

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

tests: audio: test gst_audio_buffer_reorder_channels() also with non-interleaved buffers

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

libs: audio: implement planar buffer support in gst_audio_buffer_reorder_channels()

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

audiorate: fix support for non-interleaved buffers

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

libs: audio: add a new gst_audio_buffer_truncate() function

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

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

tests: audio: add unit tests for planar audio support in gst_audio_buffer_clip()

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

libs: audio: implement support for non-interleaved audio in gst_audio_buffer_clip()

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

gluploadelement: also set the context in decide_allocation

If downstream doesn't perform allocation queries, the context would
never be set and criticals would occur.

tests: simple-launch-lines: fixate audioconvert caps now that the layout is also convertable

Because audioconvert can now convert between interleaved and non-interleaved,
this pipeline fails on the upstream capsfilter not being able to fixate its
output caps. This is unavoidable.

adder: remove non-interleaved layout from caps

adder needs more than just trivial work to support planar buffers properly
because it currently reads sub-buffers from GstCollectPads in order for all
of them to have matching sizes. In planar mode, this means it would truncate
some channels and mix them up in strange ways. It only works if all input
buffers in all sink pads have matching sizes.

audioresample: implement support for non-interleaved buffers

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

tests: audioconvert: add tests for planar audio

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

tests: audioconvert: add support for specifying the layout on tests

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

audioconvert: implement support for converting between interleaved and non-interleaved layouts

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

libs: audio-converter: complete code to support non-interleaved audio buffers

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

libs: audio-resampler: add support for consuming non-interleaved input buffers

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

libs: audio-channel-mixer: add support for non-interleaved audio buffers

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

tests/check/Makefile.am: link audiotestsrc test with libgstaudio

Needed for the new planar audio unit test

tests: audiotestsrc: add unit test for non-interleaved audio output

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

audiotestsrc: implement producing non-interleaved audio buffers

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

gl/utils: fixup matrix math again for column major

e4bf9ed8f060021151cd57e2b00493ed696cb47b was not quite right and changed
the wrong thing. Intead we needed to change the multiplication order
and should have kept the previous to/from matrices as is done in this
patch.

videopool: display expected size in warning message

Display the size computed from the caps when rejecting a pool
configuration because the buffer size is too small.

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

videosink: Set processing deadline to 15ms

This roughly corresponds to one frame at 60fps, and leave 5ms
of max_lateness to not change the existing behaviour.

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

parsebin: Don't try to continue autoplugging a parser if we got raw caps

Otherwise we'll fail with an unhelpful message that no decoder for the
raw caps was found if a container contains raw media.

typefindfunctions: Bail out on huge EBML chunks

We can't handle/store more than guint32 anyway

typefindfunctions: Use guint32 for sizes

This brings it in sync with the type used with gst_type_find_*() API

typefindfunctions: Use types of same size/signedness

Where applicable/possible

tests: audio: add unit test for GstAudioBuffer & GstAudioMeta

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

libs: audio: Implement GstAudioBuffer & GstAudioMeta

Library bits to support non-interleaved audio

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

meson: rtsp now also depends on libgstbase

rtsp: Also use libgstbase for introspection module

rtsp: Link to libgstbase for GstDataQueue

audiobasesrc: Round down segsize to an integer number of samples

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

rtspconnection: Use GstQueueArray instead of GQueue for the queued messages

gl: check for EGL_KHR_platform_gbm for non-MESA gbm implementations

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

gl: fix build on iOS

gl: fix build on Windows

gl: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

rtp: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

pbutils: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

tag: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

video: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

audio: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

app: Update for g_type_class_add_private() deprecation in recent GLib

https://gitlab.gnome.org/GNOME/glib/merge_requests/7

glcontextegl: only dump configs once

glcontextegl: Fix android build without ES3 tokens

rtspdefs: Add gst_rtsp_generate_digest_auth_response_from_md5

Passwords are usually not stored in clear text, usually
the A1 section of the response is stored as is in .htdigest
files.

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

gl/tests: matrix use the affine matrix setter to convert matrices

Removes some duplicated matrices that didn't really need to be
hardcoded.

glcontextegl: dump the list of EGLConfig's available

gl: use dependency fallbacks to get at a possible gl-headers subproject

We would make the subproject conditional on the wrap-mode=nodownload
however get_option('wrap-mode') or similar is not available from
meson.build files as the wrap-mode is meant to be used automatically.

Instead use the dependency fallback mechanism to get at the subproject
where possible i.e. when downloading is allows and only add the compat
includes when we have a valid internal dependency from the gl-headers
subproject.

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

oggdemux: Make sure that events are writable before changing their seqnum

gl/tests: add extension/version parsing checks

discoverer: Don't crash when running with -v if channel-mask==0 and >7 channels

For e.g. 16-channel audio, if the channel mask is 0 (which it usually
is), gst_audio_channel_positions_from_mask would get confused,
ultimately leading into a crash.

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

videoencoder: Keep the segment position in sync

If the start of the segment is modified, the position should be
modified accordingly

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

sdp: Add new constructor, sdp_message_from_text

Helper function for bindings, in python for example
users can now replace:

res, msg = GstSdp.SDPMessage.new()
GstSdp.sdp_message_parse_buffer(bytes(text.encode()), msg)

with:

res, msg = GstSdp.SDPMessage.new_from_text(text)

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

videopool: Removed unused private caps member

Revert "gl/meson: add support for using bundled headers in a subproject"

This reverts commit 82c43ff9a32f1c1d113cd6e1e8d046b7ab64422d.

Reverting for the time being, since it trips up build bots
that don't have network connectivity.

We ideally shouldn't have a subproject that's used unconditionally.

glalpha: fix compilation with msvc

It doesn't define M_PI

gl/meson: add support for using bundled headers in a subproject

This is most useful when building on windows which does not ship the
necessary OpenGL headers.

gl: add subproject for necessary GL headers for building

Originally for windows with the GL/glext.h and GL/wglext.h but can be
extended for other headers

audiobasesink: Improve clock skew corrections.

The external time should be moved only as much as needed
to get back to the ideal center point, so that the clock
is still allowed to drift both directions after the correction.
This reduces excessive back and forth corrections that were
caused by the assumption of a linear drift.

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

gl/meson: force the gl dependency to use pkg-config

Meson has an internal override for dependency('gl') which we do not want
to use as it assumes too many things.  Force meson to only search for
gl.pc.

gl/meson: don't define GST_EXPORTS

The intended use (msvc) doesn't currently like it and will fail to
resolve symbols at runtime.

gldownloadelement: fix build with msvc

msvc doesn't like #ifdef inside macro expansion

gl/utils: Fix NDC conversion matrices for column-majorness

The matrices were converting the wrong values with non-diagonal-only matrices.
e.g. a typical yflip matrix in [-1,1]^3 such as
 1  0  0  0
 0 -1  0  0
 0  0  1  0
 0  0  0  1

Would have actually required a matrix like this in [0,1]^3
 1  0  0  0
 0 -1  0  0
 0  0  1  0
 0 -2  0  1

Which is
1. not consistent with our multiplication convention and would require
   transposing matrices or changing our multiplication order (from what is
   generally used on opengl matrix guides/tutorials).
2. Produces incorrect values when input with actual vertices accounting for
   the difference in multiplication order.  e.g. some vertices multiplied by
   the yflip matrix using vertex * yflip(== transpose(yflip) * vertex):

     vertex:       -> result:           expected:
     vec4(1,0,1,1) -> vec4(1,-2,1,1)    vec4(1,1,1,1)
     vec4(1,1,1,1) -> vec4(1,-3,1,1)    vec4(1,0,1,1)

With the updated values, we now get the expected values.

Includes a test for this behaviour and the example above

playsink: Properly propagate SEGMENT seqnum

When flushing chains, make sure the FLUSH events have seqnum
that are consistent with the current SEGMENT seqnum

streamsynchronizer: Properly propagate seqnum on EOS event

rtpbasedepayload: Properly propagate segment seqnum

This wasn't done previously and the outgoing SEGMENT events had
seqnums which weren't consistent with the upstream ones

oggdemux: Properly relay seqnum of segments

Not all cases were handled regarding properly propagating the
seqnum of SEGMENT events on all downstream segment-related events

subparse: Don't read beyond array

If num_open_tags is 0, we shouldn't try to get the "last" open tag
since there isn't any.

ogg: Avoid undefined granule shift

A granule is a 64bit signed integer, shifting by 63 or more is
undefined and most likely an indication that the stream is
corrupted or invalid.

Detected by oss-fuzz

docs: Fix typos