From 53f3d68c6f11e95b2463893768ed1e5d8b42bedf Mon Sep 17 00:00:00 2001 From: Kiriti Gowda Date: Wed, 31 Jan 2024 13:56:17 -0800 Subject: [PATCH] Docs - Updates (#213) * Docs - Updates * Quick-start - Readme * Docs - updates * Docs - Change root * Docs - Fix root * cleanup --- README.md | 3 ++- docs/conf.py | 3 +++ docs/doxygen/Doxyfile | 2 +- docs/rocDecodeUserGuide.md | 2 +- docs/sphinx/_toc.yml.in | 9 +++++++++ 5 files changed, 16 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8e8fb11ea2..1fed5398c1 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,7 @@ [![MIT licensed](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT) -

+ +

rocDecode is a high performance video decode SDK for AMD GPUs. rocDecode API lets developers access the video decoding features available on the GPU. diff --git a/docs/conf.py b/docs/conf.py index 7fe7a309ba..4bbf9ef86d 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -27,6 +27,7 @@ # https://www.sphinx-doc.org/en/master/usage/configuration.html import re +import shutil from rocm_docs import ROCmDocs @@ -37,6 +38,8 @@ with open('../CMakeLists.txt', encoding='utf-8') as f: version_number = match[1] left_nav_title = f"rocDecode {version_number} Documentation" +shutil.copy2('../README.md','./quickStart.md') + # for PDF output on Read the Docs project = "rocDecode Documentation" author = "Advanced Micro Devices, Inc." diff --git a/docs/doxygen/Doxyfile b/docs/doxygen/Doxyfile index 55022dccda..6fc3ba8e99 100644 --- a/docs/doxygen/Doxyfile +++ b/docs/doxygen/Doxyfile @@ -944,7 +944,7 @@ WARN_LOGFILE = # Note: If this tag is empty the current directory is searched. INPUT = ../../README.md \ - ../../api/rocDecode.h \ + ../../api/rocdecode.h \ ../../api/rocparser.h \ ../../utils/rocvideodecode/roc_video_dec.h \ ../../utils/video_demuxer.h diff --git a/docs/rocDecodeUserGuide.md b/docs/rocDecodeUserGuide.md index f754fb1d74..432aae88dc 100644 --- a/docs/rocDecodeUserGuide.md +++ b/docs/rocDecodeUserGuide.md @@ -58,7 +58,7 @@ Table 1: Hardware video decoder capabilities ## Chapter 3: Video decoding pipeline -

+

There are three main components in the rocDecode shown in the figure above: Demuxer, Video Parser APIs, and Video Decode APIs. The Demuxer is based on FFMPEG. The demuxer extracts a segment of video data and sends it to the Video Parser. The parser then extracts crucial information such as picture and slice parameters, which is then sent to the Decoder APIs. These APIs submit the information to the hardware for the decoding of a frame. This process repeats in a loop until all frames have been decoded. diff --git a/docs/sphinx/_toc.yml.in b/docs/sphinx/_toc.yml.in index 6e151a7b14..05661b35ce 100644 --- a/docs/sphinx/_toc.yml.in +++ b/docs/sphinx/_toc.yml.in @@ -2,6 +2,15 @@ # These comments will also be removed. root: doxygen/html/index subtrees: +- caption: Quick-start + entries: + - file: quickStart +- caption: API reference + entries: + - file: doxygen/html/files +- caption: Tutorials + entries: + - file: rocDecodeUserGuide - caption: About entries: - file: license