.. _DS_plugin_nvvideoconvert:

Gst-nvvideoconvert
===================

This plugin performs video color format conversion. It accepts NVMM memory as well as RAW (memory allocated using ``calloc()`` or ``malloc()`` ), and provides NVMM or RAW memory at the output.

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

Inputs and Outputs
--------------------
* Inputs

  *	Gst Buffer batched buffer
  *	NvDsBatchMeta
  *	Format: (NVMM/RAW)
   * dGPU - NV12, I420, P010_10LE, BGRx, RGBA, GRAY8, RGB, BGR, Y444, Y444_10LE, Y444_12LE, BGR10A2_LE, UYVP, I420_12LE
   * Jetson - NV12, I420, P010_10LE, BGRx, RGBA, GRAY8, RGB, BGR, BGR10A2_LE, UYVP, UYVY, YUY2, YVYU, Y42B, I420_12LE


* Control parameters

  *	gpu-id (dGPU only)
  *	nvbuf-memory-type
  *	src-crop
  *	dst-crop
  *	interpolation-method
  *	compute-hw
  *	flip-method

* Output

  *	Gst Buffer
  *	NvDsBatchMeta
  *	Format: (NVMM/RAW)
   * dGPU - NV12, I420, P010_10LE, BGRx, RGBA, GRAY8, RGB, BGR, Y444, Y444_10LE, Y444_12LE, BGR10A2_LE, UYVP, I420_12LE
   * Jetson - NV12, I420, P010_10LE, BGRx, RGBA, GRAY8, RGB, BGR, BGR10A2_LE, UYVP, UYVY, YUY2, YVYU, Y42B, I420_12LE

.. note::
  * For 12bit NV12 format, the input/output caps shows I420_12LE. But the data is handled as semiplanar 12 bit data. This is a workaround since gstreamer v1.16 does not have the particular caps for 12 bit NV12. Downstream component should process it considering as 12bit NV12 only.
  * Only NVMM memory support is added for I420_12LE, Y444_10LE and Y444_12LE formats.

Features
--------
This plugin supports scaling and conversion for NVMM to NVMM, RAW to NVMM, and NVMM to RAW and RAW to RAW buffer type conversion. The plugin supports cropping of the input and output frames.

Gst Properties
---------------
The following table describes the Gst properties of the Gst-nvvideoconvert plugin.

 .. csv-table:: Gst-nvvideoconvert gst properties
   :file: ../text/tables/Gst-nvvideoconvert tables/DS_Plugin_gst-nvvideoconvert_gst-properties.csv
   :widths: 20, 20, 20, 20
   :header-rows: 1