[libcamera-devel] [PATCH] README.rst: Update gstreamer element guidance

Kieran Bingham kieran.bingham at ideasonboard.com
Wed Aug 25 12:27:48 CEST 2021


The Gstreamer gstlibcamerasrc element operates better with the
glimagesink, as it can perform direct renders or hardware accellerated
image format conversion.

Further extend the sample commands to demonstrate how to specify a fixed
width and height parameter to the pipeline.

Signed-off-by: Kieran Bingham <kieran.bingham at ideasonboard.com>
---
 README.rst | 19 +++++++++++++++++--
 1 file changed, 17 insertions(+), 2 deletions(-)

diff --git a/README.rst b/README.rst
index fcf0f47f14c5..61ba8418a62a 100644
--- a/README.rst
+++ b/README.rst
@@ -94,7 +94,7 @@ Using GStreamer plugin
 ~~~~~~~~~~~~~~~~~~~~~~
 
 To use GStreamer plugin from source tree, set the following environment so that
-GStreamer can find it.
+GStreamer can find it, (This can be skipped when libcamera is installed)
 
   export GST_PLUGIN_PATH=$(pwd)/build/src/gstreamer
 
@@ -104,7 +104,22 @@ onto the default video display element on your system.
 
 .. code::
 
-  gst-launch-1.0 libcamerasrc camera-name="Camera 1" ! videoconvert ! autovideosink
+  gst-launch-1.0 libcamerasrc camera-name="Camera 1" ! glimagesink
+
+To show the first camera found you can omit the camera-name property, or you
+can identify the camera and capabilities using:
+
+.. code::
+
+  gst-device-monitor-1.0 Video
+
+This will show the supported stream sizes which can be manually selected if
+desired with a pipeline such as:
+
+.. code::
+
+  gst-launch-1.0 libcamerasrc ! 'video/x-raw,width=1280,height=720' ! \
+        glimagesink
 
 .. section-end-getting-started
 
-- 
2.30.2



More information about the libcamera-devel mailing list