docs: some docs love

docs: add GstAudioDecoder and GstAudioEncoder to documentation

audio: rename GstBaseAudioDecoder/Encoder to GstAudioDecoder/Encoder

API: gst_gst_audio_decoder_finish_frame()
API: gst_gst_audio_decoder_get_audio_info()
API: gst_gst_audio_decoder_get_byte_time()
API: gst_gst_audio_decoder_get_delay()
API: gst_gst_audio_decoder_get_latency()
API: gst_gst_audio_decoder_get_max_errors()
API: gst_gst_audio_decoder_get_min_latenc()y
API: gst_gst_audio_decoder_get_parse_state()
API: gst_gst_audio_decoder_get_plc()
API: gst_gst_audio_decoder_get_plc_aware()
API: gst_gst_audio_decoder_get_tolerance()
API: gst_gst_audio_decoder_get_type()
API: gst_gst_audio_decoder_set_byte_time()
API: gst_gst_audio_decoder_set_latency()
API: gst_gst_audio_decoder_set_max_errors()
API: gst_gst_audio_decoder_set_min_latency()
API: gst_gst_audio_decoder_set_plc()
API: gst_gst_audio_decoder_set_plc_aware()
API: gst_gst_audio_decoder_set_tolerance()

API: gst_gst_audio_encoder_finish_frame()
API: gst_gst_audio_encoder_get_audio_info()
API: gst_gst_audio_encoder_get_frame_max()
API: gst_gst_audio_encoder_get_frame_samples()
API: gst_gst_audio_encoder_get_hard_resync()
API: gst_gst_audio_encoder_get_latency()
API: gst_gst_audio_encoder_get_lookahead()
API: gst_gst_audio_encoder_get_mark_granule()
API: gst_gst_audio_encoder_get_perfect_timestamp()
API: gst_gst_audio_encoder_get_tolerance()
API: gst_gst_audio_encoder_get_type()
API: gst_gst_audio_encoder_proxy_getcaps()
API: gst_gst_audio_encoder_set_frame_max()
API: gst_gst_audio_encoder_set_frame_samples()
API: gst_gst_audio_encoder_set_hard_resync()
API: gst_gst_audio_encoder_set_latency()
API: gst_gst_audio_encoder_set_lookahead()
API: gst_gst_audio_encoder_set_mark_granule()
API: gst_gst_audio_encoder_set_perfect_timestamp()
API: gst_gst_audio_encoder_set_tolerance()

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

encodebin: Select muxer further

Sort muxers based on their caps and ranking before iterating to
find one that fits the profile.

Sorting is done by putting the elements that have a pad template
that can produce the exact caps that is on the profile. For example:
when asking for "video/quicktime, variant=iso", muxers that
have this exact caps on their pad templates will be put first on
the list than ones that have only "video/quicktime".

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

decodebin2: Actually iterate over the factories instead of only taking the first one

tests: supress ERROR log output for some tests

Be nice when we tests for correct error handling and don't spam stdout.

Revert "playsink: Try include 'pitch', if no other sink is provided"

This reverts commit 105814e2c78f9867c61531b9e8166e4ae994296f.

The general consensus seems to be that we should revert this for
now. If such behaviour is desired, we should probably enable it
via a flag. And maybe use the scaletempo plugin instead.

playsink: Don't leak the videochain ts-offset element

Also don't leak the audiochain ts-offset element if one is
found but the sink doesn't support volume settings.

playsink: Use gst_object_unref() instead of g_object_unref() for better debugging

videoscale: Add modified Lanczos scaling method

Adds a Lanczos-derived scaling method, which is rather slow, but very
high quality.  Adds a few properties that can be used to tune various
scaling properties: sharpness, sharpen, envelope, dither.  Not currently
Orcified, but was designed with that in mind.

playback: Add define for colorspace element

Single point of change if you want to switch from ffmpegcolorspace
to colorspace.

videorate: fix dynamically changing average period

The average_period_set variable can be accessed in different threads, so
always lock it when reading. Furthermore when switching to averaging
mode we should make sure we don't have cached buffers that aren't used
in that mode. And any modeswitch will cause the latency to change, so we
should post a NewLatency message

videorate: Port to basetransform

Correct added versions

playsink: Only unref ts_offset elements if they're not NULL

decodebin2: Keep the chain mutex locked while connecting to the notify::caps signal

seek: Accept pipeline descriptions for audiosink/videosink

Make the element_factory_make_or_warn utility function try parsing
the input string as a bin if element_factory_make() fails. This makes
the --audiosink/--videosink commandline options accept a pipeline
string.

playsink: Try include 'pitch', if no other sink is provided

As a default, try the pipeline 'pitch ! audioconvert ! autoaudiosink'
before trying plain autoaudiosink

pbutils: don't depend on libgstvideo just to parse some caps

Let's extract those ints and fractions ourselves and not depend
on libgstvideo.

audio: add GstBaseAudioDecoder and GstBaseAudioEncoder to build

However, libgstaudio now depends on libgstvideo (via pbutils).

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

API: gst_audio_info_clear()
API: gst_audio_info_convert()
API: gst_audio_info_copy()
API: gst_audio_info_free()
API: gst_audio_info_from_caps()
API: gst_audio_info_init()
API: gst_audio_info_to_caps()
API: gst_base_audio_decoder_finish_frame()
API: gst_base_audio_decoder_get_audio_info()
API: gst_base_audio_decoder_get_byte_time()
API: gst_base_audio_decoder_get_delay()
API: gst_base_audio_decoder_get_latency()
API: gst_base_audio_decoder_get_max_errors()
API: gst_base_audio_decoder_get_min_latency()
API: gst_base_audio_decoder_get_parse_state()
API: gst_base_audio_decoder_get_plc()
API: gst_base_audio_decoder_get_plc_aware()
API: gst_base_audio_decoder_get_tolerance()
API: gst_base_audio_decoder_get_type()
API: gst_base_audio_decoder_set_byte_time()
API: gst_base_audio_decoder_set_latency()
API: gst_base_audio_decoder_set_max_errors()
API: gst_base_audio_decoder_set_min_latency()
API: gst_base_audio_decoder_set_plc()
API: gst_base_audio_decoder_set_plc_aware()
API: gst_base_audio_decoder_set_tolerance()
API: gst_base_audio_encoder_finish_frame()
API: gst_base_audio_encoder_get_audio_info()
API: gst_base_audio_encoder_get_frame_max()
API: gst_base_audio_encoder_get_frame_samples()
API: gst_base_audio_encoder_get_hard_resync()
API: gst_base_audio_encoder_get_latency()
API: gst_base_audio_encoder_get_lookahead()
API: gst_base_audio_encoder_get_mark_granule()
API: gst_base_audio_encoder_get_perfect_timestamp()
API: gst_base_audio_encoder_get_tolerance()
API: gst_base_audio_encoder_get_type()
API: gst_base_audio_encoder_proxy_getcaps()
API: gst_base_audio_encoder_set_frame_max()
API: gst_base_audio_encoder_set_frame_samples()
API: gst_base_audio_encoder_set_hard_resync()
API: gst_base_audio_encoder_set_latency()
API: gst_base_audio_encoder_set_lookahead()
API: gst_base_audio_encoder_set_mark_granule()
API: gst_base_audio_encoder_set_perfect_timestamp()
API: gst_base_audio_encoder_set_tolerance()

docs: add since markers to baseaudio{decoder,encoder} documentation

baseaudiodecoder, baseaudioencoder: fix some compiler warnings

Leaving the GST_USE_UNSTABLE_API guards in until some of the
ported decoders have been updated and it's clear that I didn't
mess up anywhere porting things to the new audio API.

baseaudioutils: remove, merged into or superseded by audio.c

baseaudioencoder: port to new GstAudioInfo API

baseaudiodecoder: port to GstAudioInfo API

audio: add gst_audio_info_{init,clear} and gst_audio_info_{copy,free}

audio: add GstAudioFormat, GstAudioFormatInfo and GstAudioInfo

Same as in 0.11, but with caps parsing/serialising for 0.10 style
caps. Add setting default channel positions.

baseaudioencoder: remove leftover experimental code

audioutils: modify _parse, add GType support functions

baseaudiodecoder: move properties to private storage and add
_get/_set

baseaudiodecoder: rename property

baseaudiodecoder: replace context helper structure by various
_get/_set

baseaudioencoder: move properties to private storage and add
_get/_set

baseaudioencoder: rename some properties

baseaudioencoder: replace context helper structure by various
_get/_set

baseaudio: rename GstAudioState to GstAudioFormatInfo

baseaudioencoder: TEMP; avoid some imperfect ts jitter ?

... even when not in perfect mode ?

baseaudioencoder: debug format fixes

baseaudiodecoder: debug format fix

baseaudiodecoder: fixup documentation

baseaudiodecoder: fix FLUSH_STOP actions

baseaudiodecoder: preserve upstream seek event seqnum

baseaudioencoder: use buffer running time for granule calculation

baseaudiodecoder: minor fix in ts resync

baseaudiodecoder: improve glitch resilience

Provide a replacement for GST_ELEMENT_ERROR to avoid aborting at the first
atom out of place, while on the other hand not failing indefinitely.

baseaudiodecoder: add limited legacy seeking support

baseaudiodecoder: cater for audio-codec tag

baseaudiodecoder: initial version

baseaudioencoder: misc fixes

baseaudio: add audioutils for caps and query handling helper utils

baseaudioencoder: mark unstable API

baseaudioencoder: fix clearing context

baseaudioencoder: simplify latency variable handling

baseaudioencoder: minor fixes and code simplifications

Also modify and elaborate a bit on pre_push (though currently unused to no harm).

baseaudioencoder: additional documentation on granule semantics and
configuration

baseaudioencoder: elaborate property names

baseaudioencoder: rename state field xint to is_int

baseaudioencoder: gtk-doc syntax fixes

baseaudioencoder: minor fix and cleanup

baseaudiocodec: ... and also rename to baseaudiodecoder

gst-libs/gst/audio: Remove baseaudiodecoder

Adds little beyond baseaudiocodec (seeking, bit of query), and what it adds
is mainly out-of-scope (e.g. decoder seeking, should be done by upstream
demuxer/parser) and/or based on non-prime example (mad).

baseaudiodecoder: Return TRUE if we run into special conversion cases.

audio: initial version of GstBaseAudioCodec

Moved most of the code to GstBaseAudioCodec, GstBaseAudioDecode is
now really small, maybe we do not really need it (or its encoder
counterpart). Added more API for subclasses and documentation.

Added src_queries to decoder class. Added handle_discont to decoder
class. Reworked reset. Various other minor fixes.

Added a draft implementation of gstbaseaudiodecoder

Added audio directory for audio codec base classes

audioencoders: add streamheader helper utility

audioencoders: baseaudioencoder and ported encoders

win32: Add new discoverer API

docs: Add new discoverer API

discoverer: retrieve audio track language from tags too

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

discoverer: consider subtitles as raw

Otherwise, discoverer will generated an "inner" codec
where there can be a tranformation (eg, kate -> DVD SPU,
and various ->text/x-pango-markup).

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

discoverer: add application/x-kate to subtitles caps

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

discoverer: get language from other tags if we did not get it already

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

discoverer: add subtitles API

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

playback: reference count ts_offset

Apparently this object is being used after it's freed.  This is one
way to fix it, although perhaps not the best way.  Fixes: #656715.

theoraenc: fix caps leak

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

basertppayload: Make perfect timestamps reproducible across element restart

Without the perfect timestamp machinery, the RTP timestamp can be
computed directly from the running time of a buffer, but the perfect
timestamp patch broke that assumption. This patch restores it by
having the first perfect timestamp be the running time of that buffer
and counting from there.

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

oggmux: fix leaks in skeleton writing

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

oggmux: generate message headers from received tags

Some message headers can be deduced from tags (eg, "Language").

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

ogg: use memory slices where appropriate

While there, avoid zeroing newly allocated memory where unnecessary

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

playsink{audio,video}convert: Send NEWSEGMENT events to sinkpads instead of pushing them

oggdemux: do not warn when reaching EOS while scanning for the end chain

After all, we were asking for it.

This gets rid of the last warning-about-expected-condition.

w00t.

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

oggdemux: add media type to chain information reports

One more little step in making logs a little less abstruse.

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

oggstream: correctly identify skeleton EOS packet

It is 0 byte, and was triggering the "bad packet" logic.

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

oggdemux: do not warn about expected occurences

In this case, finding a skeleton packet.
Once upon a time, it used to be rare indeed, but no more.

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

oggdemux: do not warn when finding a non BOS page

After all, we do hope to find actual data for these streams.
However, warn if we could not set up a chain when we find a
non BOS page, as that means we don't have a valid Ogg stream.

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

oggdemux: rename local variable for clarity

While the casual reader might end up bewildered by just why this
change might increase clarity, it just happens than, in the libogg
and associated sources, op is the canonical name for an ogg_packet
whlie og is the canonical name for an ogg_page, and reading this
code confuses me.

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

oggdemux: do not try to determine duration of header packets

Headers are inherently durationless.
Instead, set duration to 0 to avoid increasing tracked granpos,
and do not warn about it, since it is totally expected.

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

oggstream: include stream type in warnings

It makes it easier to work out what's going on.

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

oggstream: set skeleton stream media type to application/x-ogg-skeleton

This is to match the typefinder, and to make logs clearer.

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

oggmux: add skeleton write support

Version written is 3.0

Base times are left empty for now.

Content-Type should be the MIME type of the stream. It is set to
the GStreamer media type for now, which is probably the same for
the streams oggmux supports.

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

oggdemux: do not skip sparse streams when determining start times

This fixes demuxing of streams containing only sparse streams,
which would cause an infinite loop in _read_end_chain.

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

oggdemux: do not ignore sparse streams' start time

But do not wait for them either, if we don't have a packet for them.

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

vorbisenc: Relax overly-tight jitter tolerances in gstvobisenc

vorbisenc currently reacts in a rater draconian fashion if input
timestamps are more than 1/2 sample off what it considers ideal. If data
is 'too late' it truncates buffers, if it is 'too soon' it completely
shuts down encode and restarts it.  This is causingvorbisenc to produce
corrupt output when encoding data produced by sources with bugs that
produce a smple or two of jitter (eg, flacdec)

textoverlay: fix text buffer leak

Make sure to always unref the input text buffer.

Reported by bcxa.sz@gmail.com.

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

docs: fix xref for the property

docs: handle warnings emitted by gtk-doc

This is useful and in most cases someone had put arbitrary markup into the docs,
misspelled xref'ed symbols, forgot to add stuff to the docs etc..

docs: partially revert my last commit

Somehow this was already there, but I missed that commit.

docs: add new taglicense docs and clean them up

Avoid ugly docbook tags unless needed.