Gst-nvds3dfilter
==========================

The Gst-nvds3dfilter plugin is a customizable plugin which provides a custom library interface to load compoment ``ds3d::datafilter``.

The Plugin is fully configured through YAML format content or file. ``sink_caps`` and ``src_caps`` is also configurable.

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

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

* Inputs

   * NvDs3DBuffer or
   * Metadata (NvDsBatchMeta) which has user meta NVDS_3D_DATAMAP_META_TYPE

* Control parameters

  *	config-file
  *	config-content

* Output

  * NvDs3DBuffer or
  * Metadata (NvDsBatchMeta) which has user meta NVDS_3D_DATAMAP_META_TYPE

* sink_caps

  * parsed from filed of ``in_caps: ds3d/datamap`` or any user specified ``in_caps:``.

* src_caps

  * parsed from filed of ``out_caps: ds3d/datamap`` or any user specified ``out_caps:``.

Custom library Interfaces
--------------------------
The plugin parse the config file or content and set SinkCaps and SrcCaps. load a custom ``ds3d::datafilter`` from ``custom_lib_path``. Create this datafilter by ``custom_create_function``.

See more details of ``ds3d::datafilter`` in DS3D Manual.

Configuration file Examples:
  ::

    name: point2cloud_datafilter
    type: ds3d::datafilter
    in_caps: ds3d/datamap
    out_caps: ds3d/datamap
    custom_lib_path: libnvds_3d_depth2point_datafilter.so
    custom_create_function: createDepth2PointFilter
    config_body:
      in_streams: [color, depth]

Gst-nvds3dfilter properties Specifications
----------------------------------------------------

.. csv-table:: Gst-nvds3dfilter Properties.
    :file: ../text/tables/Gst-nvds3dfilter tables/DS_Plugin_gst-nvds3dfilter_properties.csv
    :widths: 20, 20, 20
    :header-rows: 1