[{"id":34566,"web_url":"https://patchwork.libcamera.org/comment/34566/","msgid":"<5k7iv4duusupxe7lay7zcz2fro57rcuu37nfs7ambnnmgetc43@m5ir7aebxrc5>","date":"2025-06-19T11:24:56","subject":"Re: [RFC PATCH v1 14/23] guides: application: Document\n\tCamera::metadataAvailable","submitter":{"id":143,"url":"https://patchwork.libcamera.org/api/people/143/","name":"Jacopo Mondi","email":"jacopo.mondi@ideasonboard.com"},"content":"Hi Barnabás\n\nOn Fri, Jun 06, 2025 at 06:41:47PM +0200, Barnabás Pőcze wrote:\n> From: Jacopo Mondi <jacopo.mondi@ideasonboard.com>\n>\n> Document the Camera::metadataAvailable signal in the application\n> developer guide as an opt-in feature to receive early metadata\n> notifications.\n>\n> Signed-off-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>\n> Signed-off-by: Barnabás Pőcze <barnabas.pocze@ideasonboard.com>\n\nNot sure it's needed but\nReviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>\n\nThanks\n  j\n\n> ---\n> Original: https://patchwork.libcamera.org/patch/22228/\n> ---\n>  Documentation/guides/application-developer.rst | 8 ++++++++\n>  1 file changed, 8 insertions(+)\n>\n> diff --git a/Documentation/guides/application-developer.rst b/Documentation/guides/application-developer.rst\n> index 6501345a9..2d7c29010 100644\n> --- a/Documentation/guides/application-developer.rst\n> +++ b/Documentation/guides/application-developer.rst\n> @@ -357,6 +357,14 @@ Signals and Slots`_) to connect events with callbacks to handle them.\n>  The ``Camera`` device emits two signals that applications can connect to in\n>  order to execute callbacks on frame completion events.\n>\n> +The ``Camera::metadataAvailable`` signal notifies applications of the\n> +availability of metadata results before a request completes. Receiving\n> +notification about metadata availability allows application to fast-track\n> +handling of metadata results before all the image buffers in a request are\n> +ready. The full list of metadata results associated with a Request is anyway\n> +available at request complete time, and receiving notifications for early\n> +metadata availability is an optional feature for applications.\n> +\n>  The ``Camera::bufferCompleted`` signal notifies applications that a buffer with\n>  image data is available. Receiving notifications about the single buffer\n>  completion event allows applications to implement partial request completion\n> --\n> 2.49.0\n>","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 F0D6CBDE6B\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 19 Jun 2025 11:25:01 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 9A69768DE3;\n\tThu, 19 Jun 2025 13:25:01 +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 BF19D68DDD\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 19 Jun 2025 13:25:00 +0200 (CEST)","from ideasonboard.com (93-61-96-190.ip145.fastwebnet.it\n\t[93.61.96.190])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id DF61F2EC;\n\tThu, 19 Jun 2025 13:24:46 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"of4r1cwb\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1750332287;\n\tbh=dOXMOXw5FVb81+J46uIuerw8JBw8BmXVUP/LUKal/38=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=of4r1cwbO64D/mS+DZJcuJD73trppz1EHv8+8iBsb6GisTl2oSClnEyx0KgGqETrq\n\tg0tkpqCTyTB/QSFL7uwx1rgRf7uJG56LsXHhOs/ByRpN5r6UHfm03SEody2MXW0a3j\n\tzON7SRAX+M+/psHDQOtMKXBk79r/MRzBiO8iXbFM=","Date":"Thu, 19 Jun 2025 13:24:56 +0200","From":"Jacopo Mondi <jacopo.mondi@ideasonboard.com>","To":"=?utf-8?q?Barnab=C3=A1s_P=C5=91cze?= <barnabas.pocze@ideasonboard.com>","Cc":"libcamera-devel@lists.libcamera.org, \n\tJacopo Mondi <jacopo.mondi@ideasonboard.com>","Subject":"Re: [RFC PATCH v1 14/23] guides: application: Document\n\tCamera::metadataAvailable","Message-ID":"<5k7iv4duusupxe7lay7zcz2fro57rcuu37nfs7ambnnmgetc43@m5ir7aebxrc5>","References":"<20250606164156.1442682-1-barnabas.pocze@ideasonboard.com>\n\t<20250606164156.1442682-15-barnabas.pocze@ideasonboard.com>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","Content-Transfer-Encoding":"8bit","In-Reply-To":"<20250606164156.1442682-15-barnabas.pocze@ideasonboard.com>","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>","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"}}]