Show a cover letter.

GET /api/1.1/covers/23142/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 23142,
    "url": "https://patchwork.libcamera.org/api/1.1/covers/23142/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/23142/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/1.1/projects/1/?format=api",
        "name": "libcamera",
        "link_name": "libcamera",
        "list_id": "libcamera_core",
        "list_email": "libcamera-devel@lists.libcamera.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20250407085639.16180-1-mzamazal@redhat.com>",
    "date": "2025-04-07T08:56:26",
    "name": "[v4,00/11] Enable raw streams with software ISP",
    "submitter": {
        "id": 177,
        "url": "https://patchwork.libcamera.org/api/1.1/people/177/?format=api",
        "name": "Milan Zamazal",
        "email": "mzamazal@redhat.com"
    },
    "mbox": "https://patchwork.libcamera.org/cover/23142/mbox/",
    "series": [
        {
            "id": 5117,
            "url": "https://patchwork.libcamera.org/api/1.1/series/5117/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=5117",
            "date": "2025-04-07T08:56:26",
            "name": "Enable raw streams with software ISP",
            "version": 4,
            "mbox": "https://patchwork.libcamera.org/series/5117/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/23142/comments/",
    "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 5E74EC327D\n\tfor <parsemail@patchwork.libcamera.org>;\n\tMon,  7 Apr 2025 08:57:04 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id C2807689AC;\n\tMon,  7 Apr 2025 10:57:02 +0200 (CEST)",
            "from us-smtp-delivery-124.mimecast.com\n\t(us-smtp-delivery-124.mimecast.com [170.10.133.124])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id BF8E26899C\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon,  7 Apr 2025 10:57:00 +0200 (CEST)",
            "from mx-prod-mc-03.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-508-mzejIeOMNbK8F6J-yABaag-1;\n\tMon, 07 Apr 2025 04:56:56 -0400",
            "from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com\n\t(mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com\n\t[10.30.177.111])\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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTPS id CB99A1955BC6; Mon,  7 Apr 2025 08:56:54 +0000 (UTC)",
            "from mzamazal-thinkpadp1gen7.tpbc.com (unknown [10.45.224.129])\n\tby mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTP id 0047D180176A; Mon,  7 Apr 2025 08:56:52 +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=\"ifD2/RkI\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n\ts=mimecast20190719; t=1744016219;\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\tbh=O0cgRhtuYoqL2F1itcm2QZGYItT4+VauL1si1x5ODSw=;\n\tb=ifD2/RkIAZzJwlOSt7qFCVlNdSjEnxbvPKxOd64/TEHziicabz3P9WOwj1yM/E7gY24zTS\n\tgUA6tztydj1o90u3J22qdQznjExr6nhVKiXiEz9Qw6M4JAwM2ISw46TQbJsT5fRFyREQr/\n\t2tMk3xo3Bdh5Mk6Yci66WYvExom03Mw=",
        "X-MC-Unique": "mzejIeOMNbK8F6J-yABaag-1",
        "X-Mimecast-MFC-AGG-ID": "mzejIeOMNbK8F6J-yABaag_1744016215",
        "From": "Milan Zamazal <mzamazal@redhat.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Cc": "Milan Zamazal <mzamazal@redhat.com>,\n\tLaurent Pinchart <laurent.pinchart@ideasonboard.com>,\n\tKieran Bingham <kieran.bingham@ideasonboard.com>",
        "Subject": "[PATCH v4 00/11] Enable raw streams with software ISP",
        "Date": "Mon,  7 Apr 2025 10:56:26 +0200",
        "Message-ID": "<20250407085639.16180-1-mzamazal@redhat.com>",
        "MIME-Version": "1.0",
        "X-Scanned-By": "MIMEDefang 3.4.1 on 10.30.177.111",
        "X-Mimecast-Spam-Score": "0",
        "X-Mimecast-MFC-PROC-ID": "pdVqHsxT2VuUKxDM0IC1gVezNbzn4QdeQefENEk-Pqk_1744016215",
        "X-Mimecast-Originator": "redhat.com",
        "Content-Type": "text/plain; charset=UTF-8",
        "Content-Transfer-Encoding": "8bit",
        "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>"
    },
    "content": "This makes raw streams working again in ‘simple’ pipeline when software\nISP is enabled for the given device.  At most one raw stream and one\nprocessed stream (possibly both at once) are supported.\n\nAn example ‘cam’ invocation requesting a raw stream rather than a debayered stream:\n\n  cam -c1 -C8 -s role=raw,width=1920,height=1080 -Ffile#.raw\n\nOr for both raw and processed streams:\n\n  cam -c1 -C8 -Ffile# \\\n    -s role=viewfinder,width=1920,height=1080,pixelformat=RGB888 \\\n    -s role=raw,width=3280,height=2464,pixelformat=SRGGB8 \\\n\nWhen only a raw stream is requested, there are no exposure/gain\nadjustments applied.  This could be improved in future, once software\nISP gets a mechanism to gather image statistics without processing and\nusing them to make the adjustments, or once manual exposure controls are\nadded to software ISP.  In the meantime, exposure must be changed\nexternally.\n\nChanges in v4:\n- Broken range pruning due to passing a value rather than a reference\n  fixed.\n- New common function isFormatRaw introduced.\n- The patch assigning colour spaces in the simple pipeline, previously\n  posted separately, included in this series, as the first patch.  It\n  can still be handled separately; in any case the rest sort of depends\n  on it.\n- Setting metadataRequired to false where needed to prevent freezes and\n  assertion errors; related to metadata reporting support merged to\n  master since v3.\n\nChanges in v3:\n- Significantly reworked, with both functional and clarity improvements.\n  The level of guesswork and confusion is hopefully reduced enough now\n  to drop the RFC prefix.\n- The number of streams is set to 2 only with software ISP.\n- SimpleCameraData::pipeConfig_ nullptr check patch dropped.\n- PPM/raw file output patch dropped from this series.  Let’s handle this\n  separately as the patch series is already complex enough.\n\nChanges in v2:\n- Completely reworked.\n- Extended to be able to produce a raw stream together with a processed\n  stream.\n\nMilan Zamazal (11):\n  libcamera: software_isp: Assign colour spaces in configurations\n  libcamera: simple: Set the number of software ISP streams to 2\n  libcamera: formats: Add a helper to check for a raw pixel format\n  libcamera: simple: Don't use raw output formats with conversions\n  libcamera: simple: Add plain output configurations\n  libcamera: simple: Identify requested stream roles\n  libcamera: simple: Consider raw output configurations\n  libcamera: simple: Validate raw stream configurations\n  libcamera: simple: Don't enforce conversion with an added raw stream\n  libcamera: simple: Require metadata only when software ISP is used\n  libcamera: simple: Make raw streams working\n\n include/libcamera/internal/formats.h         |   2 +\n src/libcamera/formats.cpp                    |  11 +\n src/libcamera/pipeline/imx8-isi/imx8-isi.cpp |   4 +-\n src/libcamera/pipeline/mali-c55/mali-c55.cpp |  10 -\n src/libcamera/pipeline/rkisp1/rkisp1.cpp     |   7 +-\n src/libcamera/pipeline/simple/simple.cpp     | 255 ++++++++++++++-----\n 6 files changed, 212 insertions(+), 77 deletions(-)"
}