Gst-nvmultistreamtiler
=======================

The Gst-nvmultistreamtiler plugin composites a 2D tile from batched buffers. The plugin accepts batched NV12/RGBA data from upstream components. The plugin composites the tile based on stream IDs, obtained from ``NvDsBatchMeta`` and ``NvDsFrameMeta`` in row-major order (starting from source 0, left to right across the top row, then across the next row). Each source frame is scaled to the corresponding location in the tiled output buffer. The plugin can reconfigure if a new source is added and it exceeds the space allocated for tiles. It also maintains a cache of old frames to avoid display flicker if one source has a lower frame rate than other sources.

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


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

* Inputs

   *	Gst Buffer batched buffer
   *	NvDsBatchMeta with Gst Buffer batched (batch is one or more buffers)
   *	Formats supported: NV12/RGBA

*	Control Parameters

   *	rows
   *	columns
   *	width
   *	height
   *	gpu-id (dGPU only)
   *	show-source
   *	nvbuf-memory-type
   *	custom-tile-config

*	Output

   *	Gst Buffer (single frame) with composited input frames
   *	Transformed metadata (NvDsBatchMeta)
   *	Formats supported: NV12/RGBA


Features
---------

The following table summarizes the features of the plugin.


.. csv-table:: Gst-nvmultistreamtiler features
    :file: ../content/tables/Gst-nvmultistreamtiler tables/DS_Plugin_gst-nvmultistreamtiler_features.csv
    :widths: 30, 30, 30
    :header-rows: 1


Gst Properties
---------------

The following table describes the Gst-nvmultistreamtiler plugin’s Gst properties.

.. csv-table:: Gst-nvmultistreamtiler gst properties
    :file: ../content/tables/Gst-nvmultistreamtiler tables/DS_Plugin_gst-nvmultistreamtiler_gst-properties.csv
    :widths: 25, 25, 25, 25
    :header-rows: 1