FFmpeg git repo
Go to file
Niklas Haas b9a25963f7 lavfi: add ICC profile support via lcms2
This introduces an optional dependency on lcms2 into FFmpeg. lcms2 is a
widely used library for ICC profile handling, which apart from being
used in almost all major image processing programs and video players,
has also been deployed in browsers. As such, it's both widely available
and well-tested.

Add a few helpers to cover our major use cases. This commit merely
introduces the helpers (and configure check), even though nothing uses
them yet.

It's worth pointing out that the reason the cmsToneCurves for each
AVCOL_TRC are cached inside the context, is because constructing a
cmsToneCurve requires evaluating the curve at 4096 (by default) grid
points and constructing a LUT. So, we ideally only want to do this once
per curve. This matters for e.g. ff_icc_profile_detect_transfer, which
essentially compares a profile against all of these generated LUTs.
Re-generating the LUTs for every iteration would be unnecessarily
wasteful.

The same consideration does not apply to e.g. cmsCreate*Profile, which
is a very lightweight operation just involving struct allocation and
setting a few pointers.

The cutoff value of 0.01 was determined by experimentation. The lowest
"false positive" delta I saw in practice was 0.13, and the largest
"false negative" delta was 0.0008. So a value of 0.01 sits comfortaby
almost exactly in the middle.

Signed-off-by: Niklas Haas <git@haasn.dev>
2022-04-23 21:51:55 +02:00
compat Replace all occurences of av_mallocz_array() by av_calloc() 2021-09-20 01:03:52 +02:00
doc avcodec/libjxl: add Jpeg XL decoding via libjxl 2022-04-23 19:51:46 +02:00
ffbuild Fix libversion.sh for split version headers, to unbreak shared library builds 2022-03-17 11:11:17 +02:00
fftools doc/ffprobe: clarify that the input file is not optional 2022-04-21 12:34:04 +05:30
libavcodec avcodec/libjxl: add Jpeg XL encoding via libjxl 2022-04-23 19:51:46 +02:00
libavdevice avdevice/dshow: Fix dshow device name/description 2022-04-09 21:29:39 +02:00
libavfilter lavfi: add ICC profile support via lcms2 2022-04-23 21:51:55 +02:00
libavformat avformat/image2: add Jpeg XL as image2 format 2022-04-23 19:51:46 +02:00
libavutil avutil/timecode: use timecode fps for number of frame digits 2022-04-22 22:54:58 +02: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 swscale: aarch64: Optimize the final summation in the hscale routine 2022-04-22 10:49:46 +03:00
presets
tests fate/oma: Use REMUX where appropriate 2022-04-14 18:40:30 +02: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 mailmap: add entry for myself 2021-03-09 02:09:55 +00:00
.travis.yml Merge commit '899ee03088d55152a48830df0899887f055da1de' 2019-03-14 15:53:16 -03:00
CONTRIBUTING.md
COPYING.GPLv2
COPYING.GPLv3
COPYING.LGPLv2.1
COPYING.LGPLv3
CREDITS
Changelog avfilter: add colorchart video filter 2022-04-23 11:00:42 +02:00
INSTALL.md
LICENSE.md avfilter/vf_geq: Relicense to LGPL 2019-12-28 11:20:48 +01:00
MAINTAINERS avformat/image2: add Jpeg XL as image2 format 2022-04-23 19:51:46 +02: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 Bump Versions before release/4.4 branch 2021-03-20 01:01:12 +01:00
configure lavfi: add ICC profile support via lcms2 2022-04-23 21:51:55 +02: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.