GstSEIMetadata - User Guide

From RidgeRun Developer Connection
Jump to: navigation, search


Previous: Getting Started/Building GStreamer H264 - H265 Metadata Index Next: User Guide





Adding metadata support to your application involves two main tasks: on the sending side injecting metadata on the pipeline and for the receiving side extracting the metadata. In this section, we will review how to achieve this.

To inject metadata it's possible to use the RidgeRun Gstreamer element seiinject. Once you have the pipeline with a seiinject element, you can simply set the seiinject metadata property with the data you want to inject or use the seimetatester element that adds GstMeta messages to the buffer and seiinject takes that meta message and insert that data in the h264 buffer.

To extract metadata it's possible to use the RidgeRun Gstreamer element seiextract. Once you have the pipeline with a seiextract element, the seiextract element is going to take the metadata in the h264 buffer and add it as a GstMeta to the output buffer. Also includes a signal property for the metadata message.

seiinject element

The following pipeline uses the seiinject element to insert a message with Hello World, only insert the meta message to the first buffer.

gst-launch-1.0 videotestsrc ! x264enc ! seiinject metadata="Hello World" ! filesink location=seiinject_videotestsrc.h264 -v

The following pipeline uses the seiinject element and the seimetatester element to generate a GstMeta for every buffer with the seimetatester and add the GstMeta message to every h264 buffer with seiinject.

gst-launch-1.0 videotestsrc ! x264enc ! seimetatester ! seiinject metadata="Hello World" ! filesink location=seiinject_videotestsrc.h264 -v

seiextract element

The following pipeline use the seiextract to add GstMeta to the output buffer with the message Hello World.

gst-launch-1.0 videotestsrc ! x264enc ! seiinject metadata="Hello World" ! seiextract ! filesink location=seiinject_videotestsrc.h264 -v


Previous: Getting Started/Building GStreamer H264 - H265 Metadata Index Next: User Guide