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

The ``simaaimetaparser`` GStreamer plugin parses metadata from input buffers and re-attaches it to output buffers. It can extract metadata from either a custom GStreamer metadata structure or directly from the buffer header, depending on the presence of the custom metadata. The plugin also supports KPI transmission for performance monitoring.

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 is used within a GStreamer pipeline. It takes a buffer as input and produces a buffer as output, with updated metadata. The input buffer’s format is not restricted by the parser.

**Example gst-launch-1.0 snippet:**

.. code:: bash

   gst-launch-1.0 filesrc location=input.h264 ! h264parse ! simaaimetaparser ! fakesink

In this example, ``filesrc`` reads an H.264 video file, ``h264parse`` parses it, ``simaaimetaparser`` processes the metadata, and ``fakesink`` consumes the result. Replace ``input.h264`` with your input file.

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.

Integration into GStreamer Pipeline
-----------------------------------

The ``simaaimetaparser`` plugin acts as a transformation element in a GStreamer pipeline. It sits between elements that produce buffers containing metadata and elements that consume those buffers. The plugin expects input buffers to contain metadata and will extract information such as frame IDs, timestamps and buffer IDs, either from a custom GStreamer metadata structure or from the buffer header. After processing, it attaches updated metadata to the output buffer and passes the buffer downstream in the pipeline.