Aryan Salmanpour
130 строки
2.7 KiB
Markdown
130 строки
2.7 KiB
Markdown
# rocDecode
|
|
|
|
rocDecode is a high performance video decode SDK for AMD GPUs. rocDecode API lets developers access the video decoding features available on the GPU.
|
|
|
|
## Supported Codecs
|
|
|
|
* H.265 (HEVC) - 8 bit, and 10 bit
|
|
|
|
## 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
|
|
|
|
```shell
|
|
sudo apt install libva-dev
|
|
```
|
|
|
|
* libdrm-dev `2.4` or later
|
|
|
|
```shell
|
|
sudo apt install libdrm-dev
|
|
```
|
|
|
|
* libstdc++-12-dev
|
|
|
|
```shell
|
|
sudo apt install libstdc++-12-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.
|
|
|
|
```shell
|
|
cd rocDecode
|
|
mkdir build; cd build
|
|
cmake ..
|
|
make -j8
|
|
sudo make install
|
|
```
|
|
|
|
* run tests - Requires `FFMPEG` install
|
|
|
|
```shell
|
|
make test
|
|
```
|
|
|
|
**NOTE:** run tests with verbose option `make test ARGS="-VV"`
|
|
|
|
* make package
|
|
|
|
```shell
|
|
sudo make test package
|
|
```
|
|
|
|
## Verify Installation
|
|
|
|
The installer will copy
|
|
|
|
* Libraries into `/opt/rocm/lib`
|
|
* Header files into `/opt/rocm/include/rocdecode`
|
|
* Samples folder into `/opt/rocm/share/rocdecode`
|
|
* Documents folder into `/opt/rocm/share/doc/rocdecode`
|
|
|
|
Build and run sample
|
|
|
|
```shell
|
|
mkdir rocdecode-sample && cd rocdecode-sample
|
|
cmake /opt/rocm/share/rocdecode/samples/videoDecode/
|
|
make -j8
|
|
./videodecode -i /opt/rocm/share/rocdecode/video/AMD_driving_virtual_20-H265.mp4
|
|
```
|
|
**NOTE:** FFMPEG install required to run samples
|
|
|
|
## Samples
|
|
|
|
The tool provides a few samples to decode videos [here](samples/). Please refer to the individual folders to build and run the samples.
|
|
|
|
### Sample Prerequisites
|
|
|
|
* [FFMPEG](https://ffmpeg.org/about.html) - required to run sample applications & make test
|
|
|
|
```shell
|
|
sudo apt install ffmpeg libavcodec-dev libavformat-dev libavutil-dev
|
|
```
|
|
|
|
## Docker
|
|
|
|
Docker files to build rocDecode containers are available [here](docker/)
|
|
|
|
## Documentation
|
|
|
|
Run the steps below to build documentation locally.
|
|
|
|
* Sphinx
|
|
|
|
```shell
|
|
cd docs
|
|
pip3 install -r sphinx/requirements.txt
|
|
python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html
|
|
```
|
|
|
|
* Doxygen
|
|
|
|
```shell
|
|
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`
|
|
* libva-dev - `2.7.0-2` / `2.14.0-1`
|
|
* libdrm-dev - `2.4.107` / `2.4.113`
|
|
* FFMPEG - `4.2.7` / `4.4.2-0`
|
|
* rocDecode Setup Script - `V1.3`
|