.. meta::
  :description: rocDecode documentation and API reference library
  :keywords: rocDecode, ROCm, API, documentation, video, decode, decoding, acceleration

********************************************************************
rocDecode documentation
********************************************************************

rocDecode provides APIs, utilities, and samples that you can use to easily access the video decoding
features of your media engines (VCNs). It also allows interoperability with other compute engines on
the GPU using Video Acceleration API (VA-API)/HIP. 

rocDecode is delivered as part of `TheRock <https://github.com/ROCm/TheRock>`_. The rocDecode source code is located at https://github.com/ROCm/rocm-systems/tree/develop/projects/rocdecode.

.. grid:: 2
  :gutter: 3

  .. grid-item-card:: Install

    * :doc:`Install rocDecode <./install/rocDecode-install>`
    * :doc:`Build from source <./install/rocDecode-build-and-install>`

.. grid:: 2
  :gutter: 3

  .. grid-item-card:: Conceptual

    * :doc:`rocDecode decoding pipeline <./conceptual/rocDecode-decoding-pipelines>`
    * :doc:`rocDecode surface memory locations <./conceptual/rocDecode-memory-types>`

  .. grid-item-card:: How to

    * :doc:`Understand the rocDecode videodecode.cpp sample <./how-to/using-rocDecode-videodecode-sample>`
    * :doc:`Understand the rocDecode rocdecdecode.cpp sample <./how-to/using-rocDecode-rocdecdecoder>`    
    * :doc:`Use the rocDecode RocVideoDecoder <./how-to/using-rocDecode-video-decoder>`
    * :doc:`Use the rocDecode FFmpeg demultiplexer <./how-to/using-rocDecode-ffmpeg>`
    * :doc:`Use the rocDecode bitstream reader APIs <./how-to/using-rocDecode-bitstream>` 
   

  .. grid-item-card:: Samples

    * :doc:`rocDecode samples <./tutorials/rocDecode-samples>`

  .. grid-item-card:: Reference

    * :doc:`The rocDecode core APIs <./reference/rocDecode-core-APIs>`

      * :doc:`The rocDecode parser API <./reference/rocDecode-parser>`
      * :doc:`The rocDecode hardware decoder API <./reference/rocDecode-hw-decoder>`
      * :doc:`The rocDecode software decoder API <./reference/rocDecode-sw-decoder>`
    
    * :doc:`The rocDecode utility classes <./reference/rocDecode-utility-classes>`

      * :doc:`The rocDecode RocVideoDecoder<./reference/rocDecode-util-decoder>`
      * :doc:`The rocDecode demultiplexer <./reference/rocDecode-demux>`
      * :doc:`The rocDecode FFMpeg decoder <./reference/rocDecode-ffmpeg-decoder>`

    * :doc:`rocDecode logging levels <./reference/rocDecode-logging-control>`
    * :doc:`rocDecode environment variables <./reference/rocDecode-env-vars>`
    * :doc:`rocDecode codec support and hardware capabilities <./reference/rocDecode-formats-and-architectures>`
    * :doc:`API library <../doxygen/html/files>`
    * :doc:`Functions <../doxygen/html/globals>`
    * :doc:`Data structures <../doxygen/html/annotated>`
  
To contribute to the documentation, refer to
`Contributing to ROCm <https://rocm.docs.amd.com/en/latest/contribute/contributing.html>`_.

You can find licensing information on the
`Licensing <https://rocm.docs.amd.com/en/latest/about/license.html>`_ page.