simaaimetaparser
================

The ``simaaimetaparser`` plugin acts as a transformation element in a GStreamer pipeline. It sits between python based plugins that do not pass through custom metadata and plugins that require it. The plugin expects input buffers to contain metadata and will extract information such as frame IDs, timestamps and buffer IDs from a custom GStreamer metadata structure. After processing, it attaches updated metadata to the output buffer and passes the buffer downstream in the pipeline.

Properties
----------

========= ======= ======= =====================================================================================
Property  Type    Default Description
========= ======= ======= =====================================================================================
silent    boolean FALSE   If TRUE, suppresses verbose output.
transmit  boolean FALSE   If TRUE, enables KPI transmission.
dump-data boolean FALSE   If TRUE, dumps the contents of the output buffer to ``/tmp/`` for debugging purposes.
========= ======= ======= =====================================================================================

Usage
-----

The ``simaaimetaparser`` plugin doesn’t expect any configuration. **Example gst-launch-1.0 snippet:**

.. code:: bash

   gst-launch-1.0 simaaidecoder ... ! python_plugin ! simaaimetaparser ! ... ! simaaiencoder

In this example, ``simaaidecoder`` attaches custom metadata to its output buffers. The ``python_plugin`` does not pass this metadata through directly; instead, it re-injects the metadata into its own output buffer. The ``simaaimetaparser`` then extracts this attached metadata and propagates it downstream as a structured metadata object alongside the buffer’s payload.

Installation
------------

To install the ``simaaimetaparser`` plugin, copy the plugin library from ``/usr/local/simaai/plugin_zoo/gst-simaai-plugins-base/gst/`` into your project’s ``plugins/`` folder.