doc: extend "See Also" chapters in library manuals

In particular, make "See Also" chapter rendered in HTML output.

doc: extend "See Also" chapters in component manuals

In particular, make "See Also" chapter rendered in HTML output.

doc: extend "See Also" chapter rendering for ff* tools

Add more references, and generate alternative variants for HTML and POD
output. In particular, this allows to render a "See Also" chapter in the
HTML output.

doc: rework synopsis section for ff* tools

Fix syntax, remove pointless introductory sentence, improve overall
consistency.

doc: use a common authors.texi file blurb

Factorize.

doc/texi2pod: rework man inclusion logic

Ignore @c man begin ... @c man end comments, rely on @chapter for marking
the beginning of the various manual top level sections.

This allows us to write markup which is not dependent on the specific
texi2pod.pl implementation.

This change causes a few rendering issues, which will be fixed in further
patches.

utils: fix duration calculation for strange_duration_example.ts

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

lavfi/gradfun: small align cosmetics.

doc/filters: reformat and rework gradfun.

Note that examples are changed.

lavfi/gradfun: support named options.

This breaks usage for out-of-range values.

fate: re-enable lavfi gradfun filter test.

lavfi/gradfun: reduce up limit for threshold.

This will prevent an overflow in the SSSE3 and MMX filter_line code:
delta is expressed as an u16 being shifted by 2 to the left. If it
overflows, having a strength not above 64 will make sure that m is set
to 0 (making the m*m*delta >> 14 expression void).

A value above 64 should not make any sense unless gradfun is used as a
blur filter.

lavfi/gradfun: remove rounding to match C and SSE code.

There is no noticable benefit for such precision.

lavfi/gradfun: fix dithering in MMX code.

Current dithering only use the first 4w instead of the whole 8 random values.

lavfi/gradfun: fix rounding in MMX code.

Current code divide before increasing precision.

lavfi/gradfun: do not increment DC pointer for odd values.

First DC is only used once otherwise. This also makes the code
consistent with ASM versions.

qcelpdata: correct start bit for cbgain[0] in qcelp_rate_octave_bitmap[]

Signed-off-by: Paul B Mahol <onemda@gmail.com>

ffmpeg: Fix shortest with libx264

Encoders that buffer a significant number of frames where a "few"
frames off with -shortest

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

MAINTAINERS: update my GPG key fingerprint

Cosmetics: Reindent after last commit.

Do not skip three bytes and don't search for extradata in old realaudio files.

Fixes ticket #1557.

af_apad: remove unneeded av_opt_free

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

apad: add whole_len and pad_len options.

These options allow padding to a specific length or adding a specific amount if silence.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

apad: fix apad_options formating

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

af_apad: add user setable packet_size

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

avfilter: add apad filter

This filter pads an audio stream with silence
It can together with -shortest be used to extend audio streams to
the same length as video.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Merge remote-tracking branch 'qatar/master'

* qatar/master:
  configure: formatting cosmetics
  h264: use mbaff ref indices in fill_colmap() only for mbaff references

Conflicts:
libavcodec/h264_direct.c

Merged-by: Michael Niedermayer <michaelni@gmx.at>

h264: remove redundant parts of old slice in extradata code.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

h264: merge old and new "slice in extradata" checks

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Merge commit '61c6eef5456f2bc8b1dc49a0a759c975551cea29'

* commit '61c6eef5456f2bc8b1dc49a0a759c975551cea29':
  h264: prevent decoding of slice NALs in extradata
  doxy: Clarify what avpriv_set_pts_info does

Conflicts:
libavcodec/h264.c

Merged-by: Michael Niedermayer <michaelni@gmx.at>

Merge commit 'c35f0e8495e34c2082dcde805e9323c9f6a4cb0a'

* commit 'c35f0e8495e34c2082dcde805e9323c9f6a4cb0a':
  au: Reorder code so that both muxer and demuxer are under #ifdefs
  fate: Move RALF test into lossless audio group
  cosmetics: Use consistent names for multiple inclusion guards.

Conflicts:
libavformat/au.c
tests/fate/lossless-audio.mak
tests/fate/real.mak

Merged-by: Michael Niedermayer <michaelni@gmx.at>

wtv: permit root table and first sectors to be located beyond 2GB boundary

Fixes ticket #2025.

Signed-off-by: Peter Ross <pross@xvid.org>

nutdec: sanity check r_frame_rate

This fixes files that store a somewhat incorrect value.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

configure: formatting cosmetics

h264: use mbaff ref indices in fill_colmap() only for mbaff references

Prevents writing beyond array bounds.

Signed-off-by: Janne Grunau <janne-libav@jannau.net>

h264: prevent decoding of slice NALs in extradata

It is not posible to call get_buffer during frame-mt codec
initialization. Libavformat might pass huge amounts of data as
extradata after parsing broken files. The 'extradata' for the fuzzed
sample sample_varPAR_s5374_r001-02.avi is 2.8M large and contains
multiple slices.

Fix "bistream" typo and add a check in tools/patcheck.

doc/ffmpeg-bitstream-filters: fix typo in title

Fix typo in mvc decoder.

mjpegenc: fix restart interval parameters for yuv444

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

mjpegenc: fix YUV444 with w%16!=0

Fixes Ticket2040

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

doc/indevs: update syntax for the color filter in the lavfi device examples

doc/texi2pod: correctly handle @url commands in the form @url{URL,...}

Ignore the other arguments, which have not to be processed by the POD
renderer.

doc/Makefile: add docclean rule

This allows to clean the doc directory from the parent project dir.
The command:
make -C doc clean

does not work as long as the paths specified in doc/Makefile are relative
to the parent dir.

Also it is consitent with "testclean" and "distclean" targets.

doc/texi2pod: add support to @ifhtml and @ifnothtml directives

With these commands it is possible to add HTML and non-HTML snippets,
which will be useful for the "See Also" manual chapters.

doc: remove references to external documents

Fix a few warnings generated when creating the manuals.

Our current doc generation toolchain does not allow to reference external
documents.

oggparsevorbis: check channels

Fixes out of array accesses

Found-by: Mateusz "j00ru" Jurczyk and Gynvael Coldwind
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

SAP muxer set session name from metadata

Pass "title" metadata field to av_sdp_create (as in RTP muxer) in SAP
muxer for correct
session name in SAP SDP announcements.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

concatdec: change data type to suppress warning about limited range of data type on some platforms.

Reviewed-by: Nicolas George <nicolas.george@normalesup.org>
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

doxy: Clarify what avpriv_set_pts_info does

The "pts for a given stream" was nonsensical.

Signed-off-by: Derek Buitenhuis <derek.buitenhuis@gmail.com>

doxy: Clarify what avpriv_set_pts_info does

The "pts for a given stream" was nonsensical.

Signed-off-by: Derek Buitenhuis <derek.buitenhuis@gmail.com>

au: Reorder code so that both muxer and demuxer are under #ifdefs

This reduces code size when either piece has been disabled.

fate: Move RALF test into lossless audio group

cosmetics: Use consistent names for multiple inclusion guards.

Merge remote-tracking branch 'ramiro/dshow'

* ramiro/dshow:
  dshow: call CoUninitialize() on dshow_read_close()
  dshow: handle events in graph

Merged-by: Michael Niedermayer <michaelni@gmx.at>

Merge remote-tracking branch 'qatar/master'

* qatar/master:
  avresample: use valid log context in mixing functions
  lavr: remove automatic context close/open for resampling compensation

Merged-by: Michael Niedermayer <michaelni@gmx.at>

Merge commit 'f322b2073581119de5da74f92a03309a36891cfa'

* commit 'f322b2073581119de5da74f92a03309a36891cfa':
  lavr: only save/restore the mixing matrix if mixing is being done
  rtpdec_vp8: Cosmetics: Fix bad alignment/indentation
  rtpenc: Allow including a SDES/CNAME block in RTCP SR packets

Merged-by: Michael Niedermayer <michaelni@gmx.at>

Merge commit '65e053271a98f7acf3ef6b412998cfcb44a8eef8'

* commit '65e053271a98f7acf3ef6b412998cfcb44a8eef8':
  rtpenc_vp8: Include the picture number in VP8 packets

Merged-by: Michael Niedermayer <michaelni@gmx.at>

siff: set duration

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

isom: support SGI RLE 8-bit in QuickTime file format

Signed-off-by: Peter Ross <pross@xvid.org>

Silicon Graphics Movie (.mv) demuxer

Signed-off-by: Peter Ross <pross@xvid.org>

Silicon Graphics Motion Video Compressor 1 & 2 decoder

Signed-off-by: Peter Ross <pross@xvid.org>

SGI RLE 8-bit decoder

Signed-off-by: Peter Ross <pross@xvid.org>

dshow: call CoUninitialize() on dshow_read_close()

Every call to CoInitialize should have a matching CoUnititalize.

Based on patch by Don Moir <donmoir@comcast.net>.

dshow: handle events in graph

Handling DirectShow events prevents infinite loops when there is an error in
the graph, such as a device being disconnected. This makes it possible for
dshow to return an error to the caller and run the cleanup code.

Based on patch by Don Moir <donmoir@comcast.net>.

avresample: use valid log context in mixing functions

Signed-off-by: Justin Ruggles <justin.ruggles@gmail.com>

sctp: dont abort on invalid input

Fixes Ticket1865

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

ac3dec: fix outptr increment.

Fixes decoding regression

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

lavr: only save/restore the mixing matrix if mixing is being done

lavr: remove automatic context close/open for resampling compensation

It adds unnecessary complication for insignificant usability improvement.
The user really should know if they'll need resampling compensation before
opening the context.

Note that only the documentation has changed. The current functionality will
still work until the next major bump.

h264: Improve first slice and slice type checks

This prevents a null pointer dereference

Found-by: Mateusz "j00ru" Jurczyk and Gynvael Coldwind
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

doc/examples/resampling_audio.c: fix path

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

swr/doxy: fix missing quote in code example.

lavu/pixdesc: fix a const qualifier discarding warning.

lavu: make sure av_pix_fmt_desc_next returns a valid pix fmt.

This is required because there are some "holes" in the list for
compatibility with the fork.

The commit also removes the now unecessary check from cmdutils.

Found-by: wm4

rtpdec_vp8: Cosmetics: Fix bad alignment/indentation

Signed-off-by: Martin Storsjö <martin@martin.st>

rtpenc: Allow including a SDES/CNAME block in RTCP SR packets

Signed-off-by: Martin Storsjö <martin@martin.st>

rtpenc_vp8: Include the picture number in VP8 packets

This makes it easier for receivers to decide what to do if data
is lost.

Refactor calculating the max payload size, to avoid hardcoding the
header size in too many places, reducing the number of lines that
have to be touched if the header is adjusted further.

Signed-off-by: Martin Storsjö <martin@martin.st>

bfi: set duration

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

brstm: ask for samples for version != 1.0

This also avoids 2 unused variable warnings.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

mjpegenc: fix 444 block count so it is below 10

Fixes Ticket1990

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

brstm: add missing new line to request for sample messages

Signed-off-by: Paul B Mahol <onemda@gmail.com>

doc/filters: fix "Dolby Pro Logic II" option name

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

Merge remote-tracking branch 'qatar/master'

* qatar/master:
  h264: fix memleak on error during SPS parsing

Merged-by: Michael Niedermayer <michaelni@gmx.at>

lavfi/crop: free x and y parsed expression objects

Fix leak introduced in 1e5492ffe6609fa0059d1a64fb3c4d5fd285a88c.

Merge commit '27c8337e595a058347150269d5c2c48281e4285b'

* commit '27c8337e595a058347150269d5c2c48281e4285b':
  h264-mt: handle NAL_DPAs before calling ff_thread_finish_setup
  lavr: move AudioMix struct definition to audio_mix.c
Merged-by: Michael Niedermayer <michaelni@gmx.at>

build: fix idf demuxer dependency

Signed-off-by: Paul B Mahol <onemda@gmail.com>

Remove 8SVX_RAW on next lavc mayor bump

Signed-off-by: Paul B Mahol <onemda@gmail.com>

aiff: support in24/in32 tags

Supported by QuickTime, libaudiofile and Csound.

brstm: fix number of samples for the last block

Signed-off-by: James Almer <jamrial@gmail.com>

thp: set duration

ffplay: provide some feedback in case the codec cannot be set

ffplay: set codec_id in codec context

Set codec id in case another codec is forced on the context (e.g. when
the user specify the codec with -codec).

For example fix:
ffplay -vcodec pgmyuv -i "tests/vsynth1/%02d.pgm"

ffplay: improve robustness of opt_codec(), and add options acodec,vcodec,scodec

Fail with a meaningfull error message in case of bogus input.

Also the new options are more consistent with the rest of the tool
options, since it does not support generic stream specifiers.

ffmpeg: Improve filter input fps selection heuristic.

This fixes a broken file that has a incorrect timebase at the codec level.

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

wrap_timestamp: remove unneeded check

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

lavf: fix integer overflows

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

h264: dont mess with frame gaps on second fields.

Fixes assertion failure

Found-by: Mateusz "j00ru" Jurczyk and Gynvael Coldwind
Signed-off-by: Michael Niedermayer <michaelni@gmx.at>

ffmpeg: replace magic number with VSYNC_CFR

lavf: Provide a monotonic timestamp to the outside world

Signed-off-by: Michael Niedermayer <michaelni@gmx.at>