Show a patch.

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

{
    "id": 18670,
    "url": "https://patchwork.libcamera.org/api/patches/18670/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/18670/",
    "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": "<20230531125016.5540-2-david.plowman@raspberrypi.com>",
    "date": "2023-05-31T12:50:16",
    "name": "[libcamera-devel,1/1] libcamera: controls: Add StartupFrame control",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "1154ed02a238e9f5d910d64a58dcd7fe9646bf8f",
    "submitter": {
        "id": 42,
        "url": "https://patchwork.libcamera.org/api/people/42/?format=api",
        "name": "David Plowman",
        "email": "david.plowman@raspberrypi.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/18670/mbox/",
    "series": [
        {
            "id": 3896,
            "url": "https://patchwork.libcamera.org/api/series/3896/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=3896",
            "date": "2023-05-31T12:50:15",
            "name": "StartupFrame metadata",
            "version": 1,
            "mbox": "https://patchwork.libcamera.org/series/3896/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/18670/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/18670/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 486DDC32A2\n\tfor <parsemail@patchwork.libcamera.org>;\n\tWed, 31 May 2023 12:50:25 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id B5E5C627B1;\n\tWed, 31 May 2023 14:50:23 +0200 (CEST)",
            "from mail-wr1-x42e.google.com (mail-wr1-x42e.google.com\n\t[IPv6:2a00:1450:4864:20::42e])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 928D2626FA\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 31 May 2023 14:50:21 +0200 (CEST)",
            "by mail-wr1-x42e.google.com with SMTP id\n\tffacd0b85a97d-30c2bd52f82so207360f8f.3\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 31 May 2023 05:50:21 -0700 (PDT)",
            "from pi4-davidp.pitowers.org\n\t([2a00:1098:3142:14:2bce:64d6:1a5c:49a2])\n\tby smtp.gmail.com with ESMTPSA id\n\tt13-20020a5d690d000000b003062675d4c9sm6634926wru.39.2023.05.31.05.50.20\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tWed, 31 May 2023 05:50:20 -0700 (PDT)"
        ],
        "DKIM-Signature": [
            "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1685537423;\n\tbh=zeEbXwHGXSoS2wj5A3BeEWuNi3A4qf8TmmgfkMMUnjQ=;\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=ntmiiEFg4NyeLcw9GZZ2awZEbn5o5S+f4mf9qGH9K+wU0j2xnJ3j5cQCUaldKl0Cz\n\t3BEa9FYwxf7g/Qvy8pVyDPhyxQYl62y9Ymy+OYfrFtr+pGc2PgauINRJXsOE5qcCWL\n\t11CrVoD8Yo9oNXCaqoSrBEiPpxzQ4fisN5SFnVUb5DGXrJza+TJ0TkozE7VAeYi4Hc\n\t79+g+VYthXqnu+DhVN2R4XVb7nIuRoHTYeud51R2Jnq8T00WU4XUhd/9P+Nz5EHuOX\n\tb3gcdZZsnN7jKkpTvdLc9pkjG5avzctfSkLRxl4HSRwNeTq2dZj/Cu2v1mh1+EkhID\n\tIQtqxlRMi6YLg==",
            "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=raspberrypi.com; s=google; t=1685537421; x=1688129421;\n\th=content-transfer-encoding:mime-version:references:in-reply-to\n\t:message-id:date:subject:cc:to:from:from:to:cc:subject:date\n\t:message-id:reply-to;\n\tbh=TdkC2ALn3iQDBhLlOg+4NEqdGThXVLnr0sEpAOx7eVM=;\n\tb=PoZcHdDDPPa9m3yMp5imuca/mtetGedL1lY4IFVPheii9tMaUNv/xo4QzZu3BxRELl\n\taMljs8/OMdOvpPRJPVG8sNbvTng2mQA8qYgTJ8/kpTlxxh8T+kGz2h9eCIxLDQqMZ4ZX\n\txsfPotK++x9G3IVNz5bfQ3A/HPtG+l3J/KRJ+P0eTTc/LXe1M/DtcECIgupz2UDgcyBk\n\tyiI8rxqfthQuR+3ec5tfFER8cn+18W29oKaj9PbioYIKk0/BDym9DmfxpX3xLMil8Dm8\n\tNUFryv8DmRBsEY5PSLzhIbcigTxbRWaAHscr+xUoFTxhQUmNMRyyOT5pLMdL3MDXbWqe\n\tWMHw=="
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (2048-bit key; \n\tunprotected) header.d=raspberrypi.com\n\theader.i=@raspberrypi.com\n\theader.b=\"PoZcHdDD\"; dkim-atps=neutral",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20221208; t=1685537421; x=1688129421;\n\th=content-transfer-encoding:mime-version:references:in-reply-to\n\t:message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc\n\t:subject:date:message-id:reply-to;\n\tbh=TdkC2ALn3iQDBhLlOg+4NEqdGThXVLnr0sEpAOx7eVM=;\n\tb=JqbRAtlFxIibQFBtMm7rIQGhL036WSTRijf/pY3LUP2whwa8Ey9BKMQslZBMK2cvdf\n\trY7YRx6S1keZ/9Av7RXyp9qBwZZEU3h2bLAJ/8oiFqpouA7JrUAdxk1fwsy6Q3aifxMf\n\tqswWxAOCBGeHwcCN2LzkD1i5V9EVC1Ahs0VBqJuG5BYgxrki+9W0FsNruYP2ExI7tVSA\n\teLexcd+kOsBy7LCaH3VbzIPfo9nbZ1/26IIgoQ19hj3aeP9I7bALIfx5zwEJ+S9Jqyr+\n\t7PzwcKp5eWI5DFk2jCrbXmfe+ax1eM2rad2jcjCvY6dsHKv9pek7N0A1wGgQnyafKzL5\n\txmxw==",
        "X-Gm-Message-State": "AC+VfDypLNjL1IQE/X+mwF/ix3N+d94zDG4aOzapgcjqyYYGpyfmkVtm\n\tIKQebOo34UoYjGJ7FTYEqTNuw2I5zimdzmnqg81kiw==",
        "X-Google-Smtp-Source": "ACHHUZ5MqfCvtTgSOTW1Fs+fQomT8RHziWMp5lbAQLeQ8k9bZwC/aCVhXnyKIkuU5gU019PbPVtZCQ==",
        "X-Received": "by 2002:adf:e5c1:0:b0:30a:eeff:3e64 with SMTP id\n\ta1-20020adfe5c1000000b0030aeeff3e64mr4246107wrn.36.1685537421069; \n\tWed, 31 May 2023 05:50:21 -0700 (PDT)",
        "To": "libcamera-devel@lists.libcamera.org",
        "Date": "Wed, 31 May 2023 13:50:16 +0100",
        "Message-Id": "<20230531125016.5540-2-david.plowman@raspberrypi.com>",
        "X-Mailer": "git-send-email 2.30.2",
        "In-Reply-To": "<20230531125016.5540-1-david.plowman@raspberrypi.com>",
        "References": "<20230531125016.5540-1-david.plowman@raspberrypi.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH 1/1] libcamera: controls: Add StartupFrame\n\tcontrol",
        "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": "David Plowman via libcamera-devel <libcamera-devel@lists.libcamera.org>",
        "Reply-To": "David Plowman <david.plowman@raspberrypi.com>",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "This control is passed back in a frame as metadata to indicate whether\nthe camera system is still in a startup phase, and the application is\nadvised to avoid using the frame.\n\nSigned-off-by: David Plowman <david.plowman@raspberrypi.com>\n---\n src/libcamera/control_ids.yaml | 15 +++++++++++++++\n 1 file changed, 15 insertions(+)",
    "diff": "diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml\nindex adea5f90..4742d907 100644\n--- a/src/libcamera/control_ids.yaml\n+++ b/src/libcamera/control_ids.yaml\n@@ -694,6 +694,21 @@ controls:\n             Continuous AF is paused. No further state changes or lens movements\n             will occur until the AfPauseResume control is sent.\n \n+  - StartupFrame:\n+      type: bool\n+      description: |\n+        The value true indicates that the camera system is still in a startup\n+        phase where the output images may not be reliable, or that certain of\n+        the control algorithms (such as AEC/AGC, AWB, and possibly others) may\n+        still be changing quite rapidly.\n+\n+        Applications are advised to avoid using these frames. Mostly, they will\n+        occur when the camera system starts for the first time, although,\n+        depending on the sensor and the implementation, they could occur at\n+        other times.\n+\n+        The value false indicates that this is a normal frame.\n+\n   # ----------------------------------------------------------------------------\n   # Draft controls section\n \n",
    "prefixes": [
        "libcamera-devel",
        "1/1"
    ]
}