GStreamer Pan Tilt Zoom and Rotate Element - Evaluating GstPTZR

From RidgeRun Developer Wiki


Previous: Rectangle Index Next: Getting the code




This page serves as a guide to test the GstPTZR evaluation binary provided by RidgeRun.

Requesting the Evaluation Binary

In order to request an evaluation binary for a specific architecture, please contact us providing the following information:

  • Platform (i.e.: i.MX6, i.MX8, RB5/RB6 NVIDIA Jetson TX1/TX2, Ultrascale+, etc...)
  • gst-launch-1.0 --gst-version
  • uname -a

Features in the Evaluation

To help you test GStreamer PTZR, RidgeRun can provide an evaluation version of the plug-in. The following table summarizes the features available in both the professional and evaluation version of the element.

Feature Professional Evaluation
Real-time pan configuration Y Y
Real-time tilt configuration Y Y
Real-time zoom configuration Y Y
Real-time rotate configuration Y Y
Unlimited time Y N (1)
Source Code Y N
Table 1. Features provided in the evaluation version

(1) The evaluation version will limit the streaming time of each pad to 1 minute after a 5 seconds delay (at 30fps).


Testing the Binary

please make sure you also install the dependencies listed below :

sudo apt-get install gtk-doc-tools libgtk2.0-dev libgstreamer-plugins-base1.0-dev libglew-dev
sudo apt-get install gstreamer1.0-tools gstreamer1.0-plugins-base-dbg gstreamer1.0-plugins-good-dbg gstreamer1.0-plugins-bad-dbg gstreamer1.0-libav-dbg

RidgeRun should've provided you with a shared object:

GStreamer Plug-in
libgstptzr.so

In order to use the binary provided, export the location of the plugin in your environment.

export GST_PLUGIN_PATH=${GST_PLUGIN_PATH}:/path/to/evaluation/binary/plugin

where /path/to/evaluation/binary/plugin is the location in your file system where you have the plugin provided by RidgeRun. Additionally, you may just copy the binary into the standard GStreamer plug-in search path.

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

gst-inspect-1.0 ptzr

You should see the inspect output for the evaluation binary.

Example Pipelines

Please refer to the Examples page for reference pipelines.

Example Demo Tool

An example demo Python script is sent alongside the binary. For detailed instructions on how to use the script please refer to the Demo Tool page.

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.

If the plug-in is not being recognized, please provide the output of the following command:

gst-inspect-1.0 libgstptzr.so


Previous: Rectangle Index Next: Getting the code