..
   Copyright (c) 2022, NVIDIA CORPORATION. All rights reserved.
   NVIDIA CORPORATION and its licensors retain all intellectual property
   and proprietary rights in and to this software, related documentation
   and any modifications thereto. Any use, reproduction, disclosure or
   distribution of this software and related documentation without an express
   license agreement from NVIDIA CORPORATION is strictly prohibited.

.. _VideoDecoderExtension:

VideoDecoderExtension
---------------------
NVIDIA GXF component for H.264 video decode.
The video Decoder GXF extension is based on V4L2 APIs.
It uses the hardware video Decode engine on the platform by interfacing with V4L2 APIs.
It gives out decoded yuv frame.

* UUID: edc99001-73bd-435c-af0c-e013dcda3439
* Version: 0.0.1
* Author: NVIDIA
* License: Proprietary

Components
~~~~~~~~~~~~

nvidia::gxf::VideoDecoder
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Decode ``H.264`` video streams using ``V4l2`` APIs.

* Component ID: edc99001-73bd-435c-af0c-e013dcda3439
* Base Type: nvidia::gxf::VideoDecoder

Parameters
++++++++++++

**image_receiver**

Receiver to get the input data(receive compressed data)

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::gxf::Receiver

|

**output_transmitter**

Transmitter to publish the output yuv data(video buffer)

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::gxf::Transmitter

|

**pool**

Memory pool for allocating output data.

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_HANDLE
* Handle Type: nvidia::gxf::Allocator

|

**inbuf_storage_type**

Input buffer storage type

Valid values:

  0: Host memory

  1: Device memory

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_INT32

|

**outbuf_storage_type**

Output buffer storage type

Valid values:

  0: Host memory

  1: Device memory

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_INT32

|

**Device**

Path to the V4L2 device,

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_STRING
* Default: "/dev/nvidia0"

|

**codec**

Video codec to be used

Valid values:

  0: H.264 codec

* Flags: GXF_PARAMETER_FLAGS_NONE
* Type: GXF_PARAMETER_TYPE_INT32
* Default: 0