revcx/revc

The fastest and safest EVC encoder and decoder

The fastest and safest EVC encoder and decoder

Table of Content

• Overview
• Features
• Roadmap
• Usage
  • Compressing video
  • Decompressing video
  • Benchmark
• Contributing

Overview

MPEG-5 Essential Video Coding (EVC) baseline profile is royalty-free. It includes only technologies that are more than 20 years old or that were submitted with a royalty-free declaration. Compared to H.264/AVC High Profile (JM19.0), MPEG-5 EVC Baseline Profile (ETM 6.1) provides about 30% BD-rate reduction with reduced encoding computation complexity and comparable decoding computation complexity.

REVC is a Rust-based EVC (baseline) video codec implementation.

Features

• Coding Structure
  • Quad-tree based coding structure up to 64x64 block size
• Intra Prediction
  • DC, horizontal (H), vertical (V), diagonal left (DL), diagonal right (DR) for intra prediction
• Inter Prediction
  • Un-directional and Bi-directional inter prediction
  • Temporal direct mode
  • Three spatial neighbouring motion vectors and one temporally co-located motion vector
  • 1/2 and 1/4-pel interpolation
• Transform and Quantization
  • 4x4 to 64x64 DCT
  • QP range: 0 to 51
  • Run/level symbols with zig-zag scan
• Loop Filter
  • Deblocking filter in H.263 Annex J
• Entropy Coding
  • Binary arithmetic coding scheme in JPEG Annex D

Roadmap

• 0.1 Translation:
  • Translate ETM baseline decoder from C to Rust
  • Translate ETM baseline encoder from C to Rust
• 0.2 Optimization:
  • profiling and benchmarking
  • memory/cache optimization
  • assembly optimization
    • armeabi-v7a
    • arm64-v8a
    • x86
    • x86_64
  • multi-threading optimization
• 0.3 Modernization
  • rate control
  • practical usecases: RTC, Live Streaming, VOD, etc

Usage

Compressing video

Input videos can be in raw yuv (I420) format or y4m format. The monochrome color format is not supported yet.

cargo run --release --bin revce -- -i scripts/foreman_qcif8.yuv -w 176 -h 144 -z 30 -f 8 -q 27 -r scripts/tmp/rec.yuv --keyint 8 --ref_pic_gap_length 8 --skip 0 --disable_dbf --inter_slice_type 1 -o scripts/tmp/test_ld_p.evc -v
cargo run --release --bin revce -- -i scripts/foreman_qcif8.y4m                     -f 8 -q 27 -r scripts/tmp/rec.y4m --keyint 8 --ref_pic_gap_length 8 --skip 0               --inter_slice_type 0 -o scripts/tmp/test_ld_b.evc -v

Decompressing video

Decoder only supports MPEG-5 EVC baseline profile. Output videos can be in raw yuv (I420) format or y4m format

cargo run --release --bin revcd -- -i scripts/tmp/test_ld_p.evc -o scripts/tmp/test.yuv -v
cargo run --release --bin revcd -- -i scripts/tmp/test_ld_b.evc -o scripts/tmp/test.y4m -v

Benchmark

Benchmark each component with Criterion.

cargo bench --features bench

Contributing

Contributors or Pull Requests are Welcome!!!

revc's Issues

[revcd] hawktracer identify evc_itrans temp buffer issue with 64x64 size

evc_itrans use temp buffer max 64x64 size, but for small transform unit, such as 4x4, it wasters memory and initialization time

[revc] create benches to benchmark different components

benchmark components: mc, plane, ipred, rdo, itdq, tq, df, etc

revc::api::frame::Aligned::default unsoundly creates uninitalised values of arbitrary type

Sample code:

fn main() {
    let value: &&u32 = revc::api::frame::Aligned::<&&u32>::default().data;
    dbg!(**value);
}

This crashes on my machine with a segfault.

I needed to load the library from git in order to cause this, looks like this function didn't exist on 0.2.0 which is the latest release I see from crates.io

[revcx] add multi-slices support

Add WebAssembly CI

Hello !

Thank you for this very interesting project !
Can we add also a job to validate the WebAssembly compilation ?

Right now it works perfectly, but with optimisation addition it can be great to check every time the compilation on this target.

If required I can help you on that via contributions.

Best,
Marc-Antoine

[revce] add PSNR computation

[revcx] handle correctly crop window for both encoder and decoder

[revcx][test] randomize encoder config and parameters to test both encoder and decoder

[revcd] add correct timestamp handling for input pkt and output frm

(Not an Issue) Request for Help!

Hello,

I've been looking for the EVC software repository in the MPEG Gitlab server but i can't find (seems to be in a private repository). I would be very grateful if you could point me in the right direction or share the Test Model release source code with me.

Thanks!

[revcx] optimize motion compensation without std::cmp::max()

[revcd] optimize sequence_init CPU issue

according to hawktracer profiling, sequence_init takes significant CPU time due to those maps allocation and initialization.