{"id":25498,"url":"https://patchwork.libcamera.org/api/patches/25498/?format=json","web_url":"https://patchwork.libcamera.org/patch/25498/","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":"<20251211232246.31330-5-bryan.odonoghue@linaro.org>","date":"2025-12-11T23:22:29","name":"[v5,04/20] libcamera: swstats_cpu: Update statsProcessFn() / processLine0() documentation","commit_ref":null,"pull_url":null,"state":"accepted","archived":false,"hash":"8da0e9fb46d79d4b5aa0d845428e9003b11c74ec","submitter":{"id":175,"url":"https://patchwork.libcamera.org/api/people/175/?format=json","name":"Bryan O'Donoghue","email":"bryan.odonoghue@linaro.org"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/25498/mbox/","series":[{"id":5656,"url":"https://patchwork.libcamera.org/api/series/5656/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5656","date":"2025-12-11T23:22:25","name":"GPUISP precursor series","version":5,"mbox":"https://patchwork.libcamera.org/series/5656/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/25498/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/25498/checks/","tags":{},"headers":{"Return-Path":"","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 AA4A6C3257\n\tfor ;\n\tThu, 11 Dec 2025 23:23:27 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 5D7AC61637;\n\tFri, 12 Dec 2025 00:23:27 +0100 (CET)","from mail-pf1-x42e.google.com (mail-pf1-x42e.google.com\n\t[IPv6:2607:f8b0:4864:20::42e])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id E57DA6161D\n\tfor ;\n\tFri, 12 Dec 2025 00:23:24 +0100 (CET)","by mail-pf1-x42e.google.com with SMTP id\n\td2e1a72fcca58-7b80fed1505so656035b3a.3\n\tfor ;\n\tThu, 11 Dec 2025 15:23:24 -0800 (PST)","from inspiron14p-linux (M106185144161.v4.enabler.ne.jp.\n\t[106.185.144.161]) by smtp.gmail.com with ESMTPSA id\n\td2e1a72fcca58-7f4c4ab52aasm3399933b3a.38.2025.12.11.15.23.19\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tThu, 11 Dec 2025 15:23:22 -0800 (PST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (2048-bit key;\n\tunprotected) header.d=linaro.org header.i=@linaro.org\n\theader.b=\"GVcw8yVd\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=linaro.org; s=google; t=1765495403; x=1766100203;\n\tdarn=lists.libcamera.org; \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=e99H68rU1D/gDXlHtAR7K7/NWQaghQ9EtXGEFE+XesQ=;\n\tb=GVcw8yVdpohm8lfKJ5UDw4cK/zp8PtEPTsn6GUDeMuenqphorqYyyjMSVTxd978Z04\n\tO1DvJRIOa5QND8/wHVg6wf/ZT8H1KfumuK0UnowbSQ63Fl1aEbB2MtuEnIyvh3ZzUeov\n\tInDEHotc1HhFtRfebIxzdk5aYiArjb15vU0L0juOmty3dGnHLGelsI6GuuX42IY4Bu4Q\n\t0hmVo2/KXFFOf19mRiCSbG5o9X8wRhag9yE8fodLHSRAuy4MKBWnf781e3r0HewhOfbv\n\tGPKi7w+TmXPpyeq7nDjYrfnZOP8WTK85abhZsmEZ2M+WvTkBdM8ILd5oJGlg0yv9IP6Y\n\tjH7w==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20230601; t=1765495403; x=1766100203;\n\th=content-transfer-encoding:mime-version:references:in-reply-to\n\t:message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from\n\t:to:cc:subject:date:message-id:reply-to;\n\tbh=e99H68rU1D/gDXlHtAR7K7/NWQaghQ9EtXGEFE+XesQ=;\n\tb=UexgQoQU+IzKdc2R00GR5CO7fhUbdanCr2ezWQ2wgFR3UuSbryrwGZXn0ndYJj9uwZ\n\tvxXy/qxVHrv2OvvvHX5yqCxv53rAqFC6IV1qNHun4xnBM07uXzBuTKJY2pAiu6rTiJSD\n\tIwvWFoAWO6aSvDUrlbWYVcYyBhIDDJa2/hFKxZbARBG+vlUClPE1/shKZwZZk3pGklI3\n\t9RZEyNX0qalTRDfNQA0MpMFoLwX2B942U/lDMHq6SgcOP/Dwy+bGovD+O/Y0vL8+sc02\n\tsKlR56mPVmcYP18jsV7SJ8jj0jjt1oxy4veEMaCv6EFCuA602gc6tw5m0JBElzYoxSKe\n\tvxGA==","X-Gm-Message-State":"AOJu0YznCy0wRYxIBGOwhq1L5of7rvdPFmgBtqtXLPPbgoA9dKI97IYT\n\tbeVPCHpw6MqWZt13iOVD+2yDXGShFPZKgT0uyxkpBY9xhqFJY48hizlgaAJ1qlK35oTBA1bmvVy\n\tj+tXX","X-Gm-Gg":"AY/fxX65pFLO27Q1e1RRth/S0rwx7Dwbp3IIFB+/uOroTeQmcF+R7njptu6SyojCu7c\n\tBeA0ZLUM8E8Si0iXcrzRfHm1RR2jIRr6Dse48tyBRGzbIZuuhXHK46VbHb8TS339/qDuyy+qOJ7\n\tntCvWzVxCzWynrwdDOh7TxIXiqImAkZeOQDyEZ4YO2gnabZYWL5uQb2DfOrLC+FbGk8YQdsTYFb\n\tLwhTJGXhzfCzRPO63bKBuZhJvOX1F8E7bPLkXr7hzknZMYkjDIAFh4WKN0sV1oyW3wmtI09I3UG\n\tA2H0hlRcTByX8Nq+irD8g4U1xelF36xIOLydpEEK2DE/QH30dsrqfNcuBnwX27MBdRM+TX5bhPm\n\ty6UKZhFXsVSx0nFoi3ZFLoH5mVCsPICuIRbex1BkTHy5/jFWBkjVvqMj3vzfLqfLE9AIbxeY7MT\n\tChFPsdXtd9soc+eA3CSDQkNw9cbchTTUMQIQHajPDUdPk4zvj9wcD4cpdfyV81uA==","X-Google-Smtp-Source":"AGHT+IFiec5oEEvEfUj1RZUnJlTxKxDVikT7B3LBP4du6RHD9E1dha9fz+8wulg/8T3WheLS0DlSsg==","X-Received":"by 2002:a05:6a00:2c94:b0:7f0:5721:a41b with SMTP id\n\td2e1a72fcca58-7f667d1feb9mr165536b3a.30.1765495403327; \n\tThu, 11 Dec 2025 15:23:23 -0800 (PST)","From":"Bryan O'Donoghue ","To":"libcamera-devel@lists.libcamera.org","Cc":"pavel@ucw.cz, Hans de Goede ,\n\tKieran Bingham ,\n\tMilan Zamazal ,\n\tBryan O'Donoghue ","Subject":"[PATCH v5 04/20] libcamera: swstats_cpu: Update statsProcessFn() /\n\tprocessLine0() documentation","Date":"Thu, 11 Dec 2025 23:22:29 +0000","Message-ID":"<20251211232246.31330-5-bryan.odonoghue@linaro.org>","X-Mailer":"git-send-email 2.52.0","In-Reply-To":"<20251211232246.31330-1-bryan.odonoghue@linaro.org>","References":"<20251211232246.31330-1-bryan.odonoghue@linaro.org>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"From: Hans de Goede \n\nUpdate the documentation of the statsProcessFn() / processLine0() src[]\npointer argument to take into account that swstats_cpu may also be used\nwith planar input data or with non Bayer single plane input data.\n\nThe statsProcessFn typedef is private, so no documentation is generated\nfor it. Move the new updated src[] pointer argument documentation to\nprocessLine0() so that it gets included in the generated docs.\n\nReviewed-by: Kieran Bingham \nReviewed-by: Milan Zamazal \nSigned-off-by: Hans de Goede \nSigned-off-by: Bryan O'Donoghue \n---\n src/libcamera/software_isp/swstats_cpu.cpp | 13 +++++++++++++\n 1 file changed, 13 insertions(+)","diff":"diff --git a/src/libcamera/software_isp/swstats_cpu.cpp b/src/libcamera/software_isp/swstats_cpu.cpp\nindex 4f7bdd231..9c03338a0 100644\n--- a/src/libcamera/software_isp/swstats_cpu.cpp\n+++ b/src/libcamera/software_isp/swstats_cpu.cpp\n@@ -72,6 +72,19 @@ namespace libcamera {\n * patternSize height == 1.\n * It'll process line 0 and 1 for input formats with patternSize height >= 2.\n * This function may only be called after a successful setWindow() call.\n+ *\n+ * This function takes an array of src pointers each pointing to a line in\n+ * the source image.\n+ *\n+ * Bayer input data requires (patternSize_.height + 1) src pointers, with\n+ * the middle element of the array pointing to the actual line being processed.\n+ * Earlier element(s) will point to the previous line(s) and later element(s)\n+ * to the next line(s). See the DebayerCpu::debayerFn documentation for details.\n+ *\n+ * Planar input data requires a src pointer for each plane, with src[0] pointing\n+ * to the line in plane 0, etc.\n+ *\n+ * For non Bayer single plane input data only a single src pointer is required.\n */\n \n /**\n","prefixes":["v5","04/20"]}