{"id":18670,"url":"https://patchwork.libcamera.org/api/patches/18670/?format=json","web_url":"https://patchwork.libcamera.org/patch/18670/","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":"<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=json","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=json","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"]}