vvdec 0.3.0

Rust bindings for VVdeC
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# VVdeC-rs

Rust bindings for [VVdeC](https://github.com/fraunhoferhhi/vvdec).

**Work in progress**: the bindings are not stable yet and may change at any time. Stabilization will begin once integration with some framework is working (e.g. GStreamer).

## Sub-projects:
- vvdec-sys: unsafe bindings generated by bindgen
- vvdec: the safe bindings on top of vvdec-sys
- vvdecli: CLI application using the safe bindings to simply decode VVC bitstream files into YUV4MPEG

## Installing the CLI

In order to build, either VVdeC needs to be installed and be found via pkg-config, or the environment variable `VVDEC_SYS_BUILD_DEP_FROM_SRC=1` needs to be set to build VVdeC from source. On macOS, VVdeC can be installed with `brew install vvdec`.

Then, the CLI app can be installed with `cargo install vvdecli`.

If you have FFmpeg installed, you can then test vvdecli and play VVC with
```
vvdecli -i ./tests/short.vvc | ffplay -
```

## License

This crate is license under the [BSD-3-Clause-Clear](./LICENSE.txt) license, to maintain compatibility with [VVdeC's license](https://github.com/fraunhoferhhi/vvdec/blob/master/LICENSE.txt).