Evaluating GstObuMetadata

From RidgeRun Developer Wiki


Previous: Getting Started Index Next: Getting Started/Getting the code





Requesting the Evaluation Binary

RidgeRun can provide you with an evaluation binary of the GstObuMetadata plugin to help you test it, in order to request an evaluation binary please contact us.


Features of the Evaluation

To help you test our GstObu plugin, RidgeRun can provide an evaluation version of the plugin.

The following table summarises the features available in both the professional and evaluation version of the element.

Feature Professional Evaluation
ObuInject Element Y Y
ObuExtract Element Y Y
ObuMetatester Element Y Y
Unlimited Processing Time Y N (1)
Source Code Y N
Table 1. Features provided in the evaluation version

(1) The evaluation version will limit the processing time to a maximum of 2500 frames.

Evaluating the plugin

First, make sure the dependencies are fulfilled.

Gstreamer 1.22

Check the current gstreamer version with the following command:

gst-launch-1.0 --version

If the version is lower to 1.22 uninstall the current version and build GStreamer following the Building from source guide.

Eval Binary Installation

Once the requirements above are fulfilled, proceed with the installation of the tarball. RidgeRun should've provided you with the following compressed tar package:

gst-obu-metadata-X.Y.Z-P-J-eval.tar.gz

Extract the contents of the file with the following command:

tar -xvzf <path-to-evaluation-tar-file>

Execute the test environment configuration script:

cd gst-obu-metadata-X.Y.Z-P-J-eval/
./configuration.sh

Eval Binary Testing

Finally, test that the plugin is being properly picked up by GStreamer by running:

gst-inspect-1.0 obu

The expected output is:


Plugin Details:
  Name                     obu
  Description              Gstreamer plugin to add metadata as Open Bitstream Units (OBU)
  Filename                 /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libobu.so
  Version                  0.1.0
  License                  Proprietary
  Source module            gst-obu
  Binary package           gst-obu
  Origin URL               https://www.ridgerun.com/

  obuextract: OBU extract metadata
  obuinject: OBU inject metadata
  obumetatester: Helper element to insert a test GstObuMeta to buffers.

  3 features:
  +-- 3 elements

Example Pipelines

Please refer to the Examples page for reference pipelines.

Troubleshooting

The first level of debug to troubleshoot a failing evaluation binary is to inspect GStreamer debug output.

GST_DEBUG=2 gst-launch-1.0

If the output doesn't help you figure out the problem, please contact support@ridgerun.com with the output of the GStreamer debug and any additional information you consider useful.



Previous: Getting Started Index Next: Getting Started/Getting the code