From patchwork Wed May 31 12:50:16 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Plowman X-Patchwork-Id: 18670 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 486DDC32A2 for ; Wed, 31 May 2023 12:50:25 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id B5E5C627B1; Wed, 31 May 2023 14:50:23 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org; s=mail; t=1685537423; bh=zeEbXwHGXSoS2wj5A3BeEWuNi3A4qf8TmmgfkMMUnjQ=; h=To:Date:In-Reply-To:References:Subject:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To: From; b=ntmiiEFg4NyeLcw9GZZ2awZEbn5o5S+f4mf9qGH9K+wU0j2xnJ3j5cQCUaldKl0Cz 3BEa9FYwxf7g/Qvy8pVyDPhyxQYl62y9Ymy+OYfrFtr+pGc2PgauINRJXsOE5qcCWL 11CrVoD8Yo9oNXCaqoSrBEiPpxzQ4fisN5SFnVUb5DGXrJza+TJ0TkozE7VAeYi4Hc 79+g+VYthXqnu+DhVN2R4XVb7nIuRoHTYeud51R2Jnq8T00WU4XUhd/9P+Nz5EHuOX b3gcdZZsnN7jKkpTvdLc9pkjG5avzctfSkLRxl4HSRwNeTq2dZj/Cu2v1mh1+EkhID IQtqxlRMi6YLg== Received: from mail-wr1-x42e.google.com (mail-wr1-x42e.google.com [IPv6:2a00:1450:4864:20::42e]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 928D2626FA for ; Wed, 31 May 2023 14:50:21 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (2048-bit key; unprotected) header.d=raspberrypi.com header.i=@raspberrypi.com header.b="PoZcHdDD"; dkim-atps=neutral Received: by mail-wr1-x42e.google.com with SMTP id ffacd0b85a97d-30c2bd52f82so207360f8f.3 for ; Wed, 31 May 2023 05:50:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=raspberrypi.com; s=google; t=1685537421; x=1688129421; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=TdkC2ALn3iQDBhLlOg+4NEqdGThXVLnr0sEpAOx7eVM=; b=PoZcHdDDPPa9m3yMp5imuca/mtetGedL1lY4IFVPheii9tMaUNv/xo4QzZu3BxRELl aMljs8/OMdOvpPRJPVG8sNbvTng2mQA8qYgTJ8/kpTlxxh8T+kGz2h9eCIxLDQqMZ4ZX xsfPotK++x9G3IVNz5bfQ3A/HPtG+l3J/KRJ+P0eTTc/LXe1M/DtcECIgupz2UDgcyBk yiI8rxqfthQuR+3ec5tfFER8cn+18W29oKaj9PbioYIKk0/BDym9DmfxpX3xLMil8Dm8 NUFryv8DmRBsEY5PSLzhIbcigTxbRWaAHscr+xUoFTxhQUmNMRyyOT5pLMdL3MDXbWqe WMHw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1685537421; x=1688129421; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=TdkC2ALn3iQDBhLlOg+4NEqdGThXVLnr0sEpAOx7eVM=; b=JqbRAtlFxIibQFBtMm7rIQGhL036WSTRijf/pY3LUP2whwa8Ey9BKMQslZBMK2cvdf rY7YRx6S1keZ/9Av7RXyp9qBwZZEU3h2bLAJ/8oiFqpouA7JrUAdxk1fwsy6Q3aifxMf qswWxAOCBGeHwcCN2LzkD1i5V9EVC1Ahs0VBqJuG5BYgxrki+9W0FsNruYP2ExI7tVSA eLexcd+kOsBy7LCaH3VbzIPfo9nbZ1/26IIgoQ19hj3aeP9I7bALIfx5zwEJ+S9Jqyr+ 7PzwcKp5eWI5DFk2jCrbXmfe+ax1eM2rad2jcjCvY6dsHKv9pek7N0A1wGgQnyafKzL5 xmxw== X-Gm-Message-State: AC+VfDypLNjL1IQE/X+mwF/ix3N+d94zDG4aOzapgcjqyYYGpyfmkVtm IKQebOo34UoYjGJ7FTYEqTNuw2I5zimdzmnqg81kiw== X-Google-Smtp-Source: ACHHUZ5MqfCvtTgSOTW1Fs+fQomT8RHziWMp5lbAQLeQ8k9bZwC/aCVhXnyKIkuU5gU019PbPVtZCQ== X-Received: by 2002:adf:e5c1:0:b0:30a:eeff:3e64 with SMTP id a1-20020adfe5c1000000b0030aeeff3e64mr4246107wrn.36.1685537421069; Wed, 31 May 2023 05:50:21 -0700 (PDT) Received: from pi4-davidp.pitowers.org ([2a00:1098:3142:14:2bce:64d6:1a5c:49a2]) by smtp.gmail.com with ESMTPSA id t13-20020a5d690d000000b003062675d4c9sm6634926wru.39.2023.05.31.05.50.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 31 May 2023 05:50:20 -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 Subject: [libcamera-devel] [PATCH 1/1] libcamera: controls: Add StartupFrame control X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: David Plowman via libcamera-devel From: David Plowman Reply-To: David Plowman Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" This control is passed back in a frame as metadata to indicate whether the camera system is still in a startup phase, and the application is advised to avoid using the frame. Signed-off-by: David Plowman --- src/libcamera/control_ids.yaml | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/src/libcamera/control_ids.yaml b/src/libcamera/control_ids.yaml index adea5f90..4742d907 100644 --- a/src/libcamera/control_ids.yaml +++ b/src/libcamera/control_ids.yaml @@ -694,6 +694,21 @@ controls: Continuous AF is paused. No further state changes or lens movements will occur until the AfPauseResume control is sent. + - StartupFrame: + type: bool + description: | + The value true indicates that the camera system is still in a startup + phase where the output images may not be reliable, or that certain of + the control algorithms (such as AEC/AGC, AWB, and possibly others) may + still be changing quite rapidly. + + Applications are advised to avoid using these frames. Mostly, they will + occur when the camera system starts for the first time, although, + depending on the sensor and the implementation, they could occur at + other times. + + The value false indicates that this is a normal frame. + # ---------------------------------------------------------------------------- # Draft controls section