GStreamer pre-record element - Getting Started - Evaluating GStreamer pre-record element
| GStreamer pre-record element |
|---|
|
| Overview |
| User Guide |
| Getting Started |
| Examples |
| Contact Us |
This page is a guide to test the GstPreRecord 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
- gst-launch-1.0 --gst-version
- uname -a
Features in the Evaluation
RidgeRun provides an evaluation binary of the plug-in. The following table summarizes the features available in both the professional and evaluation version of the element.
| Feature | Professional | Evaluation |
|---|---|---|
| Unlimited Processing Time | Y | N |
| Source Code | Y | N |
(1) The evaluation version will limit the processing time of each pad to 2 minutes.
Dependencies
GstPreRecord has the following dependencies:
- Gstreamer 1.0
- GStreamer 1.0 Development Package
- Gstreamer 1.0 Base Plug-ins Development Package
Install the Evaluation Binaries
Extract the tarball provided by RidgeRun (note that the file names can change depending on the software version and target platform):
tar -xvf gst-prerecord-1.5.0-gst-1.14-aarch64-linux-gnu-eval.tar
The evaluation files structure should be as follows (note that the file names can change depending on the software version and target platform): gst-prerecord-1.5.0-gst-1.14-aarch64-linux-gnu-eval
└── usr
└── lib
└── aarch64-linux-gnu
├── gstreamer-1.0
└── libgstprerecord.so
The plugin binary is libgstprerecord.so. In order to use the binaries provided, export the location of the plugin in your environment.
export GST_PLUGIN_PATH=${GST_PLUGIN_PATH}:<absolute path to the directory containing the plugin binary libgstprerecord.so>
where <absolute path to the directory containing the plugin binary libgstprerecord.so>is the locations in your file system where you have the binaries provided by RidgeRun.
Finally, test that the plugin is being properly picked up by GStreamer by running:
gst-inspect-1.0 prerecordsink
Expected output:
***************************************
**** THIS IS AN EVALUATION VERSION ****
***************************************
Thanks for evaluating GstPreRecordSink!
The pipeline will lag for 5 seconds
before starting. Similarly, after
approximately 5 minutes the steam
will stop. Please contact
<support@ridgerun.com> to purchase
the professional version of the
plug-in.
***************************************
**** THIS IS AN EVALUATION VERSION ****
***************************************
Factory Details:
Rank none (0)
Long-name PreRecordSink
Klass Generic
Description Pre-records data continuously into a FIFO and creates an MP4 video file when trigger is enabled
Author RidgeRun <support@ridgerun.com>
Plugin Details:
Name prerecord
Description GStreamer Pre-Record plugin
Filename /usr/lib/x86_64-linux-gnu/gstreamer-1.0/libgstprerecord.so
Version 1.5.0
License Proprietary
Source module gst-prerecord
Binary package GstPreRecord
Origin URL http://www.ridgerun.com
GObject
+----GInitiallyUnowned
+----GstObject
+----GstElement
+----GstBin
+----GstPreRecordSink
Implemented Interfaces:
GstChildProxy
Pad Templates:
SINK template: 'sink%d'
Availability: On request
Capabilities:
ANY
Element has no clocking capabilities.
Element has no URI handling capabilities.
Pads:
none
Element Properties:
name : The name of the object
flags: readable, writable
String. Default: "prerecordsink0"
parent : The parent of the object
flags: readable, writable
Object of type "GstObject"
async-handling : The bin will handle Asynchronous state changes
flags: readable, writable
Boolean. Default: false
message-forward : Forwards all children messages
flags: readable, writable
Boolean. Default: false
buf-time : Minimum amount of data that will be buffered - may contain more (in ms, 0=disable)
flags: readable, writable
Unsigned Integer64. Range: 0 - 18446744073709551615 Default: 0
max-buf-time : Exact amount of data that will be buffered (in ms, 0=disable)
flags: readable, writable
Unsigned Integer64. Range: 0 - 18446744073709551615 Default: 0
post-rec-time : Max time to record after buffering (in ms, 0=buf_time)
flags: readable, writable
Unsigned Integer64. Range: 0 - 18446744073709551615 Default: 0
buffering : Whether to keep buf-time buffers (buffering) or to pass the buffereddata downstream (debuffering)
flags: readable, writable
Boolean. Default: true
on-key-frame : Wait for a video key frame to start debuffering.
flags: readable, writable
Boolean. Default: false
location : Format for the location of the files to write
flags: readable, writable
String. Default: null
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.