Show a patch.

GET /api/patches/15459/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 15459,
    "url": "https://patchwork.libcamera.org/api/patches/15459/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/15459/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/projects/1/?format=api",
        "name": "libcamera",
        "link_name": "libcamera",
        "list_id": "libcamera_core",
        "list_email": "libcamera-devel@lists.libcamera.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20220316141316.926035-1-kieran.bingham@ideasonboard.com>",
    "date": "2022-03-16T14:13:16",
    "name": "[libcamera-devel] README: Extend gstreamer examples",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": false,
    "hash": "ad6e3ecdb0a0193e52ea70a3baf62584310a72e6",
    "submitter": {
        "id": 4,
        "url": "https://patchwork.libcamera.org/api/people/4/?format=api",
        "name": "Kieran Bingham",
        "email": "kieran.bingham@ideasonboard.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/15459/mbox/",
    "series": [
        {
            "id": 2967,
            "url": "https://patchwork.libcamera.org/api/series/2967/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=2967",
            "date": "2022-03-16T14:13:16",
            "name": "[libcamera-devel] README: Extend gstreamer examples",
            "version": 1,
            "mbox": "https://patchwork.libcamera.org/series/2967/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/15459/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/15459/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\r\n\t[92.243.16.209])\r\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id B11E4BF415\r\n\tfor <parsemail@patchwork.libcamera.org>;\r\n\tWed, 16 Mar 2022 14:13:22 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\r\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 1030A604DB;\r\n\tWed, 16 Mar 2022 15:13:22 +0100 (CET)",
            "from perceval.ideasonboard.com (perceval.ideasonboard.com\r\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\r\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 47D6660475\r\n\tfor <libcamera-devel@lists.libcamera.org>;\r\n\tWed, 16 Mar 2022 15:13:20 +0100 (CET)",
            "from Monstersaurus.ksquared.org.uk.beta.tailscale.net\r\n\t(cpc89244-aztw30-2-0-cust3082.18-1.cable.virginm.net [86.31.172.11])\r\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id C96213E4;\r\n\tWed, 16 Mar 2022 15:13:19 +0100 (CET)"
        ],
        "DKIM-Signature": [
            "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\r\n\ts=mail; t=1647440002;\r\n\tbh=GSrPOp/8aRRDiVRKJjQN979llIgAsWDOxAAQf9IB7+o=;\r\n\th=To:Date:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post:\r\n\tList-Help:List-Subscribe:From:Reply-To:From;\r\n\tb=AllCSxGvihvLS7ERgdHWE2VJ2xjtrZTzwtxtGW504HihYCzZgg9MxATNdiJWoKd+4\r\n\tVdRRcQxk1kA6ZbJm19Mq/WRTUXfVLnpe/R8RsXOtKm8QFMR/920/jboNkk5fjctzI+\r\n\tOuRpCRjZqyBBSXKsdYEGozWyFKehOvOjShGDGCnKCAJWDouoofPKZBnYCSkQeUImpS\r\n\tEh8axgFw2BD/pvY9guIMCVYfRIsz15cCsv8CV5TsfRJyG6kuwB6bS4Leu2j7LTwVmh\r\n\t7fn47+rUYrDLNHF0RFmwrf3Npw8PIMsWMo0UrIKJeAq/rg7AJGcgzU5PckNZaw4FL6\r\n\te2qX8W21HnaVg==",
            "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\r\n\ts=mail; t=1647439999;\r\n\tbh=GSrPOp/8aRRDiVRKJjQN979llIgAsWDOxAAQf9IB7+o=;\r\n\th=From:To:Cc:Subject:Date:From;\r\n\tb=eB4Jj1Z1gmhee/dWVBSxm568szLQZG+Sq9NNtbs6aQCzvpllMtCyP5N2Au7r+RDtm\r\n\tmi3QWcscTKqe2wFOd/plM3lmpPjOAO3HNAteevlXWv3ZRGovX+teya+1lMzG3i240R\r\n\tzEbhzTpFGxvwy3/puIf1aQsbw9Nq2LFdvbUsSTcE="
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key; \r\n\tunprotected) header.d=ideasonboard.com\r\n\theader.i=@ideasonboard.com\r\n\theader.b=\"eB4Jj1Z1\"; dkim-atps=neutral",
        "To": "libcamera devel <libcamera-devel@lists.libcamera.org>",
        "Date": "Wed, 16 Mar 2022 14:13:16 +0000",
        "Message-Id": "<20220316141316.926035-1-kieran.bingham@ideasonboard.com>",
        "X-Mailer": "git-send-email 2.32.0",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH] README: Extend gstreamer examples",
        "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>,\r\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>,\r\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>",
        "From": "Kieran Bingham via libcamera-devel\r\n\t<libcamera-devel@lists.libcamera.org>",
        "Reply-To": "Kieran Bingham <kieran.bingham@ideasonboard.com>",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "There have been many reports of facing difficulties with the gstreamer\nelement and getting the libcamerasrc to successfully negotiate with\nother gstreamer elements.\n\nThis is often due to the current limitations on colorimetry and frame\nrate support in the element, and can usually be worked around by\nspecifying those explicitly in the caps.\n\nProvide a tested example to capture, encode, and stream images as jpeg\nto a remote device in the gstreamer section of the getting started\nreadme.\n\nSigned-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>\n---\n\nTechnically this pipeline will stream without specifying the colorimetry\nbut the purpose is to add an example with both framerate, and\ncolorimetry explicitly listed to help people debug their pipelines\nthemselves.\n\n README.rst | 19 +++++++++++++++++++\n 1 file changed, 19 insertions(+)",
    "diff": "diff --git a/README.rst b/README.rst\r\nindex ca8a97cbd71b..7abbc9e7a9ae 100644\r\n--- a/README.rst\r\n+++ b/README.rst\r\n@@ -139,6 +139,25 @@ the video device provider) and libcamerasrc (for the operation of the camera).\r\n All corresponding debug messages can be enabled by setting the ``GST_DEBUG``\r\n environment variable to ``libcamera*:7``.\r\n \r\n+Presently to prevent element negotiation failures it is required to specify the\r\n+colorimetry and framerate as part of your pipeline construction. For instance\r\n+to capture and encode as a JPEG stream and receive on another device the\r\n+following example could be used as a starting point:\r\n+\r\n+.. code::\r\n+\r\n+   gst-launch-1.0 libcamerasrc ! \\\r\n+        video/x-raw,colorimetry=bt709,format=NV12,width=1280,height=720,framerate=30/1 ! \\\r\n+        jpegenc ! multipartmux ! \\\r\n+        tcpserversink host=0.0.0.0 port=5000\r\n+\r\n+Which can be received on another device over the network with:\r\n+\r\n+.. code::\r\n+\r\n+   gst-launch-1.0 tcpclientsrc host=$DEVICE_IP port=5000 ! \\\r\n+        multipartdemux ! jpegdec ! autovideosink\r\n+\r\n .. section-end-getting-started\r\n \r\n Troubleshooting",
    "prefixes": [
        "libcamera-devel"
    ]
}