No description
Find a file
Clément Bœsch e0d56f097f checkasm: use perf API on Linux ARM*
On ARM platforms, accessing the PMU registers requires special user
access permissions. Since there is no other way to get accurate timers,
the current implementation of timers in FFmpeg rely on these registers.
Unfortunately, enabling user access to these registers on Linux is not
trivial, and generally involve compiling a random and unreliable github
kernel module, or patching somehow your kernel.

Such module is very unlikely to reach the upstream anytime soon. Quoting
Robin Murphin from ARM:

> Say you do give userspace direct access to the PMU; now run two or more
> programs at once that believe they can use the counters for their own
> "minimal-overhead" profiling. Have fun interpreting those results...
>
> And that's not even getting into the implications of scheduling across
> different CPUs, CPUidle, etc. where the PMU state is completely beyond
> userspace's control. In general, the plan to provide userspace with
> something which might happen to just about work in a few corner cases,
> but is meaningless, misleading or downright broken in all others, is to
> never do so.

As a result, the alternative is to use the Performance Monitoring Linux
API which makes use of these registers internally (assuming the PMU of
your ARM board is supported in the kernel, which is definitely not a
given...).

While the Linux API is obviously cross platform, it does have a
significant overhead which needs to be taken into account. As a result,
that mode is only weakly enabled on ARM platforms exclusively.

Note on the non flexibility of the implementation: the timers (native
FFmpeg vs Linux API) are selected at compilation time to prevent the
need of function calls, which would result in a negative impact on the
cycle counters.
2017-09-08 18:51:05 +02:00
compat compat/cuda/ptx2c: strip CR from each line 2017-08-30 11:20:34 +02:00
doc avfilter: add Haas stereo enhancer 2017-09-08 18:29:53 +02:00
ffbuild build: Allow generating dependencies as a side-effect of assembling 2017-06-21 17:00:29 -03:00
libavcodec avcodec/vp9: Add tile threading support 2017-09-08 10:25:40 -04:00
libavdevice lavd: drop QTKit indev 2017-09-04 17:19:58 +02:00
libavfilter avfilter: add Haas stereo enhancer 2017-09-08 18:29:53 +02:00
libavformat avformat/asfdec: Fix DoS in asf_build_simple_index() 2017-09-07 15:19:22 +02:00
libavresample build: Generalize yasm/nasm-related variable names 2017-06-21 17:00:29 -03:00
libavutil avcodec/mips: Improve vp9 mc msa functions 2017-09-08 13:48:40 +02:00
libpostproc postproc: remove usage of deprecated QP_STORE_T define 2017-08-30 14:44:27 -03:00
libswresample swresample/resample: Fix flush refelction length 2017-08-16 00:54:17 +02:00
libswscale utils: Do not expand a macro with 'defined' in it 2017-08-25 13:44:57 +01:00
presets presets: remove moldering iPod presets 2014-06-17 16:15:04 -08:00
tests checkasm: use perf API on Linux ARM* 2017-09-08 18:51:05 +02:00
tools build: Generalize yasm/nasm-related variable names 2017-06-21 17:00:29 -03:00
.gitattributes fate: add SCC test 2017-01-27 17:06:42 +01:00
.gitignore build: add support for building .cu files via nvcc 2017-05-15 11:46:50 +02:00
.travis.yml build: Prefer NASM assembler over YASM 2017-06-21 17:00:30 -03:00
Changelog avfilter: add Haas stereo enhancer 2017-09-08 18:29:53 +02:00
cmdutils.c avformat, ffmpeg: deprecate old rotation API 2017-03-27 13:20:27 +02:00
cmdutils.h Merge commit '122de16dd8' 2017-05-05 14:04:30 +02:00
cmdutils_opencl.c cmdutils_opencl: Fix read of uinitialized cl_mem 2017-05-11 13:02:12 +02:00
configure checkasm: use perf API on Linux ARM* 2017-09-08 18:51:05 +02:00
CONTRIBUTING.md Add CONTRIBUTING.md 2016-09-18 10:02:13 +01:00
COPYING.GPLv2
COPYING.GPLv3
COPYING.LGPLv2.1
COPYING.LGPLv3
CREDITS
ffmpeg.c ffmpeg: send EOF pts to filters. 2017-09-08 10:31:07 +02:00
ffmpeg.h dxva: add support for new dxva2 and d3d11 hwaccel APIs 2017-06-27 18:05:02 +02:00
ffmpeg_cuvid.c ffmpeg_cuvid: adapt for recent filter graph initialization changes 2017-03-03 08:45:43 +01:00
ffmpeg_filter.c ffmpeg: Support setting the hardware device to use when filtering 2017-06-14 22:27:07 +01:00
ffmpeg_hw.c avconv_hw: Free device on initialisation failure 2017-06-18 17:07:25 +01:00
ffmpeg_opt.c ffmpeg_opt: add proper deprecation guards to lowres code 2017-08-30 22:45:00 -03:00
ffmpeg_qsv.c ffmpeg: init filtergraphs only after we have a frame on each input 2017-03-03 08:45:43 +01:00
ffmpeg_videotoolbox.c ffmpeg_videotoolbox: fix usage of av_get_codec_tag_string() 2017-03-29 14:49:29 +02:00
ffplay.c ffplay: add support for more SDL pixel formats when rendering video 2017-08-10 22:08:40 +02:00
ffprobe.c ffprobe: use consistent string for unspecified color_range value 2017-09-07 13:26:44 +02:00
ffserver.c Merge commit '122de16dd8' 2017-05-05 14:04:30 +02:00
ffserver_config.c ffserver_config: Check for failure to allocate FFServerIPAddressACL 2016-12-22 19:23:08 +01:00
ffserver_config.h ffsrever: Make the status page bitexact if any stream is bitexact 2016-11-29 19:26:26 +01:00
INSTALL.md INSTALL: add markdown syntax 2014-05-28 22:38:38 +02:00
LICENSE.md Merge commit '4fef648d10' 2017-03-15 22:07:47 +01:00
MAINTAINERS lavd: drop QTKit indev 2017-09-04 17:19:58 +02:00
Makefile dxva: add support for new dxva2 and d3d11 hwaccel APIs 2017-06-27 18:05:02 +02:00
README.md Add CONTRIBUTING.md 2016-09-18 10:02:13 +01:00
RELEASE Bump minor versions for master after release/3.3 branchpoint 2017-03-31 13:21:06 +02:00

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 a mean to alter decoded Audio and Video through chain of 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.
  • ffserver is a multimedia streaming server for live broadcasts.
  • 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.