[v8,00/10] Enable raw streams with software ISP
mbox series

Message ID 20250702121024.38728-1-mzamazal@redhat.com
Headers show
Series
  • Enable raw streams with software ISP
Related show

Message

Milan Zamazal July 2, 2025, 12:09 p.m. UTC 
This makes raw streams working again in ‘simple’ pipeline when software
ISP is enabled for the given device.  At most one raw stream and one
processed stream (possibly both at once) are supported.

An example ‘cam’ invocation requesting a raw stream rather than a debayered stream:

  cam -c1 -C8 -s role=raw,width=1920,height=1080 -Ffile#.raw

Or for both raw and processed streams:

  cam -c1 -C8 -Ffile# \
    -s role=viewfinder,width=1920,height=1080,pixelformat=RGB888 \
    -s role=raw,width=3280,height=2464,pixelformat=SRGGB8

When only a raw stream is requested, there are no exposure/gain
adjustments applied.  This could be improved in future, once software
ISP gets a mechanism to gather image statistics without processing and
using them to make the adjustments, or once manual exposure controls are
added to software ISP.  In the meantime, exposure must be changed
externally.

Tested-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Tested-by: Robert Mader<robert.mader@collabora.com>

Changes in v8:
- A missing `status = Adjusted' added to
  SimpleCameraConfiguration::validate.
- Code comments regarding raw colour space for raw requested roles
  added.
- Dropped raw format helpers.

Changes in v7:
- Rebased on current master.

Changes in v6:
- An unnecessary copy of formats avoided.
- rawRequested_ and processedrequested_ set to false when there are no
  roles.
- rawRequested_ and processedrequested_ updated in
  SimpleCameraConfiguration::validate().

Changes in v5:
- Possible temporary segfault in the patch adding plain output
  configurations avoided.
- PixelFormatInfo::isRaw() helper added.
- SimplePipelineHandler::setUpFormatSizes replaced with a lambda
  function.
- SimpleCameraData::{rawRequested_,processedRequested_} are set in
  SimpleCameraConfiguration first and copied to SimpleCameraData only
  after successful configure().

Changes in v4:
- Broken range pruning due to passing a value rather than a reference
  fixed.
- New common function isFormatRaw introduced.
- The patch assigning colour spaces in the simple pipeline, previously
  posted separately, included in this series, as the first patch.  It
  can still be handled separately; in any case the rest sort of depends
  on it.
- Setting metadataRequired to false where needed to prevent freezes and
  assertion errors; related to metadata reporting support merged to
  master since v3.

Changes in v3:
- Significantly reworked, with both functional and clarity improvements.
  The level of guesswork and confusion is hopefully reduced enough now
  to drop the RFC prefix.
- The number of streams is set to 2 only with software ISP.
- SimpleCameraData::pipeConfig_ nullptr check patch dropped.
- PPM/raw file output patch dropped from this series.  Let’s handle this
  separately as the patch series is already complex enough.

Changes in v2:
- Completely reworked.
- Extended to be able to produce a raw stream together with a processed
  stream.

Milan Zamazal (10):
  libcamera: software_isp: Assign colour spaces in configurations
  libcamera: simple: Set the number of software ISP streams to 2
  libcamera: simple: Don't use raw output formats with conversions
  libcamera: simple: Add plain output configurations
  libcamera: simple: Identify requested stream roles
  libcamera: simple: Consider raw output configurations
  libcamera: simple: Validate raw stream configurations
  libcamera: simple: Don't enforce conversion with an added raw stream
  libcamera: simple: Require metadata only when software ISP is used
  libcamera: simple: Make raw streams working

 src/libcamera/pipeline/simple/simple.cpp | 293 ++++++++++++++++++-----
 1 file changed, 230 insertions(+), 63 deletions(-)