{"id":13492,"url":"https://patchwork.libcamera.org/api/patches/13492/?format=json","web_url":"https://patchwork.libcamera.org/patch/13492/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20210825195338.185663-1-kieran.bingham@ideasonboard.com>","date":"2021-08-25T19:53:38","name":"[libcamera-devel,v2] README.rst: Update gstreamer element guidance","commit_ref":null,"pull_url":null,"state":"accepted","archived":false,"hash":"a5efc84c6420d17e7d35ea9300de7d530e19edee","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/people/4/?format=json","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/13492/mbox/","series":[{"id":2395,"url":"https://patchwork.libcamera.org/api/series/2395/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=2395","date":"2021-08-25T19:53:38","name":"[libcamera-devel,v2] README.rst: Update gstreamer element guidance","version":2,"mbox":"https://patchwork.libcamera.org/series/2395/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/13492/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/13492/checks/","tags":{},"headers":{"Return-Path":"<libcamera-devel-bounces@lists.libcamera.org>","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 91641BD87D\n\tfor <parsemail@patchwork.libcamera.org>;\n\tWed, 25 Aug 2021 19:53:43 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 4DD8368893;\n\tWed, 25 Aug 2021 21:53:43 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 9F65660288\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 25 Aug 2021 21:53:42 +0200 (CEST)","from Monstersaurus.local\n\t(cpc89244-aztw30-2-0-cust3082.18-1.cable.virginm.net [86.31.172.11])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 4FAB924F;\n\tWed, 25 Aug 2021 21:53:42 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"LmB4rtzX\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1629921222;\n\tbh=uhrqhsGN10DIREyd3XXchpplrtTlBR8HIRElxBrv9uk=;\n\th=From:To:Cc:Subject:Date:From;\n\tb=LmB4rtzXrb5AJZ/tNxRM2nMPXNaeFIhuRDt0SHMJ4s8BUuzhOauzQfa0UR+KCLAZG\n\tVXVkVWqhBfjJWrbtE9ue6Qb/d7xIDP+r4LqKL/S3lfUpvleaa0VPvei+RJt1yH1H29\n\tmb1cvw0yMQD3aI969Yu3G7DLasBGBI1Tg3HB3VhE=","From":"Kieran Bingham <kieran.bingham@ideasonboard.com>","To":"libcamera devel <libcamera-devel@lists.libcamera.org>","Date":"Wed, 25 Aug 2021 20:53:38 +0100","Message-Id":"<20210825195338.185663-1-kieran.bingham@ideasonboard.com>","X-Mailer":"git-send-email 2.30.2","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH v2] README.rst: Update gstreamer element\n\tguidance","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"<libcamera-devel.lists.libcamera.org>","List-Unsubscribe":"<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>","List-Archive":"<https://lists.libcamera.org/pipermail/libcamera-devel/>","List-Post":"<mailto:libcamera-devel@lists.libcamera.org>","List-Help":"<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>","List-Subscribe":"<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"},"content":"The Gstreamer gstlibcamerasrc element operates better with the\nglimagesink, as it can perform direct renders or hardware accellerated\nimage format conversion.\n\nFurther extend the sample commands to demonstrate how to specify a fixed\nwidth and height parameter to the pipeline.\n\nSigned-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>\n\n---\n README.rst | 21 ++++++++++++++++++---\n 1 file changed, 18 insertions(+), 3 deletions(-)","diff":"diff --git a/README.rst b/README.rst\nindex fcf0f47f14c5..d5b36e21dec6 100644\n--- a/README.rst\n+++ b/README.rst\n@@ -94,17 +94,32 @@ Using GStreamer plugin\n ~~~~~~~~~~~~~~~~~~~~~~\n \n To use GStreamer plugin from source tree, set the following environment so that\n-GStreamer can find it.\n+GStreamer can find it. This isn't necessary when libcamera is installed.\n \n   export GST_PLUGIN_PATH=$(pwd)/build/src/gstreamer\n \n The debugging tool ``gst-launch-1.0`` can be used to construct a pipeline and\n test it. The following pipeline will stream from the camera named \"Camera 1\"\n-onto the default video display element on your system.\n+onto the OpenGL accelerated display element on your system.\n \n .. code::\n \n-  gst-launch-1.0 libcamerasrc camera-name=\"Camera 1\" ! videoconvert ! autovideosink\n+  gst-launch-1.0 libcamerasrc camera-name=\"Camera 1\" ! glimagesink\n+\n+To show the first camera found you can omit the camera-name property, or you\n+can identify the camera and capabilities using:\n+\n+.. code::\n+\n+  gst-device-monitor-1.0 Video\n+\n+This will also show the supported stream sizes which can be manually selected\n+if desired with a pipeline such as:\n+\n+.. code::\n+\n+  gst-launch-1.0 libcamerasrc ! 'video/x-raw,width=1280,height=720' ! \\\n+        glimagesink\n \n .. section-end-getting-started\n \n","prefixes":["libcamera-devel","v2"]}