examples: rtp: Add end-to-end rtpbin example with RTX elements

This example demonstrates how to use rtpbin with retransmission (rtx)
elements set in the place of rtpbin's "aux" elements in order to
enable RTP retransmission according to the rules of RFC4588.

doc: add design-rtpauxiliary.txt to describe how rtpbin deals with auxiliary elements

session: also push EOS event to RTCP srcpad

session: place SSRC in Retransmission event

tests/check: add rtpaux::test_simple_rtpbin_aux

It shows how to use "set-aux-receive" and "set-aux-send"
properties of rtpbin to set rtprtxsend and rtprtxreceive

Build 2 pipelines, one for rtpbin as a sender and one for
rtobin as a receive. Then transmit an audio stream.

It also drops some packets to activate restransmission and
check they are actually retransmited.

tests/check: add rtpcollision::test_rtx_ssrc_collision unit test

check that rtxrtpsend changes its retransmission ssrc when
collision happens

tests/check: add rtprtx::test_rtxreceive_data_reconstruction

This unit test verifies that retransmitted rtp packets coming out
of rtprtxreceive are the same as the original ones.

rtprtxsend: use a realistic limit for the value of max-size-packets

G_MAXINT16 is chosen because if the queue contains more than
G_MAXINT16 packets, seqnum comparison will not work properly.

rtprtxsend: use a GSequence to implement the buffer queue

This has the advantage that searching the queue to find the
buffer with the requested seqnum is done with binary search.

rtprtxsend: retransmit packets in the same order as the rtx requests

tests/check: Add unit test for rtxsend's max_size_time property

rtprtxsend: Handle the max_size_time property

This property allows you to specify the amount of buffers
to keep in the retransmission queue expressed as time (ms)
instead of buffer count (which is the max_size_buffers property).

rtprtxsend: keep important buffer information in a private structure

This is to avoid mapping a buffer every time we need to read a seqnum
or a timestamp.

tests/check: Add rtprtx::test_rtxsender_packet_retention

This unit test verifies that the rtxsend element correctly maintains
a buffer of already transmitted rtp packets and that it can
re-transmit all of them correctly on demand. It also verifies
that the limit of this buffer (max-size-packets property) is respected.

tests/check: add rtprtx::test_drop_multiple_sender unit test

Several senders / one receiver

Similar than test_drop_one_sender but with multiple senders
mixed through the funnel element.
It drops some packets and checks that they are retransmited
correctly.

tests/check: add rtprtx::test_drop_one_sender unit test

Test for one sender / one receiver

Build the pipeline
videotestsrc ! rtpvrawpay ! rtprtxsend ! rtprtxreceive ! fakesink
and drop some buffers between rtprtxsend and rtprtxreceive
Then it checks that every dropped packet has been re-sent.
It also checks that not too much requests has been sent.

tests/check: add rtprtx::test_push_forward_seq

add simple unit test that manually push buffers
in rtprtxsend connected to rtprtxreceive.
Drops some buffers and make sure they are retransmisted.

rtpmanager: add new rtprtxsend / rtprtxreceive elements

The purpose of the sender RTX object is to keep a history
of RTP packets up to a configurable limit (in time). It will
listen for custom retransmission events from downstream. When
it receives a request for retransmission, it will look up the
requested seqnum in its list of stored packets. If the packet
is available, it will create a RTX packet according to RFC 4588
and send this as an auxiliary stream.

The receiver will listen to the custom retransmission events
from the downstream jitterbuffer and will remember the SSRC1
of the stream and seqnum that was requested. When it sees a
packet with one of the stored seqnum, it associates the SSRC2
of the stream with the SSRC1 of the master stream. From then
on it knows that SSRC2 is the retransmission stream of SSRC1.
This algorithm is stated in RFC 4588. For this algorithm to
work, RFC4588 also states that no two pending retransmission
requests can exist for the same seqnum and different SSRCs or
else it would be impossible to associate the retransmission with
the original requester SSRC.
When the RTX receiver has associated the retransmission packets,
it can depayload and forward them to the source pad of the element.

RTX is SSRC-multiplexed

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

doc: add design for rtp retransmission

Describe how rtprtxsend and rtprtxreceive generally work
but also how the association algorithm is implemented.

souphttpsrc: use status code macro instead of 407

Rest of the code is using the _PROXY_AUTHENTICATION_REQUIRED
macro too. Easier to understand if you don't recall HTTP
error codes by heart.

shout2send: change audio_format field to format

This element and the underlying libshout2 library
can handle video media files too. The code already
handles video/webm so the name gets confusing. Also
add and use DEFAULT_FORMAT macro Instead of hardwiring
SHOUT_FORMAT_VORBIS at init

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

shout2send: clarify meaning of the URL prop

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

shout2send: docs, add a sample pipeline

And finish adding shout2send to the docs while at it

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

gdkpixbufoverlay: remove spurious @see_also

deinterlace: support any video formats and any caps features if deinterlace mode allows it

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

v4l2: Handle v4l2_ioctl() errors even in error handling

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

osxvideo: unifdef -DRUN_NS_APP_THREAD

osxvideo: Assume SDK and deployment target are at least Snow Leopard

configure: Disable osxvideo on Leopard and earlier

This also moves the "other platforms" check in OS X video to before the
variable is read

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

tests: add AUX receiver unit test

tests: improve rtpbin test

rtpbin: add some docs about AUX elements

tests: add AUX sender unit test

rtpbin: add support for AUX sender and receiver

AUX elements are elements that can be inserted into the rtpbin
pipeline right before or after 1 or more session elements.

The AUX elements are essential for implementing functionality such
as error correction (FEC) and retransmission (RTX).

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

tests: add decoder test

rtpbin: make request_element method internally

We can use the same method to create encoder and decoder elements, they
are just internal elements that we create.

wavparse: Skip id3 tag

Skip id3 tag during wav parse.

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

osx: Make OSX version checks more consistent

And especially also consider update versions, e.g. 10.5 with updates
will be 1051 or similar and thus bigger than MAC_OS_X_VERSION_10_5 but
still won't have the API we want to use.

osxvideosink: Fix build on updated OS X Leopard

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

avimux: Add missing break

I guess no-one noticed we no longer could mux WMV3 ...

COVERITY CID 1139759

rtpvrawpay: Add missing break

COVERITY CID 1139762

rtpsession: internal-ssrc is no longer deprecated

rtpbin: add Since tags

rtpbin: add signal for new jitterbuffer

Emit a signal when a new jitterbuffer is created so that the app can
have a chance to configure it.

rtpbin: handle multiple encoder instances

Keep track of elements that are added to multiple sessions and make sure
we only add them to the rtpbin once and that we clean them when no
session refers to them anymore.

tests: add unit test for encoder element

rtpbin: fix memory leaks

tests: fix leak

rtpbin: expect the pads on the encoders

Don't use request pads for the encoder elements, the signal handler
should request the pads and make sure they are available with the right
name.

rtpbin: request-rtp-encoder are no action signals

The request-rtp-encoder signals are not action signals so mark them
correctly and use an accumulator to collect the result value.

wavparse: emit midi-base-note tag from data in 'smpl' chunk

Add parsing of the 'smpl' chunk. Right now we only grab the midi-base-note and
emit it as a tag.

gstrtpsession: suggest upstream to use the new "internal-ssrc" after a collision

When a collision is found on the internal ssrc, we have to change it.
Ideally, we want also the payloader upstream to follow this change and use
the new internal ssrc. Ideally we want this condition to be always met:
if there is one payloader sending on this session, its ssrc should match the
internal ssrc.

rtpsession: allow setting internal-ssrc again

y4mencode: Remove dead code

set/get property isn't used

rtpqcelpdepay: Remove uneeded variable

rtpbin: allow dynamic RTP/RTCP encoders/decoders

* gst/rtpmanager/gstrtpbin.[ch]: four new action signals have been
  added (request-rtp-encoder, request-rtp-decoder, request-rtcp-encoder
  and request-rtcp-decoder). The user will be able to provide encoders
  or decoders dynamically. The encoders must follow the srtpenc API and
  the decoders the srtpdec API. Having separate signals for RTP and RTCP
  allows the user to use different encoders/decoders or provide the same
  one (e.g. that would be the case for srtpenc).

  Also, rtpbin now allows application/x-srtp in its pads.

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

rtpjitterbuffer: dynamically recalculate RTX parameters

Use the round-trip-time and average jitter to dynamically calculate the
retransmission interval and expected packet arrival time.

Based on patches from Torrie Fischer <torrie.fischer@collabora.co.uk>

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

rtpjitterbuffer: calculate average jitter

rtpsession: use RTT from the Retransmission event

Place the estimated RTT in the Retransmission event and let the session
manager use that instead of the hardcoded value.

jitterbuffer: take more accurate running-time for NACK

Don't use the current time calculated from the tmieout loop for when we
last scheduled the NACK because it might be unscheduled because of a max
packet misorder and then we don't accurately calculate the current time.
Instead, take the current element running time using the clock.

wavpackdec: Send a CAPS event in the unit test

qtdemux: improve mss_mode/fragmented special handling

Make it clear what should be handled purely by mss mode:
1) Expose the streams on the first moof as there are no moov atoms
2) Properly cleanup streams on flushes

Add a note about the meaning of upstream_newsegment and mss_mode
for future reference.

Make all other special fragment handling shared for both dash
and mss streams.

qtdemux: drain the adapter before pushing EOS

In a fragmented scenario, qtdemux is operating in push mode
and it gets a fragmented buffer. While processing its data
downstream gets unlinked (or a input-selector changes its
active pad and returns not-linked). Qtdemux stops processing
this fragment and returns not-linked upstream, leaving the
remaining data in its adapter.

When it gets an EOS it should make sure that all the data it
had received is pushed before pushing EOS.

shout2send: drop IP only requirement for _set_host()

libshout2 (we require > 2.0 at config time) supports
both IP and hostname for _set_host(). Dropped an
outdated FIXME regarding this limitation, adjusted
some comments and changed the param blurb to reflect
this too.

shout2send: Retarget FIXME to 2.0

rtspsrc: use aggregate control for PLAY/PAUSE/TEARDOWN

Use the aggregate control instead of the original request url to perform
PAUSE/PLAY and TEARDOWN.

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

rndbuffersize: Proxy CAPS, ALLOCATION, SCHEDULING and srcpad events properly

matroskamux: adpcm max block align is 8192

vp9dec: Require vpx >= 1.3.0 for building vp9dec and vp9enc

Previous versions did not have a stable bitstream for VP9.

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

matroskamux: Use correct codec id for ADPCM/DVI

matroskademux: Check for the correct size of codec_data in the ACM case

matroskamux: basic adpcm support

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

qtdemux: Fix calcuation of descriptor length

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

Automatic update of common submodule

From dbedaa0 to d48bed3

po: set gettext domain in Makevars so we don't have to patch the generated Makefile.in.in

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

udpsrc: on receive error only unmap and unref buffer if one was alloced and mapped

coverity CID 1139866.

multiudpsink: fix misleading comment

Those are not allocated on the stack.

vpx: Mark VP9 support as non-experimental

There was a libvpx release with VP9 support now and the bitstream
is frozen too.

Some compiler warning fixes to satisfy XCode compiler

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

id3v2mux: Set picture type in the APIC frames

id3v2mux: Set image-description from the info struct, not the caps

wavpackparse: Post AUDIO_CODEC tag

sbcparse: Post AUDIO_CODEC tag

flacparse: Post AUDIO_CODEC tag

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

dcaparse: Post AUDIO_CODEC tag

amrparse: Post AUDIO_CODEC tag

ac3parse: Post AUDIO_CODEC tag

aacparse: Post AUDIO_CODEC tag

mpegaudioparse: Use pbutils functionality to create the AUDIO_CODEC tag

rtpsession: Add error message if the app tries to set the internal-ssrc

rtpsession: Only count nacks when a nack packet is received

Not when any RTCP feedback packet is.

tests: Initialize segment in rtpcollision test

rtpsession: Process PSFB FIR requests which lack the media ssrc

According to RFC 5104 section 4.3.1.2, RTCP PSFB FIR message SHALL
have a media_ssrc field set to 0. The actual media ssrc is in the FCI.
So in that case, we ignore the retained feedback and just let it through
to the rtp_session_process_fir() function which will check for the actual
SSRC inside the FCI.

Fixes a regression introduced by commit 57c27ec3

rtpsession: fix rb blocks disappearing after the first rtcp cycle with multiple senders

Previously, when the session had multiple internal sender SSRCs, it would
issue SR reports with RB blocks only on the first RTCP timeout and afterwards
SR reports would be sent empty. This was because the "generation" number
in RTPSource would increase more than once during the same cycle and afterwards
it would always be greater than the session's generation, which would cause
it to be skipped from being included in RBs.

This commit fixes this problem by:
1) Increasing the RTPSource generation only at the end of each cycle,
which essentially fixes the problem but only when the internal senders
are less than GST_RTCP_MAX_RB_COUNT.
2) Keeping for each RTPSource a set of SSRCs which stores which SSRC's
SR the given RTPSource has been reported in, which also fixes the problem
when the internal senders are more than GST_RTCP_MAX_RB_COUNT. This is
necessary because of the fact that any RTPSource is marked as reported
in itself's SR and makes it impossible to know if it has been reported
in other SRs too or not, and which.

tests/check: add an rtpsession unit test to verify all RBs are included in all SRs, roundrobin

This test checks that when we have multiple internal sender sources
in rtpsession, SRs contain RBs for every other sender source, and that
they are included roundrobin when they exceed ST_RTCP_MAX_RB_COUNT,
which is the max number of RBs that can fit in a SR.

docs: improve docs

doc: add design-rtpcollision.txt that explains when GstRTPCollision is created

It also talks about "BYE only the corresponding source, not the whole session."

tests/check: improve rtpcollision::test_master_ssrc_collision to ensure that a collision does not BYE the whole session

Conflicts:
tests/check/elements/rtpcollision.c

tests/check: add rtpcollision::test_master_ssrc_collision unit test

It checks the payloader changes its ssrc when collision happens

rtpsession: keep extra stats for scheduling BYE

Keep an extra stats structure for scheduling the BYE packets. When we
decide to schedule BYE, make a copy of the current stats into the
bye_stats. Then while we schedule the BYE, update and use only the
bye_stats. When we finished scheduling the BYE packet, we use the
regular stats again.