Show a patch.

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

{
    "id": 17416,
    "url": "https://patchwork.libcamera.org/api/patches/17416/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/17416/",
    "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": "<20220927023642.12341-6-laurent.pinchart@ideasonboard.com>",
    "date": "2022-09-27T02:36:14",
    "name": "[libcamera-devel,v5,05/33] ipa: libipa: Provide a common base for frame contexts",
    "commit_ref": null,
    "pull_url": null,
    "state": "accepted",
    "archived": false,
    "hash": "c12e1fcc3aa37c789f480cd55e122b6ea5193ebb",
    "submitter": {
        "id": 2,
        "url": "https://patchwork.libcamera.org/api/people/2/?format=api",
        "name": "Laurent Pinchart",
        "email": "laurent.pinchart@ideasonboard.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/17416/mbox/",
    "series": [
        {
            "id": 3506,
            "url": "https://patchwork.libcamera.org/api/series/3506/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=3506",
            "date": "2022-09-27T02:36:09",
            "name": "ipa: Frame context queue, IPU3 & RkISP consolidation, and RkISP1 improvements",
            "version": 5,
            "mbox": "https://patchwork.libcamera.org/series/3506/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/17416/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/17416/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 2E042C0DA4\n\tfor <parsemail@patchwork.libcamera.org>;\n\tTue, 27 Sep 2022 02:37:11 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id ADEFC62279;\n\tTue, 27 Sep 2022 04:37:10 +0200 (CEST)",
            "from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 7169462270\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tTue, 27 Sep 2022 04:37:07 +0200 (CEST)",
            "from pendragon.ideasonboard.com (62-78-145-57.bb.dnainternet.fi\n\t[62.78.145.57])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id E0EE647C;\n\tTue, 27 Sep 2022 04:37:06 +0200 (CEST)"
        ],
        "DKIM-Signature": [
            "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1664246230;\n\tbh=+QKdoT3OJ4NYtAL13TtxZDMryhUFdej5MafYs5tGmcU=;\n\th=To:Date:In-Reply-To:References:Subject:List-Id:List-Unsubscribe:\n\tList-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:\n\tFrom;\n\tb=XtmhJhsfH2Q/ixb57bD7IPT+lMnaZIMMZEd1HEpnGrG2PHLaL5xg7zedVqRdQsxxz\n\tNKtYrGUwTW5eFU8OzRmCxCJBsKT7g2aQdCsiL4XNQCTE/txmrqr9Tx+IysE5mFyZsd\n\tJbwUGV9/WdvnHZeAB7ls/Q+srPuJ1T1gr6gYVnlWCikOt1gN88sco9TeXXZxav31lk\n\tCgK6Nvtz0YfXKvP3TVIlsGuz/RBWS9Y7riAqDB6WhcHyAUD3iPt62NJTVG/3S+crTm\n\twiL9mXAx5OsCvrnRYCIPQ0O4HP4I6ZUZXKWaD9A9WLZpk5O9uqN7BwM5xHIa3mZ3xB\n\tB/5LZ61jZD1MQ==",
            "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1664246227;\n\tbh=+QKdoT3OJ4NYtAL13TtxZDMryhUFdej5MafYs5tGmcU=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=VVRVqXvRiK5iFXq965XYyq8kjBcRruHjrRqSgHmhuVOruEBiDq8GkMvUEKu7hqatX\n\tLAJWLeyxzbxexEy4cT6s04QHrP9TNPt+a4A7mW945QZJxbRi/RJrabgX3FfutLhd86\n\tS5+lgSGyWAvIb9ZsqKKE4fCVzelv5tnPIDD9xKQc="
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"VVRVqXvR\"; dkim-atps=neutral",
        "To": "libcamera-devel@lists.libcamera.org",
        "Date": "Tue, 27 Sep 2022 05:36:14 +0300",
        "Message-Id": "<20220927023642.12341-6-laurent.pinchart@ideasonboard.com>",
        "X-Mailer": "git-send-email 2.35.1",
        "In-Reply-To": "<20220927023642.12341-1-laurent.pinchart@ideasonboard.com>",
        "References": "<20220927023642.12341-1-laurent.pinchart@ideasonboard.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH v5 05/33] ipa: libipa: Provide a common\n\tbase for frame contexts",
        "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>",
        "From": "Laurent Pinchart via libcamera-devel\n\t<libcamera-devel@lists.libcamera.org>",
        "Reply-To": "Laurent Pinchart <laurent.pinchart@ideasonboard.com>",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "From: Kieran Bingham <kieran.bingham@ideasonboard.com>\n\nProvide a common FrameContext as a base for IPA modules to inherit from.\n\nThis will allow having a common set of parameters for every frame\ncontext managed by the FCQueue implementation.\n\nSigned-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>\nSigned-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\nReviewed-by: Kieran Bingham <kieran.bingham@ideasonboard.com>\nReviewed-by: Jacopo Mondi <jacopo@jmondi.org>\n---\nChanges since v4:\n\n- Move documentation paragraph from previous patch to this one\n- Rename IPAFrameContext to FrameContext in documentation\n\nChanges since v3:\n\n- Rename structure from IPAFrameContext to FrameContext\n- Move changes to IPA modules to separate patches\n- Make the FrameContext::frame member private\n---\n src/ipa/libipa/fc_queue.cpp | 22 ++++++++++++++++++++++\n src/ipa/libipa/fc_queue.h   | 10 ++++++++++\n 2 files changed, 32 insertions(+)",
    "diff": "diff --git a/src/ipa/libipa/fc_queue.cpp b/src/ipa/libipa/fc_queue.cpp\nindex 57a369512554..e812faa505a5 100644\n--- a/src/ipa/libipa/fc_queue.cpp\n+++ b/src/ipa/libipa/fc_queue.cpp\n@@ -20,6 +20,24 @@ namespace ipa {\n  * \\brief Queue of per-frame contexts\n  */\n \n+/**\n+ * \\struct FrameContext\n+ * \\brief Context for a frame\n+ *\n+ * The frame context stores data specific to a single frame processed by the\n+ * IPA module. Each frame processed by the IPA module has a context associated\n+ * with it, accessible through the Frame Context Queue.\n+ *\n+ * Fields in the frame context should reflect values and controls associated\n+ * with the specific frame as requested by the application, and as configured by\n+ * the hardware. Fields can be read by algorithms to determine if they should\n+ * update any specific action for this frame, and finally to update the metadata\n+ * control lists when the frame is fully completed.\n+ *\n+ * \\var FrameContext::frame\n+ * \\brief The frame number\n+ */\n+\n /**\n  * \\class FCQueue\n  * \\brief A support class for managing FrameContext instances in IPA modules\n@@ -65,6 +83,10 @@ namespace ipa {\n  * allowed to overflow, which must be ensured by pipeline handlers never\n  * queuing more in-flight requests to the IPA module than the queue size. If an\n  * overflow condition is detected, the queue will log a fatal error.\n+ *\n+ * IPA module-specific frame context implementations shall inherit from the\n+ * FrameContext base class to support the minimum required features for a\n+ * FrameContext.\n  */\n \n /**\ndiff --git a/src/ipa/libipa/fc_queue.h b/src/ipa/libipa/fc_queue.h\nindex 4f5cb5d35253..a589e7e1031b 100644\n--- a/src/ipa/libipa/fc_queue.h\n+++ b/src/ipa/libipa/fc_queue.h\n@@ -7,6 +7,7 @@\n \n #pragma once\n \n+#include <stdint.h>\n #include <vector>\n \n #include <libcamera/base/log.h>\n@@ -17,6 +18,15 @@ LOG_DECLARE_CATEGORY(FCQueue)\n \n namespace ipa {\n \n+template<typename FrameContext>\n+class FCQueue;\n+\n+struct FrameContext {\n+private:\n+\ttemplate<typename T> friend class FCQueue;\n+\tuint32_t frame;\n+};\n+\n template<typename FrameContext>\n class FCQueue\n {\n",
    "prefixes": [
        "libcamera-devel",
        "v5",
        "05/33"
    ]
}