Gst-nvvideo4linux2
===================

DeepStream extends the open source V4L2 codec plugins (here called ``Gst-v4l2``) to support hardware-accelerated codecs.

.. image:: /content/DS_plugin_gst-nvvideo4linux2.png
         :align: center
         :alt: Gst-nvvideo4linux2


Decoder
--------

The OSS Gst-nvvideo4linux2 plugin leverages the hardware decoding engines on Jetson and DGPU platforms by interfacing with libv4l2 plugins on those platforms. It supports H.264, H.265, JPEG and MJPEG formats.
The plugin accepts an encoded bitstream and uses the NVDEC hardware engine to decode the bitstream. The decoded output is in NV12 format.

.. note:: When you use the v4l2 decoder for decoding JPEG images, you must use the open source jpegparse plugin before the decoder to parse encoded JPEG images.


Inputs and Outputs
~~~~~~~~~~~~~~~~~~~

* Inputs

  *	An encoded bitstream. Supported formats are H.264, H.265, JPEG and MJPEG

* Control Parameters
  
  *	gpu-id
  *	num-extra-surfaces
  *	skip-frames
  *	cudadec-memtype
  *	drop-frame-interval
  *	low-latency-mode

* Output
  
  *	Gst Buffer with decoded output in NV12 format


Features
~~~~~~~~~~

The following table summarizes the features of the Gst-nvvideo4linux2 decoder plugin.

.. csv-table:: Gst-nvvideo4linux2 plugin decoder features 
  :file: ../text/tables/Gst-nvvideo4linux2 tables/DS_Plugin_gst-nvvideo4linux2_decoder_features.csv
  :widths: 30, 30, 30
  :header-rows: 1



Gst Properties
~~~~~~~~~~~~~~~

The following table summarizes the Gst properties of the Gst-nvvideo4linux2 decoder plugin.

.. csv-table:: Gst-nvvideo4linux2 plugin decoder gst properties 
  :file: ../text/tables/Gst-nvvideo4linux2 tables/DS_Plugin_gst-nvvideo4linux2_decoder_gst-properties.csv
  :widths: 20, 20, 20, 20, 20
  :header-rows: 1


Encoder
---------

The OSS Gst-nvvideo4linux2 plugin leverages the hardware accelerated encoding engine available on Jetson and dGPU platforms by interfacing with libv4l2 plugins on those platforms. The plugin accepts RAW data in I420 format. It uses the NVENC hardware engine to encode RAW input. Encoded output is in elementary bitstream supported format.

Inputs and Outputs
~~~~~~~~~~~~~~~~~~~~

* Inputs
  RAW input in I420 format

* Control parameters

  *	gpu-id (dGPU only)
  *	profile
  *	bitrate
  *	control-rate
  *	iframeinterval

* Output
  
  *	Gst Buffer with encoded output in H264 and H265 format.

Features
~~~~~~~~~

The following table summarizes the features of the Gst-nvvideo4linux2 encoder plugin.

.. csv-table:: Gst-nvvideo4linux2 plugin encoder features 
  :file: ../text/tables/Gst-nvvideo4linux2 tables/DS_Plugin_gst-nvvideo4linux2_encoder_features.csv
  :widths: 30, 30, 30
  :header-rows: 1

Gst Properties
~~~~~~~~~~~~~~~

The following table summarizes the Gst properties of the Gst-nvvideo4linux2 encoder plugin.

.. csv-table:: Gst-nvvideo4linux2 plugin encoder gst properties 
  :file: ../text/tables/Gst-nvvideo4linux2 tables/DS_Plugin_gst-nvvideo4linux2_encoder_gst-properties.csv
  :widths: 20, 20, 20, 20, 20
  :header-rows: 1