basetransform fix for upstream caps-renegotiation

If initially pass-through caps are negotiated between a transform element's
sink and src pads, but then the downstream element returns different caps
on a buffer from pad_alloc(), basetransform gets stuck with proxy_alloc=TRUE
even though the upstream peer doesn't accept the caps, causing
gst_pad_peer_accept_caps() to be called on each buffer in _buffer_alloc():

    if (!gst_caps_is_equal (newcaps, caps)) {
      GST_DEBUG_OBJECT (trans, "caps are new");
      /* we have new caps, see if we can proxy downstream */
>>    if (gst_pad_peer_accept_caps (pad, newcaps)) {
        /* peer accepts the caps, return a buffer in this format */
        GST_DEBUG_OBJECT (trans, "peer accepted new caps");

which is taking ~40ms/frame.

This patch does two things.  (1) if the buffer returned from pad_alloc() has
new caps, trigger the decision whether to proxy the buffer-alloc to be
revisited, and (2) disable proxy if peer does not accept new caps.  (The first
part may not be strictly needed, but seemed like a good idea.)

Note that this issue would not arise except in case of downstream elements
who have on their template-caps, some that would be suitable for pass-through,
but at runtime pick more restrictive caps (for ex, after querying a driver for
what formats it actually supports).

info: fix compilation on windows

Fix mismatched brackets (#625295).

gstdatetime: Fix localtime usage

localtime only takes one parameter and returns a statically
allocated tm struct. Use it correctly.

Fixes #625368

basetransform: Try suggesting caps on bad caps pad_alloc

When basetransform received an unsupported caps on pad_alloc
it just returned not-negotiated. This patch makes it query
the allowed caps between his sinkpad and upstream's srcpad
to find a caps to suggest.

This happens when dinamically switching pipeline elements
and upstream pad_allocs with the previous caps that was
being used.

Fixes #614296

info: flush again after every line of debug output

g_printerr() used to do this for us. Also use libc's fprintf() functions,
to make sure the stderr pointer we use is actually compatible with the
libc linked against by GStreamer (which apparently may not always be the
same as what GLib is linked against on windows), and we don't need the
functionality ensured by g_fprintf().

Fixes #625295.

po: update for new strings

gstvalue: Adds tests for datetime

Adds tests for datetime fields in gstvalue tests

Fixes #594504

gststructure: Adds datetime getter function

Adds gst_structure_get_date_time function

API: gst_structure_get_date_time

Fixes #594504

tag: Adds GST_TAG_DATE_TIME tag

Adds a new tag that represents a date and time a media was
created

API: GST_TAG_DATE_TIME

Fixes #594504

taglist: Add datetime get functions

Adds _date_time_get and _date_time_get_index functions to
taglist.

API: gst_tag_list_get_date_time
API: gst_tag_list_get_date_time_index

Fixes #594504

gstvalue: Adds datetime functions

Adds a datetime functions to gstvalue

Fixes #594504

gstdatetime: Adds GstDateTime

Adds GstDateTime to represent dates + time + timezone
information.

Tests included.

API: GstDateTime
API: gst_date_time_get_day
API: gst_date_time_get_month
API: gst_date_time_get_year
API: gst_date_time_get_hour
API: gst_date_time_get_microsecond
API: gst_date_time_get_minute
API: gst_date_time_get_second
API: gst_date_time_get_time_zone_offset
API: gst_date_time_new
API: gst_date_time_new_local_time
API: gst_date_time_new_from_unix_epoch
API: gst_date_time_new_now_local_time
API: gst_date_time_new_now_utc
API: gst_date_time_ref
API: gst_date_time_unref

Fixes #594504

gst: Fix usage of glib_check_version()

It returns NULL if the installed GLib version is as least as
new as the required version and some explanatory string otherwise.

tools: make gst-inspect print the release date time stamp

configure: use new AG_GST_SET_PACKAGE_RELEASE_DATETIME_WITH_NANO macro

binaryregistry: save and load release date time in GstPluginDesc

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

plugin: add release datetime field to GstPluginDesc and set it if GST_PACKAGE_RELEASE_DATETIME is defined

This is a string describing a date and/or date/time in a simple subset of
the ISO-8601 format, namely either "YYYY-MM-DD" or "YYYY-MM-DDTHH:MMZ" (with
'T' the date/time separator and the 'Z' indicating UTC).

The main purpose of this field is to keep track of plugin and element versions
on an absolute timeline, so it's possible to determine which one is newer when
comparing two date time numbers. This will allow us to express 'replaces'-type
relationships betweeen plugins and element factories in future, even across
different modules and plugin merges or splits (source module version numbers
aren't particularly useful here, since they can only meaningfully be compared
within the same module). It also allows applications and libraries to reliably
check that a plugin is recent enough without making assumptions about modules
or module versions.

We use a string here to keep things simple and clear, esp. on the build system
side of things.

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

tests: make *_get_type() in tests thread safe

Even if it shouldn't be needed here. See #623491.

info: write debugging output to file if GST_DEBUG_FILE environment variable is set

This changes behaviour slightly in that we no longer output things
via g_printerr(), so any non-standard glib printerr handlers are no
longer called when GST_DEBUG is enabled. However, this seems not
really desirable in most cases anyway, and the GLib docs also say
that libraries should not use g_printerr() for logging.

Other stderr output (e.g. warnings, or application messages) will
of course not be captured in the log file this way.

GST_DEBUG_FILE=- will redirect debug output to stdout.

gstpad: Assume pads are compatible if we don't have templates

This is the same behaviour as if we had a pad template caps of
GST_CAPS_ANY on any of the pads (i.e. the actual check will be done
during caps negotiation).

basetransform: Allow the subclass to add new fields to caps when getting new caps from downstream

This was already done in all other cases where new caps are handled
except upstream negotiation.

docs: fix some typos and add some missing links in the app dev manual

Fixes #624164.

docs: fix typo on gst-inspect man page

See #624164.

gstcheck: fix some silly list iteration code

g_list_length() is not the best way to check if a list is empty or not.

registry: use GStatBuf unconditionally and add typedef for backwards compatibility

No need to clutter the code with #if #else #endif.

See #623875.

structure: Use a const GstStructure * as parameter for some more gst_structure_get variants

Revert "-launch: disable CLOCK_LOST message handling"

This reverts commit 1f8eba611a63f45766c38c640288e42b27b10bd4.

This should be fixed now (and if not should be fixed) and the
clock-lost handling is now needed for playbin2 gapless playback.

See bug #579127.

registrybinary: Fix compatibility with GLib 2.25 when using MSVC

Newer GLib uses a new type for g_stat() and friends to improve
Windows compatibility. On POSIX this is a typedef to struct stat.

Fixes bug #623875.

pipeline: If the currently used clock gets lost update it the next time when going from PAUSED to playing

Fixes bug #623806.

basesrc: Return values in stream time for the POSITION query

Fixes bug #623622.

basesink: Implement GstElement::get_query_types()

basesink: Only answer the SEGMENT query in pull mode

Otherwise the element handling the seeks should answer this query.

Fixes bug #623622.

basetransform: Implement POSITION query

Fixes bug #623541.

GstPad: Do not call gst_pad_accept_caps() when caps change

Instead just check that the caps intersect with the pad template.
The elements should properly accept/refuse the caps in setcaps().

Shaves off calling the default implementation of acceptcaps which does
an expensive gst_pad_get_caps() (so if you have 50 of those elements in
a row, you'd be doing factorial(50) gst_pad_get_caps...).

Does not break any module unit test and most apps work fine.

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

utils: Add more details about gst_element_get_compatible_pad

Back to development.

Release 0.10.30

po: update translations

pad: remove comma at the end of the last enum value

Fixes the build for c++.

checks: add unit test for recent taglist merge_strings_with_comma fix

See #624113.

taglist: fix merge_strings_with_comma() for more than two strings

Fixes #624113.

.gitignore: ignore new basesink unit test binary

tools: remove -p shorthand for --no-sigusr-handler

It's not really needed, and doesn't map any longer after the long option
has been renamed.

0.10.29.4 pre-release

Also bump libtool versions now (which I meant to do for the first
pre-release but forgot).

po: update translations

basesink: add accessors for the enable-last-buffer property.

API: gst_base_sink_set_last_buffer_enabled
API: gst_base_sink_is_last_buffer_enabled

basesink: add new enable-last-buffer property.

Add a new enable-last-buffer property. When false, it disables storing the last
received buffer in basesink::last-buffer. This can be useful in cases where
buffers need to be released asap.

API: GstBaseSink::enable-last-buffer

checks: rewrite gsttagsetter test to use fewer g_usleep()

Something about that seems to interact badly with some schedulers,
so do things differently.

Fixes #623469.

docs: add new add gst_clock_id_wait_async_full() to docs

API: add gst_clock_id_wait_async_full

See #623589.

gstvalue: Improve gst_value_{set|get}_caps docs

win32: export gst_clock_id_wait_async_full

tests: remove ABI checks for GstClockEntry.

clock: document that GstClockEntry should be treated as ana opaque structure.

clock: use the new gst_clock_id_wait_async_full.

Use the new gst_clock_id_wait_async_full in gst_clock_set_master.
Also add some tests.

clock: fix refcounting bug in gst_clock_set_

Make sure clock->clockid is unreffed before clock->master.
gst_clock_id_unschedule (clock->clockid) tries to access clock->master. If
clock->master is unreffed before and it's deallocated, _unschedule could access
free'd memory.

clock: add gst_clock_id_wait_async_full.

Add gst_clock_id_wait_async_full. It's the same as gst_clock_id_wait_async but
allows passing a GDestroyNotify to destroy user_data.

docs: improve the api docs for new GstPadLinkChecks and its use

README: update after removal of "old" dir.

Remove "old" and add a line about "examples".

Remove old 0.8 tests and examples from git tree

Doesn't really look like anything's worth keeping.

check: skip silly test that segfaults when in a CK_FORK=no environment

See #623469.

checks: make fakesrc check work in a CK_FORK=no environment

Reset have_eos at the beginning of each test.

See #623469.

checks: run tests calling gst_deinit() last so things work with CK_FORK=no

Because gst_init() will fail once gst_deinit() has been called.

See #623469.

checks: don't assume element factory is not loaded yet

It may already be loaded if check is being run with CK_FORK=no.

See #623469.

docs: fix a couple of typos in the manual

Spotted by Alexander Saprykin.

Fixes #622379.

gstcaps: Make sure _normalize() is applied on all structures.

We need to use gst_caps_get_size() in the loop counter since some
structures could be added while iterating.

Fixes #623301

docs: update 'XML in GStreamer' section in application developer's manual

0.10.29.3 pre-release

multiqueue: implement acceptcaps function

Our acceptcaps function can simply forward the query.

Bump automake requirement to 1.10

For maintainability reasons and $(builddir).

Fixes #622944.

tools: mention --eos-on-shutdown on gst-launch man page

utils: Don't use G_GNUC_CONST for the uint64 scaling functions

They are actually *not* const functions because on architectures
without int128 instructions the parameters were changed.

gcc re-used the parameters on the stack for multiple calls though
and the changed parameters were used for the second call then.

Fixes bug #623003.

0.10.29.2 pre-release

po: update translations

examples: remove xml example build system bits and purge from tree

Fixes make distcheck.

xml: keep dummy gst_xml_get_type() function for g-i even if rest of GstXML is removed

Add a minimal gst_xml_get_type() function, so that gobject-introspection doesn't
break the compilation if we're compiling with GST_REMOVE_DEPRECATED defined or
--disable-loadsave having been passed to configure. Until someone figures out
a better way at least.

Don't include <libxml/parser.h> from public headers if GST_DISABLE_DEPRECATED is defined

Since everything GstXML related has been deprecated, we can now skip the
libxml includes from the public headers when GST_DISABLE_DEPRECATED is
defined.

See #463435.

examples: add missing stdlib.h include in typefind example

dot-dump: terminate truncated strings and escape special chars

Fixes syntax errors in generated dot files for caps with strings.

pad: more documentation regarding the new flags

pad: make the NOTHING link check flag be 0

Make the pad link check of NOTHING be 0. This way we have a flag for each
feature and 0 when no flags are set.

tests: Remove GstXML tests

gstxml: Deprecate GstXml and related functions

Pipeline serialisation to and from XML is horribly broken for all
but the most simple use cases, and will likely never be fixed.
Make sure everyone playing around with these tools is aware of
this, to avoid frustration. See countless bug reports in bugzilla.

Fixes bug #622685.

controller: Fix build with GST_REMOVE_DEPRECATED

benchmarks: Use gst_element_link_pads_full

We're testing caps negotiation, not pad linking. Brings the startup
time down 100 fold.

tools: deprecate gst-xmllaunch and print fat warning if someone tries to use it

Pipeline serialisation to and from XML is horribly broken for all
but the most simple use cases, and will likely never be fixed.
Make sure everyone playing around with these tools is aware of
this, to avoid frustration. See countless bug reports in bugzilla.

gst-launch: rename new --no-play command line option to --no-sigusr-handler

--no-play seems a bit confusing.

Fixes #621867.

Automatic update of common submodule

From 73ff93a to a519571

binaryregistry: ignore the plugin cache if the filter environment has changed

Make sure that we properly update the registry and the cache file whenever
the filter environment changes or there's no more filter set.

pluginloading: add support for whitelisting based on plugin or source module name and path

This feature is primarily intended for use in plugin modules' unit tests.

Consider the following situation: gst-plugins-good is built against an
installed GStreamer core. An older version of gst-plugins-good is also
installed in that prefix, along with random other plugin modules. Now,
when doing 'make check' in the just-built gst-plugins-good tree, we
want to only load plugins from GStreamer core, gst-plugins-base, and
gst-plugins-good, but not random other modules (we don't want any unit
tests to fail just because some module in gst-plugins-bad has a broken
plugin_init, for example). Also, we want to only load gst-plugins-good
modules from the locally-built source tree, but not any of the older
gst-plugins-good modules installed. This is usually assured by loading
the ones in the source tree first (by adding that path first to the
right environment variables), but it gets tricky when plugins are
moved, removed, merged, or renamed, or the plugin filename changes.

Note that 'make check' should really work right without doing
'make install' or uninstalling the old gst-plugins-good package (or
any other gst-plugins-foo package) first.

Enter GST_PLUGIN_LOADING_WHITELIST. This environment variable may
contain source-package@path-prefix pairs separated by the platform
search path separator (G_SEARCHPATH_SEPARATOR_S). The source package
and path prefix are separated by the '@' character. The path prefix is
entirely optional, as is the '@' separator if no path is given.

It is also possible to filter based on plugin names instead of the name
of the source-package by specifying one or more plugin names separated
by commas before the optional path prefix.

In short, the following match patterns are possible:

   plugin1,plugin2@pathprefix or
   plugin1,plugin2@* or just
   plugin1,plugin2 or
   source-package@pathprefix or
   source-package@* or just
   source-package

So for our gst-plugins-good unit test example above, we  would set the
environment variable on *nix to something like this (will likely be a
relative path in practice):
gstreamer:gst-plugins-base:gst-plugins-good@/path/to/src/gst-plugins-good

Fixes #619815 and #619717.

gstghostpad: We don't need any checks when linking target pad

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

gstutils: New gst_element_link_pads_full method

Links the elements with the specified pad linking checks.

API:gst_element_link_pads_full

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

GstPad: Add new pad linking method with configurable checks.

To be used for cases where we don't need all checks to be validated.

API: gst_pad_link_full
API: GstPadLinkCheck

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

tag: Adds GST_TAG_IMAGE_ORIENTATION tag

Adds a new tag to inform about the image orientation and how
to rotate and flip it before display.

Note that this tag is a string with a predefined set of
possible values.

API: GST_TAG_IMAGE_ORIENTATION

Fixes #619508

gstobject: deprecate gst_object_{set|get}_name_prefix()

The name prefix stuff has never been used for anything and it doesn't
look like we'll ever want to use it for anything.

Fixes #621006.

Add gobject-introspection annotations for GstPadIntLinkFunction

Fixes build with latest gobject-introspection from git.

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

queue2: fix merging of ranges

When we merge two ranges, don't updata the current range writing_pos with
whereever we were writing earlier in the merged range.  Spotted by bilboed.

registry: also skip .deps dirs when scanning for plugins

No need to descend into .deps dirs in uninstalled setups, we know
these don't contain any plugins.

taglist: add gst_tag_list_peek_string_index to avoid a copy

Adds a variation of the _get_string_index function that doesn't copy
the string.

API: gst_tag_list_peek_string_index

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

typefind: make sure buffers' metadata is writable before setting caps on them

Fixes warnings when using playbin2 with dvb:// streams, where typefind
comes after mpegtsparse.

docs: update introspected plugin docs for gstdoc-scanobj changes

Update common for latest gstdoc-scanobj and inspect xml files for
escaping and pad template order changes.