From patchwork Wed Aug 5 15:18:19 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Allen X-Patchwork-Id: 27622 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 F03AEC3306 for ; Wed, 5 Aug 2026 15:18:39 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 6377568112; Wed, 5 Aug 2026 17:18:39 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (2048-bit key; unprotected) header.d=googlemail.com header.i=@googlemail.com header.b="koC4ojjR"; dkim-atps=neutral Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id D6D916810E for ; Wed, 5 Aug 2026 17:18:37 +0200 (CEST) Received: by mail-wm1-x332.google.com with SMTP id 5b1f17b1804b1-49545ba3d4eso6130685e9.3 for ; Wed, 05 Aug 2026 08:18:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20251104; t=1785943117; x=1786547917; darn=lists.libcamera.org; 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:content-type; bh=ct3bBDs0zUjm5Y72xwlUnRDmfLKOq+FK66JXxqbRJYI=; b=koC4ojjRzEezjJ9+JcsXhGEKUKf3dS1zQm58Ftly/HkxFIQaDksWx6rz7Au7a8qn6t IyGSMriGy1LqiVwkutr133eg6CUWit7TfKthMab8VKPBZyYG2ln3DXTAgOIGoIvP1iXs Mp23en7zqszNJYHRVUACsBYonKTV+LYpnXfJaXhSzkTsurIB9lfuuKw15wHOEXDLnJWw JNfoq1Ehx5d2gIXHlHB9xBA5zvKXtMD7XaKMlldXNMMf8JXkWUn3BqEh1LuVVvuIEBf+ rI4kiNSLDK4iKNhPWCuzm2Nb3ZCJANrRkuJfvN4D/ANz/NnMF46cjia0QuIHZxYVBoZ3 UP9w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1785943117; x=1786547917; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=ct3bBDs0zUjm5Y72xwlUnRDmfLKOq+FK66JXxqbRJYI=; b=YI4Dt/RkuK+0JWehI2PqGdfg0zYxglrUmLT+21lfsdfPsfx7SwkBOGT/T7Op9qrljd 7wetTdPmGMBvZzHA3laYQ/fh9wH3yw0WuqUtIXktM6xRccs4mO2xFkb9Kln0VT44O45x I2D0t4eqTYsNLc4PsSYGuoT4apeE/tcxae+42U0EwUx0dWS9uGQAFY4VpoDrBGNv4Gd1 UxzWKZwL5JuIHLVI4p35vqzX9ElK9O5JYQmsy/fWkF/xnv8V5MidUVSMRpKyPuMC9NRq LBWdwyJQ022lRt18C/q9wB0GfEFp0sRKPErCByUMWhjRIOmP34qyvs5WqGrAqZhBV/jm bBEg== X-Gm-Message-State: AOJu0YyMDAFGuq4BW8QsvSjdEvPO3oTdogsEfMZUMO2KjWnGiHMfHbtY Hwx/3wzTiNt7z59TH61bfUpEUVRvVhJ2e6gGwrbXFMEdAu7yHwrf6xfblZnzOA== X-Gm-Gg: AR+sD13dotUtK6/7OxMQDObjahBocUXoezRQRNW+xs5dUGa8DEb/SFc0ODUeEYr55Ds CMZeIzItezIZHzBAtbhqpCLt056fI1rVTl+0NEzCXk5gaQTYbAF9xH/rpU9NrxKAxEDm72/WMNe wMk03xegquLM+FfC4yB8WmVmweFPZ8wYvYIeRnzzBrzBXwBxqXRp7mf7HsiJwhSAFfQYmSFay4c kN94PL+D++TQFLQrtwV5l1LrYAmG+vKauhH/A4LupsFBiwS+TS2LVYxjYFJbhmMvaOxDrIDQkw/ 5zLhDgCS1jKf9/hRX8d31obAa5b3R0kJoxXEu9AEtsiXdXvFvD19fD8AJ14aRrhS2ZKxGmW+5/z XFnpgNyKMdaPwo/AIV/AniFVpFAPMZMPevWosSWcjO0t344yhOYqYaXqIbMPbKLzJ11JT31WD4F uGaY6bpkUZ5VkSnuCbkHjOtETLeZmBF7dzHnl53J2SL1syMBk8vftpkTHK+l4F/UqwOmw0tlHjE bZHCWzCA7zWWTCPoQ== X-Received: by 2002:a05:600c:19cd:b0:498:519:e660 with SMTP id 5b1f17b1804b1-4994e72f7b6mr91364655e9.4.1785943111361; Wed, 05 Aug 2026 08:18:31 -0700 (PDT) Received: from localhost.localdomain ([194.94.98.191]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4994e52d819sm47193625e9.1.2026.08.05.08.18.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 05 Aug 2026 08:18:30 -0700 (PDT) From: Bruce Allen To: libcamera-devel@lists.libcamera.org Cc: barnabas.pocze@ideasonboard.com Subject: [PATCH v3 2/2] docs: Document SensorSequence request metadata Date: Wed, 5 Aug 2026 17:18:19 +0200 Message-ID: <20260805151819.16382-3-ballen4705@googlemail.com> X-Mailer: git-send-email 2.55.0 In-Reply-To: <20260805151819.16382-1-ballen4705@googlemail.com> References: <20260703224817.15650-1-ballen4705@googlemail.com> <20260805151819.16382-1-ballen4705@googlemail.com> MIME-Version: 1.0 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: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" Describe how applications read request metadata and point to controls::SensorSequence for control-specific details. Signed-off-by: Bruce Allen --- Documentation/guides/application-developer.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Documentation/guides/application-developer.rst b/Documentation/guides/application-developer.rst index abc67dd..dff5059 100644 --- a/Documentation/guides/application-developer.rst +++ b/Documentation/guides/application-developer.rst @@ -486,6 +486,24 @@ device: request->reuse(Request::ReuseBuffers); camera->queueRequest(request); +Request metadata +~~~~~~~~~~~~~~~~ + +Completed requests also expose metadata as a :doxy-pub:`ControlList` through +:doxy-pub:`Request::metadata()`. Only controls where +:doxy-pub:`ControlId::direction()` signals +:doxy-pub:`ControlId::Direction::Out` are returned as metadata. + +Common entries include :doxy-pub:`controls::SensorTimestamp`, +:doxy-pub:`controls::FrameWallClock`, and :doxy-pub:`controls::SensorSequence`. +See the documentation of each control for details. + +.. code:: cpp + + const ControlList &metadata = request->metadata(); + if (auto seq = metadata.get(controls::SensorSequence)) + std::cout << " sensor sequence: " << *seq << std::endl; + Request queueing ----------------