# rocDecode
rocDecode is a high performance video decode SDK for AMD hardware


## Prerequisites:

* Linux distribution
  + Ubuntu - `20.04` / `22.04`

* [ROCm supported hardware](https://rocm.docs.amd.com/en/latest/release/gpu_os_support.html)

* Install [ROCm 5.5 or later](https://rocmdocs.amd.com/en/latest/deploy/linux/installer/install.html) with `--usecase=graphics,rocm --no-32`

* CMake `3.5` or later

* libva-dev `2.7` or later
  ```
  sudo apt install libva-dev
  ```

* [FFMPEG](https://ffmpeg.org/about.html)
  ```
  sudo apt install ffmpeg libavcodec-dev libavformat-dev libswscale-dev
  ```

* **Note** [rocDecode-setup.py](rocDecode-setup.py) script can be used for installing all the dependencies

## Build instructions:
Please follow the instructions below to build and install the rocDecode library.

```
 cd rocDecode
 mkdir build; cd build
 cmake ..
 make -j8
 sudo make install
```

* run tests
  ```
  make test
  ```
  **NOTE:** run tests with verbose option `make test ARGS="-VV"`

* make package
  ```
  sudo make test package
  ```

## Samples:
The tool provides a few samples to decode videos [here](samples/). Please refer to the individual folders to build and run the samples.

## Docker:
Docker files to build rocDecode containers are available [here](docker/)

## Documentation

Run the steps below to build documentation locally.

* Doxygen 
```
doxygen .Doxyfile
```

## Tested configurations

* Linux distribution
  + Ubuntu - `20.04` / `22.04`
* ROCm: 
  + rocm-core - `5.6.1.50601-93`
  + amdgpu-core - `1:5.6.50601-1649308`
* FFMPEG - `4.2.7` / `4.4.2-0`
* libva-dev - `2.7.0-2` / `2.14.0-1`
* rocDecode Setup Script - `V1.1`