Skip to content
C Rust Other
Branch: master
Clone or download
Pull request Compare This branch is 1 commit ahead, 1483 commits behind xiph:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
aom_build
benches
data
src
tests
.gitignore
.gitmodules
.travis.yml
Cargo.toml
LICENSE
PATENTS
README.md
build.rs
build.sh
rustfmt.toml

README.md

The fastest and safest AV1 encoder.

Build Status

Overview

rav1e is an experimental AV1 video encoder. It is designed to eventually cover all use cases, though in its current form it is most suitable for cases where libaom (the reference encoder) is too slow.

Because AV1 is not yet frozen, it relies on an exact decoder version and configuration that is periodically updated.

Features

  • Intra frames
  • 64x64 superblocks
  • H, V, and DC prediction modes
  • 4x4 DCT and ADST transforms
  • ~5 fps encoding @ 480p (see issue #124)

Building

This repository uses a git submodule, to initialize it, do:

git submodule update --init

This is also required everytime you switch branch or pull code and the submodule changed.

In order to build the codec, you need two libraries: wxWidgets 3.0 and yasm. To install these on Ubuntu or Linux Mint, run:

sudo apt install libwxgtk3.0-dev libwxgtk3.0-0v5-dbg yasm

Compressing video

Input videos must be 8-bit 4:2:0, in y4m format.

cargo run --bin rav1e -- input.y4m -o output.ivf

Decompressing video

mkdir aom_test
cd aom_test
../aom_build/aom/configure --disable-av1-encoder --enable-debug --enable-experimental --disable-unit-tests --disable-aom_qm --disable-ext-intra --disable-ext_partition --disable-ext_partition_types --disable-loopfilter_level --disable-intra_edge --disable-cfl --disable-kf-ctx --disable-striped_loop_restoration --disable-max_tile --disable-ext-intra-mod --disable-frame_size --disable-simplify_tx_mode --disable-obu --disable-filter-intra --disable-ext_skip --disable-lv_map --disable-lv_map_multi --disable-horzonly_frame_superres
make -j8
./aomdec ../output.ivf -o output.y4m

Design

  • src/lib.rs - The top level library, contains code to write headers, manage buffers, and iterate throught each superblock.
  • src/ec.rs - Low-level implementation of the entropy coder, which directly writes the bitstream.
  • src/context.rs - High-level functions that write symbols to the bitstream, and maintain context.
  • src/partition.rs - Functions and enums to manage partitions (subdivisions of a superblock).
  • src/predict.rs - Intra prediction implementations.
  • src/quantize.rs - Quantization and dequantization functions for coefficients.
  • src/transform.rs - Implementations of DCT and ADST transforms.
  • src/bin/rav1e.rs - rav1e command line tool.
  • src/bin/rav1erepl.rs - Command line tool for debugging.
  • aom_build/ - Local submodule of libaom. Some C functions and constants are used directly. Also used for benchmarking and testing.
You can’t perform that action at this time.