From c0ce1e45b0d8fc8528f246f2fa1e953b2e639a09 Mon Sep 17 00:00:00 2001 From: Aryan Salmanpour Date: Wed, 18 Sep 2024 12:56:20 -0400 Subject: [PATCH] update docs (#56) * update docs * remove extra line * clean up --- CHANGELOG.md | 51 +++++++++++++++------------------------- docs/index.rst | 26 +++++++++++--------- docs/install/install.rst | 31 +++++++----------------- 3 files changed, 42 insertions(+), 66 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8311c7d323..55bb9bd2f3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,39 +1,26 @@ # rocJPEG changelog Documentation for rocJPEG is available at -[https://rocm.docs.amd.com/projects/rocJPEG/en/latest/](TBD) +[https://rocm.docs.amd.com/projects/rocJPEG/en/latest/](https://rocm.docs.amd.com/projects/rocJPEG/en/latest/) -## rocJPEG 0.3.0 (Unreleased) - -## Additions - -* Changelog.md - -## Optimizations - -* Setup Script - Error Check install & cleanup +## rocJPEG 0.6.0 ### Changes -* Dependencies - Updates to core dependencies -* LibVA Headers - Use public headers -* mesa-amdgpu-va-drivers - RPM Package available on RPM from ROCm 6.2 -* add the RocJpegDecodeParams struct for passing the decode parameters - -### Fixes - -* Package deps -* RHEL/SLES - Additional required packages `mesa-amdgpu-dri-drivers libdrm-amdgpu` - -### Tested configurations - -* Linux - * Ubuntu - `20.04` / `22.04` - * RHEL - `8` / `9` -* ROCm: - * rocm-core - `6.1.0.60100-64` - * amdgpu-core - `1:6.1.60100-1741643` -* libva-dev - `2.7.0-2` / `2.14.0-1` -* mesa-amdgpu-va-drivers - `1:24.1.0` -* mesa-amdgpu-dri-drivers - `24.1.0.60200` -* rocJPEG Setup Script - `V2.1.0` +* Supported initial enablement of the rocJPEG library +* Supported JPEG chroma subsampling: + * YUV 4:4:4 + * YUV 4:4:0 + * YUV 4:2:2 + * YUV 4:2:0 + * YUV 4:0:0 +* Supported various output image format: + * Native (i.e., native unchanged output from VCN Hardware, it can be either packed YUV or planar YUV)​ + * YUV planar​ + * Y only​ + * RGB​ + * RGB planar +* Supported single-image and batch-image decoding​ +* Supported Different partition modes on MI300 series​ +* Supported region-of-interest (ROI) decoding​ +* Supported color space conversion from YUV to RGB \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index 03ff7bc5d8..924d55ecf4 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -10,9 +10,7 @@ rocJPEG provides APIs and samples that you can use to easily access the JPEG dec features of your media engines (VCNs). It also allows interoperability with other compute engines on the GPU using Video Acceleration API (VA-API)/HIP. To learn more, see :doc:`what-is-rocJPEG` -You can access rocJPEG code on our `GitHub repository `_. - -Our documentation is structured as follows: +The code is open and hosted at `GitHub repository `_. .. grid:: 2 :gutter: 3 @@ -22,22 +20,28 @@ Our documentation is structured as follows: * :doc:`Quick-start <./install/quick-start>` * :doc:`rocJPEG installation <./install/install>` +The documentation is structured as follows: + +.. grid:: 2 + :gutter: 3 + + .. grid-item-card:: Tutorials + + * `GitHub samples `_ + + .. grid-item-card:: How to + + * :doc:`Use rocJPEG ` + .. grid-item-card:: API reference * :doc:`API library <../doxygen/html/files>` * :doc:`Functions <../doxygen/html/globals>` * :doc:`Data structures <../doxygen/html/annotated>` - .. grid-item-card:: How to - - * :doc:`Use rocJPEG ` - - .. grid-item-card:: Tutorials - - * `GitHub samples `_ To contribute to the documentation, refer to `Contributing to ROCm `_. You can find licensing information on the -`Licensing `_ page. +`Licensing `_ page. \ No newline at end of file diff --git a/docs/install/install.rst b/docs/install/install.rst index e32f048351..31a518a2c8 100644 --- a/docs/install/install.rst +++ b/docs/install/install.rst @@ -9,15 +9,6 @@ Installation rocJPEG is a high performance JPEG decode SDK for AMD GPUs. Using the rocJPEG API, you can access the JPEG decoding features available on your GPU. -Supported JPEG chroma subsampling -======================================== - -* YUV 4:4:4 -* YUV 4:4:0 -* YUV 4:2:2 -* YUV 4:2:0 -* YUV 4:0:0 - Prerequisites ======================================== @@ -196,23 +187,17 @@ Docker You can find rocJPEG Docker containers in our `GitHub repository `_. -Documentation -======================================== - -Run the following code to build our documentation locally. - -.. code:: shell - - cd docs - pip3 install -r sphinx/requirements.txt - python3 -m sphinx -T -E -b html -d _build/doctrees -D language=en . _build/html - -For more information on documentation builds, refer to the -:doc:`Building documentation ` page. - Hardware capabilities =================================================== +* Supported JPEG chroma subsampling + + * YUV 4:4:4 + * YUV 4:4:0 + * YUV 4:2:2 + * YUV 4:2:0 + * YUV 4:0:0 + The following table shows the capabilities of the VCN and total number of JPEG cores for each supported GPU architecture.