FFmpeg git repo
Go to file
Ben Avison 2698bfdc93 checkasm: Add vc1dsp inverse transform tests
This test deliberately doesn't exercise the full range of inputs described in
the committee draft VC-1 standard. It says:

input coefficients in frequency domain, D, satisfy   -2048 <= D < 2047
intermediate coefficients, E, satisfy                -4096 <= E < 4095
fully inverse-transformed coefficients, R, satisfy    -512 <= R <  511

For one thing, the inequalities look odd. Did they mean them to go the
other way round? That would make more sense because the equations generally
both add and subtract coefficients multiplied by constants, including powers
of 2. Requiring the most-negative values to be valid extends the number of
bits to represent the intermediate values just for the sake of that one case!

For another thing, the extreme values don't look to occur in real streams -
both in my experience and supported by the following comment in the AArch32
decoder:

    tNhalf is half of the value of tN (as described in vc1_inv_trans_8x8_c).
    This is done because sometimes files have input that causes tN + tM to
    overflow. To avoid this overflow, we compute tNhalf, then compute
    tNhalf + tM (which doesn't overflow), and then we use vhadd to compute
    (tNhalf + (tNhalf + tM)) >> 1 which does not overflow because it is
    one instruction.

My AArch64 decoder goes further than this. It calculates tNhalf and tM
then does an SRA (essentially a fused halve and add) to compute
(tN + tM) >> 1 without ever having to hold (tNhalf + tM) in a 16-bit element
without overflowing. It only encounters difficulties if either tNhalf or
tM overflow in isolation.

I haven't had sight of the final standard, so it's possible that these
issues were dealt with during finalisation, which could explain the lack
of usage of extreme inputs in real streams. Or a preponderance of decoders
that only support 16-bit intermediate values in their inverse transforms
might have caused encoders to steer clear of such cases.

I have effectively followed this approach in the test, and limited the
scale of the coefficients sufficient that both the existing AArch32 decoder
and my new AArch64 decoder both pass.

Signed-off-by: Ben Avison <bavison@riscosopen.org>
Signed-off-by: Martin Storsjö <martin@martin.st>
2022-04-01 10:03:33 +03:00
compat Replace all occurences of av_mallocz_array() by av_calloc() 2021-09-20 01:03:52 +02:00
doc doc/bitstream_filters: fix for the syntax of code 2022-03-30 23:08:10 +08:00
ffbuild Fix libversion.sh for split version headers, to unbreak shared library builds 2022-03-17 11:11:17 +02:00
fftools fftools/opt_cmdutils: fix printing known channel layouts 2022-03-25 08:42:45 -03:00
libavcodec avcodec/vp9_superframe_split_bsf: Don't read inexistent data 2022-03-31 10:48:50 +02:00
libavdevice avdevice/dshow: fix regression 2022-03-29 23:25:33 +02:00
libavfilter avfilter/vf_libplacebo: update for new tone mapping API 2022-03-31 11:55:53 +02:00
libavformat avformat/libsrt: use a larger buffer for find_info_tag 2022-03-30 10:30:02 +08:00
libavutil avutil/channel_layout: return earlier on UNSPEC layouts in av_channel_layout_subset() 2022-03-25 17:10:39 -03:00
libpostproc Keep including the full version.h when headers are included externally 2022-03-19 00:01:57 +02:00
libswresample swresample/rematrix: fix typo in clean_layout() 2022-03-28 00:07:42 -03:00
libswscale Keep including the full version.h when headers are included externally 2022-03-19 00:01:57 +02:00
presets
tests checkasm: Add vc1dsp inverse transform tests 2022-04-01 10:03:33 +03:00
tools avcodec/codec_internal: Add FFCodec, hide internal part of AVCodec 2022-03-21 01:33:09 +01:00
.gitattributes
.gitignore gitignore: add config_components.h 2022-03-17 18:35:41 -03:00
.mailmap
.travis.yml
CONTRIBUTING.md
COPYING.GPLv2
COPYING.GPLv3
COPYING.LGPLv2.1
COPYING.LGPLv3
CREDITS
Changelog avformat: add DFPWM raw format 2022-03-10 14:11:12 +01:00
INSTALL.md
LICENSE.md
MAINTAINERS MAINTAINERS: add myself as maintainer for libsrt protocol 2022-04-01 09:21:50 +08:00
Makefile Makefile: check config_components.h when comparing timestamps in component list files 2022-03-17 18:35:41 -03:00
README.md README: fix typo and description of libavfilter 2021-10-08 09:44:34 +05:30
RELEASE
configure avcodec/bsf: Add FFBitStreamFilter, hide internals of BSFs 2022-03-23 23:45:45 +01:00

README.md

FFmpeg README

FFmpeg is a collection of libraries and tools to process multimedia content such as audio, video, subtitles and related metadata.

Libraries

  • libavcodec provides implementation of a wider range of codecs.
  • libavformat implements streaming protocols, container formats and basic I/O access.
  • libavutil includes hashers, decompressors and miscellaneous utility functions.
  • libavfilter provides means to alter decoded audio and video through a directed graph of connected filters.
  • libavdevice provides an abstraction to access capture and playback devices.
  • libswresample implements audio mixing and resampling routines.
  • libswscale implements color conversion and scaling routines.

Tools

  • ffmpeg is a command line toolbox to manipulate, convert and stream multimedia content.
  • ffplay is a minimalistic multimedia player.
  • ffprobe is a simple analysis tool to inspect multimedia content.
  • Additional small tools such as aviocat, ismindex and qt-faststart.

Documentation

The offline documentation is available in the doc/ directory.

The online documentation is available in the main website and in the wiki.

Examples

Coding examples are available in the doc/examples directory.

License

FFmpeg codebase is mainly LGPL-licensed with optional components licensed under GPL. Please refer to the LICENSE file for detailed information.

Contributing

Patches should be submitted to the ffmpeg-devel mailing list using git format-patch or git send-email. Github pull requests should be avoided because they are not part of our review process and will be ignored.