{"id":23766,"url":"https://patchwork.libcamera.org/api/patches/23766/?format=json","web_url":"https://patchwork.libcamera.org/patch/23766/","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":"<20250707155856.33436-8-mzamazal@redhat.com>","date":"2025-07-07T15:58:52","name":"[v9,07/10] libcamera: simple: Validate raw stream configurations","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"21a49e630ad0beb53932ed5b4e1c7a22802471c7","submitter":{"id":177,"url":"https://patchwork.libcamera.org/api/people/177/?format=json","name":"Milan Zamazal","email":"mzamazal@redhat.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/23766/mbox/","series":[{"id":5274,"url":"https://patchwork.libcamera.org/api/series/5274/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=5274","date":"2025-07-07T15:58:45","name":"Enable raw streams with software ISP","version":9,"mbox":"https://patchwork.libcamera.org/series/5274/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/23766/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/23766/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 0F82BC3237\n\tfor ;\n\tMon, 7 Jul 2025 15:59:34 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id BD29E68ECE;\n\tMon, 7 Jul 2025 17:59:33 +0200 (CEST)","from us-smtp-delivery-124.mimecast.com\n\t(us-smtp-delivery-124.mimecast.com [170.10.129.124])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 19DA468EC3\n\tfor ;\n\tMon, 7 Jul 2025 17:59:32 +0200 (CEST)","from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com\n\t(ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63])\n\tby relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n\tcipher=TLS_AES_256_GCM_SHA384) id us-mta-125-ZCuNhenxNrmKtdi6fDdgEw-1;\n\tMon, 07 Jul 2025 11:59:27 -0400","from mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com\n\t(mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com\n\t[10.30.177.40])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\tkey-exchange X25519 server-signature RSA-PSS (2048 bits)\n\tserver-digest SHA256) (No client certificate requested)\n\tby mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTPS id 7DDD01944A82; Mon, 7 Jul 2025 15:59:26 +0000 (UTC)","from mzamazal-thinkpadp1gen7.tpbc.com (unknown [10.44.32.129])\n\tby mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTP id 8BA8A19560B2; Mon, 7 Jul 2025 15:59:23 +0000 (UTC)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=redhat.com header.i=@redhat.com\n\theader.b=\"HZbE2aqm\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n\ts=mimecast20190719; t=1751903971;\n\th=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n\tto:to:cc:cc:mime-version:mime-version:content-type:content-type:\n\tcontent-transfer-encoding:content-transfer-encoding:\n\tin-reply-to:in-reply-to:references:references;\n\tbh=yIu9Pt3J1zjhjbzz07VRYDL9JQGU3odEhg/Yj+lZmR0=;\n\tb=HZbE2aqmeSJz8I928/ubH6YbkXfOyTUfXIHtNOYF/Vlvl6dyKXuepcrjYF+X1HoOmrBv5r\n\tn7oIbLt01lpZFNJyaVIlnT2nAk5HHi7+QSzYS0De/Ruq6sPZR5PVfsuPdIEtRHBI3oeI6A\n\tLyA1mduxrvXXnALs4FjpKmoOoTyW/MY=","X-MC-Unique":"ZCuNhenxNrmKtdi6fDdgEw-1","X-Mimecast-MFC-AGG-ID":"ZCuNhenxNrmKtdi6fDdgEw_1751903966","From":"Milan Zamazal ","To":"libcamera-devel@lists.libcamera.org","Cc":"Milan Zamazal , Laurent Pinchart\n\t, Kieran Bingham\n\t, =?utf-8?q?Barnab=C3=A1s_P=C5=91cze?=\n\t, Paul Elder\n\t, Umang Jain ","Subject":"[PATCH v9 07/10] libcamera: simple: Validate raw stream\n\tconfigurations","Date":"Mon, 7 Jul 2025 17:58:52 +0200","Message-ID":"<20250707155856.33436-8-mzamazal@redhat.com>","In-Reply-To":"<20250707155856.33436-1-mzamazal@redhat.com>","References":"<20250707155856.33436-1-mzamazal@redhat.com>","MIME-Version":"1.0","X-Scanned-By":"MIMEDefang 3.0 on 10.30.177.40","X-Mimecast-Spam-Score":"0","X-Mimecast-MFC-PROC-ID":"pGcBPVLglKUdeGwXgNc4eO-IXDB0lfBlVKWSx1i4vY8_1751903966","X-Mimecast-Originator":"redhat.com","Content-Transfer-Encoding":"8bit","content-type":"text/plain; charset=\"US-ASCII\"; x-default=true","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":"SimpleCameraConfiguration::validate() looks for the best configuration.\nAs part of enabling raw stream support, the method must consider raw\nstreams in addition to the processed streams.\n\nIf only a processed stream is requested, nothing changes.\n\nIf only a raw stream is requested, the pixel format and output size may\nnot be adjusted. The patch adds checks for this.\n\nIf both processed and raw streams are requested, things get more\ncomplicated. The raw stream is expected to be passed through intact and\nall the adjustments are made for the processed streams. We select a\npipe configuration for the processed streams.\n\nNote that with both processed and raw streams, the requested sizes must\nbe mutually matching, including resizing due to debayer requirements.\nFor example, the following `cam' setup is valid for imx219\n\n cam -s role=viewfinder,width=1920,height=1080 \\\n -s role=raw,width=3280,height=2464\n\nrather than\n\n cam -s role=viewfinder,width=1920,height=1080 \\\n -s role=raw,width=1920,height=1080\n\ndue to the resolution of 1924x1080 actually selected for debayering to\n1920x1080. It is the application responsibility to select the right\nparameters for the raw stream.\n\nSetting up the right configurations is still not enough to make the raw\nstreams working. Buffer handling must be changed in the simple\npipeline, which is addressed in followup patches.\n\nSigned-off-by: Milan Zamazal \n---\n src/libcamera/pipeline/simple/simple.cpp | 127 ++++++++++++++++-------\n 1 file changed, 92 insertions(+), 35 deletions(-)","diff":"diff --git a/src/libcamera/pipeline/simple/simple.cpp b/src/libcamera/pipeline/simple/simple.cpp\nindex 27425e867..b1766c907 100644\n--- a/src/libcamera/pipeline/simple/simple.cpp\n+++ b/src/libcamera/pipeline/simple/simple.cpp\n@@ -27,6 +27,7 @@\n #include \n #include \n #include \n+#include \n #include \n #include \n #include \n@@ -1173,6 +1174,9 @@ CameraConfiguration::Status SimpleCameraConfiguration::validate()\n \tpipeConfig_ = nullptr;\n \n \tfor (const SimpleCameraData::Configuration *pipeConfig : *configs) {\n+\t\tif (processedRequested_ && pipeConfig->raw)\n+\t\t\tcontinue;\n+\n \t\tconst Size &size = pipeConfig->captureSize;\n \n \t\tif (size.width >= maxStreamSize.width &&\n@@ -1196,6 +1200,18 @@ CameraConfiguration::Status SimpleCameraConfiguration::validate()\n \t\t<< \"-\" << pipeConfig_->captureFormat\n \t\t<< \" for max stream size \" << maxStreamSize;\n \n+\t/*\n+\t * Update raw/processed flags. If e.g. an application calls\n+\t * generateConfiguration() with an empty list of roles and adds\n+\t * configurations by calling addConfiguration(), the flags must be updated\n+\t * according to those configurations.\n+\t */\n+\tfor (const auto &cfg : config_)\n+\t\tif (cfg.colorSpace == ColorSpace::Raw)\n+\t\t\trawRequested_ = true;\n+\t\telse\n+\t\t\tprocessedRequested_ = true;\n+\n \t/*\n \t * Adjust the requested streams.\n \t *\n@@ -1214,43 +1230,66 @@ CameraConfiguration::Status SimpleCameraConfiguration::validate()\n \tfor (unsigned int i = 0; i < config_.size(); ++i) {\n \t\tStreamConfiguration &cfg = config_[i];\n \n+\t\t/*\n+\t\t * If both processed and raw streams are requested, the pipe\n+\t\t * configuration is set up for the processed stream. The raw\n+\t\t * configuration needs to be compared against the capture format and\n+\t\t * size in such a case.\n+\t\t */\n+\t\tconst bool rawStream = cfg.colorSpace == ColorSpace::Raw;\n+\t\tconst bool sideRawStream = rawStream && processedRequested_;\n+\n \t\t/* Adjust the pixel format and size. */\n-\t\tauto it = std::find(pipeConfig_->outputFormats.begin(),\n-\t\t\t\t pipeConfig_->outputFormats.end(),\n-\t\t\t\t cfg.pixelFormat);\n-\t\tif (it == pipeConfig_->outputFormats.end())\n-\t\t\tit = pipeConfig_->outputFormats.begin();\n-\n-\t\tPixelFormat pixelFormat = *it;\n-\t\tif (cfg.pixelFormat != pixelFormat) {\n-\t\t\tLOG(SimplePipeline, Debug) << \"Adjusting pixel format\";\n-\t\t\tcfg.pixelFormat = pixelFormat;\n-\t\t\t/*\n-\t\t\t * Do not touch the colour space for raw requested roles.\n-\t\t\t * Even if the pixel format is non-raw (whatever it means), we\n-\t\t\t * shouldn't try to interpret the colour space of raw data.\n-\t\t\t */\n-\t\t\tif (cfg.colorSpace && cfg.colorSpace != ColorSpace::Raw)\n+\n+\t\tif (!sideRawStream) {\n+\t\t\tauto it = std::find(pipeConfig_->outputFormats.begin(),\n+\t\t\t\t\t pipeConfig_->outputFormats.end(),\n+\t\t\t\t\t cfg.pixelFormat);\n+\t\t\tif (it == pipeConfig_->outputFormats.end())\n+\t\t\t\tit = pipeConfig_->outputFormats.begin();\n+\n+\t\t\tPixelFormat pixelFormat = *it;\n+\n+\t\t\tif (cfg.pixelFormat != pixelFormat) {\n+\t\t\t\tif (rawStream) {\n+\t\t\t\t\tLOG(SimplePipeline, Info)\n+\t\t\t\t\t\t<< \"Raw pixel format \"\n+\t\t\t\t\t\t<< cfg.pixelFormat\n+\t\t\t\t\t\t<< \" doesn't match any of the pipe output formats\";\n+\t\t\t\t\treturn Invalid;\n+\t\t\t\t}\n+\t\t\t\tLOG(SimplePipeline, Debug)\n+\t\t\t\t\t<< \"Adjusting pixel format from \" << cfg.pixelFormat\n+\t\t\t\t\t<< \" to \" << pixelFormat;\n+\t\t\t\tcfg.pixelFormat = pixelFormat;\n+\t\t\t\t/*\n+\t\t\t\t * Do not touch the colour space for raw requested roles.\n+\t\t\t\t * Even if the pixel format is non-raw (whatever it means), we\n+\t\t\t\t * shouldn't try to interpret the colour space of raw data.\n+\t\t\t\t */\n+\t\t\t\tif (cfg.colorSpace && cfg.colorSpace != ColorSpace::Raw)\n+\t\t\t\t\tcfg.colorSpace->adjust(pixelFormat);\n+\t\t\t\tstatus = Adjusted;\n+\t\t\t}\n+\n+\t\t\tif (!cfg.colorSpace) {\n+\t\t\t\tconst PixelFormatInfo &info = PixelFormatInfo::info(pixelFormat);\n+\t\t\t\tswitch (info.colourEncoding) {\n+\t\t\t\tcase PixelFormatInfo::ColourEncodingRGB:\n+\t\t\t\t\tcfg.colorSpace = ColorSpace::Srgb;\n+\t\t\t\t\tbreak;\n+\t\t\t\tcase libcamera::PixelFormatInfo::ColourEncodingYUV:\n+\t\t\t\t\tcfg.colorSpace = ColorSpace::Sycc;\n+\t\t\t\t\tbreak;\n+\t\t\t\tdefault:\n+\t\t\t\t\tcfg.colorSpace = ColorSpace::Raw;\n+\t\t\t\t}\n \t\t\t\tcfg.colorSpace->adjust(pixelFormat);\n-\t\t\tstatus = Adjusted;\n-\t\t}\n-\t\tif (!cfg.colorSpace) {\n-\t\t\tconst PixelFormatInfo &info = PixelFormatInfo::info(pixelFormat);\n-\t\t\tswitch (info.colourEncoding) {\n-\t\t\tcase PixelFormatInfo::ColourEncodingRGB:\n-\t\t\t\tcfg.colorSpace = ColorSpace::Srgb;\n-\t\t\t\tbreak;\n-\t\t\tcase libcamera::PixelFormatInfo::ColourEncodingYUV:\n-\t\t\t\tcfg.colorSpace = ColorSpace::Sycc;\n-\t\t\t\tbreak;\n-\t\t\tdefault:\n-\t\t\t\tcfg.colorSpace = ColorSpace::Raw;\n+\t\t\t\tstatus = Adjusted;\n \t\t\t}\n-\t\t\tcfg.colorSpace->adjust(pixelFormat);\n-\t\t\tstatus = Adjusted;\n \t\t}\n \n-\t\tif (!pipeConfig_->outputSizes.contains(cfg.size)) {\n+\t\tif (!sideRawStream && !pipeConfig_->outputSizes.contains(cfg.size)) {\n \t\t\tSize adjustedSize = pipeConfig_->captureSize;\n \t\t\t/*\n \t\t\t * The converter (when present) may not be able to output\n@@ -1258,8 +1297,17 @@ CameraConfiguration::Status SimpleCameraConfiguration::validate()\n \t\t\t * not guaranteed to be a valid output size. In such cases, use\n \t\t\t * the smaller valid output size closest to the requested.\n \t\t\t */\n-\t\t\tif (!pipeConfig_->outputSizes.contains(adjustedSize))\n+\t\t\tif (!pipeConfig_->outputSizes.contains(adjustedSize)) {\n+\t\t\t\tif (rawStream) {\n+\t\t\t\t\tLOG(SimplePipeline, Info)\n+\t\t\t\t\t\t<< \"Raw output size \"\n+\t\t\t\t\t\t<< cfg.size\n+\t\t\t\t\t\t<< \" doesn't match any of the pipe output sizes: \"\n+\t\t\t\t\t\t<< pipeConfig_->outputSizes;\n+\t\t\t\t\treturn Invalid;\n+\t\t\t\t}\n \t\t\t\tadjustedSize = adjustSize(cfg.size, pipeConfig_->outputSizes);\n+\t\t\t}\n \t\t\tLOG(SimplePipeline, Debug)\n \t\t\t\t<< \"Adjusting size from \" << cfg.size\n \t\t\t\t<< \" to \" << adjustedSize;\n@@ -1269,11 +1317,20 @@ CameraConfiguration::Status SimpleCameraConfiguration::validate()\n \n \t\t/* \\todo Create a libcamera core class to group format and size */\n \t\tif (cfg.pixelFormat != pipeConfig_->captureFormat ||\n-\t\t cfg.size != pipeConfig_->captureSize)\n+\t\t cfg.size != pipeConfig_->captureSize) {\n+\t\t\tif (rawStream) {\n+\t\t\t\tLOG(SimplePipeline, Info)\n+\t\t\t\t\t<< \"Raw output format \" << cfg.pixelFormat\n+\t\t\t\t\t<< \" and size \" << cfg.size\n+\t\t\t\t\t<< \" not matching pipe format \" << pipeConfig_->captureFormat\n+\t\t\t\t\t<< \" and size \" << pipeConfig_->captureSize;\n+\t\t\t\treturn Invalid;\n+\t\t\t}\n \t\t\tneedConversion_ = true;\n+\t\t}\n \n \t\t/* Set the stride, frameSize and bufferCount. */\n-\t\tif (needConversion_) {\n+\t\tif (needConversion_ && !rawStream) {\n \t\t\tstd::tie(cfg.stride, cfg.frameSize) =\n \t\t\t\tdata_->converter_\n \t\t\t\t\t? data_->converter_->strideAndFrameSize(cfg.pixelFormat,\n","prefixes":["v9","07/10"]}