gecko-dev/third_party/dav1d
Dan Minor 8f20970320 Bug 1588123 - Update libdav1d to head; r=TD-Linux
This updates libdav1d to commit 5595102721d3c298d7cee64e64878486a3b8bdad.

Differential Revision: https://phabricator.services.mozilla.com/D50205

--HG--
rename : third_party/dav1d/snap/snapcraft.yaml => third_party/dav1d/package/snap/snapcraft.yaml
extra : moz-landing-system : lando
2019-10-24 18:58:15 +00:00
..
doc Bug 1557528 - Import dav1d from upstream to version 0.4.0. r=TD-Linux 2019-06-18 20:52:59 +00:00
examples Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
include Bug 1582743 - Update dav1d from upstream to commit c0865f3. r=TD-Linux 2019-09-23 18:02:33 +00:00
package/snap Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
src Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
tests Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
tools Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
.gitlab-ci.yml Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
CONTRIBUTING.md Bug 1509453 - Update dav1d from upstream to b53a99b9. r=TD-Linux 2018-12-19 18:11:14 +00:00
COPYING Bug 1533559 - Update libdav1d to 0.2.1. r=achronop 2019-03-19 17:35:09 +00:00
NEWS Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
README.md Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
THANKS.md Bug 1557528 - Import dav1d from upstream to version 0.4.0. r=TD-Linux 2019-06-18 20:52:59 +00:00
dav1d_logo.png Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
meson.build Bug 1588123 - Update libdav1d to head; r=TD-Linux 2019-10-24 18:58:15 +00:00
meson_options.txt Bug 1582743 - Update dav1d from upstream to commit c0865f3. r=TD-Linux 2019-09-23 18:02:33 +00:00

README.md

dav1d logo

dav1d

dav1d is a new AV1 cross-platform decoder, open-source, and focused on speed and correctness.

The canonical repository URL for this repo is https://code.videolan.org/videolan/dav1d

This project is partially funded by the Alliance for Open Media/AOM.

Goal and Features

The goal of this project is to provide a decoder for most platforms, and achieve the highest speed possible to overcome the temporary lack of AV1 hardware decoder.

It supports all features from AV1, including all subsampling and bit-depth parameters.

In the future, this project will host simple tools or simple wrappings (like, for example, an MFT transform).

License

dav1d is released under a very liberal license, a contrario from the other VideoLAN projects, so that it can be embedded anywhere, including non-open-source software; or even drivers, to allow the creation of hybrid decoders.

The reasoning behind this decision is the same as for libvorbis, see RMS on vorbis.

Roadmap

The plan is the folllowing:

Reached

  1. Complete C implementation of the decoder,
  2. Provide a usable API,
  3. Port to most platforms,
  4. Make it fast on desktop, by writing asm for AVX-2 chips.

On-going

  1. Make it fast on mobile, by writing asm for ARMv8 chips,
  2. Make it fast on older desktop, by writing asm for SSE chips.

After

  1. Improve C code base with various tweaks,
  2. Accelerate for less common architectures,
  3. Use more GPU, when possible.

Contribute

Currently, we are looking for help from:

  • C developers,
  • asm developers,
  • platform-specific developers,
  • GPGPU developers,
  • testers.

Our contributions guidelines are quite strict. We want to build a coherent codebase to simplify maintenance and achieve the highest possible speed.

Notably, the codebase is in pure C and asm.

We are on IRC, on the #dav1d channel on Freenode.

See the contributions document.

CLA

There is no CLA.

People will keep their copyright and their authorship rights, while adhering to the BSD 2-clause license.

VideoLAN will only have the collective work rights.

CoC

The VideoLAN Code of Conduct applies to this project.

Compile

  1. Install Meson (0.47 or higher), Ninja, and, for x86* targets, nasm (2.13.02 or higher)
  2. Run mkdir build && cd build to create a build directory and enter it
  3. Run meson .. to configure meson, add --default-library=static if static linking is desired
  4. Run ninja to compile

Run tests

  1. In the root directory, run git clone https://code.videolan.org/videolan/dav1d-test-data.git tests/dav1d-test-data to fetch the test data repository
  2. During meson configuration, specify -Dtestdata_tests=true
  3. Run meson test -v after compiling

Support

This project is partially funded by the Alliance for Open Media/AOM and is supported by TwoOrioles and VideoLabs.

These companies can provide support and integration help, should you need it.

FAQ

Why do you not improve libaom rather than starting a new project?

  • We believe that libaom is a very good library. It was however developed for research purposes during AV1 design. We think that an implementation written from scratch can achieve faster decoding, in the same way that ffvp9 was faster than libvpx.

Is dav1d a recursive acronym?

  • Yes.

Can I help?

I am not a developer. Can I help?

  • Yes. We need testers, bug reporters, and documentation writers.

What about the AV1 patent license?

  • This project is an implementation of a decoder. It gives you no special rights on the AV1 patents.

Please read the AV1 patent license that applies to the AV1 specification and codec.

Will you care about <my_arch>? <my_os>?

  • We do, but we don't have either the time or the knowledge. Therefore, patches and contributions welcome.