Show a cover letter.

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

{
    "id": 20913,
    "url": "https://patchwork.libcamera.org/api/1.1/covers/20913/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/20913/",
    "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": "<20240815081622.174210-1-mzamazal@redhat.com>",
    "date": "2024-08-15T08:16:04",
    "name": "[v4,00/18] Software ISP refactoring",
    "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/20913/mbox/",
    "series": [
        {
            "id": 4520,
            "url": "https://patchwork.libcamera.org/api/1.1/series/4520/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=4520",
            "date": "2024-08-15T08:16:04",
            "name": "Software ISP refactoring",
            "version": 4,
            "mbox": "https://patchwork.libcamera.org/series/4520/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/20913/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 19E56C323E\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 15 Aug 2024 08:16:49 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 2425C633BD;\n\tThu, 15 Aug 2024 10:16:48 +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 C743463393\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 15 Aug 2024 10:16:46 +0200 (CEST)",
            "from mx-prod-mc-04.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-548-No7XGHetNruJzfQAa_L4wA-1;\n\tThu, 15 Aug 2024 04:16:41 -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-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTPS id 4F3131955BF2; Thu, 15 Aug 2024 08:16:40 +0000 (UTC)",
            "from nuthatch.redhat.com (unknown [10.45.225.128])\n\tby mx-prod-int-04.mail-002.prod.us-west-2.aws.redhat.com (Postfix)\n\twith ESMTP id 2C3DB19560A3; Thu, 15 Aug 2024 08:16:37 +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=\"bSkn/ViU\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n\ts=mimecast20190719; t=1723709805;\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=kYJCAoR6xul2n0bOv25KpHOyyVt5Fc5n9lCoVP1Qruc=;\n\tb=bSkn/ViUum02b5Z8rNV1h5ZB78xGNuMJ+TRuuWqET8LBl+Tfmm1MBSQxiso3HU5wCi33Dw\n\tDe691WvpUkLUlGNwqbsM67toRAbuNtJNsA/N6HftLGP9ev6LoOViYlNS4ozI90cxzMJ6qd\n\tRkQyThLCrBiOgv242Bmx+mao06S2s5M=",
        "X-MC-Unique": "No7XGHetNruJzfQAa_L4wA-1",
        "From": "Milan Zamazal <mzamazal@redhat.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Cc": "Milan Zamazal <mzamazal@redhat.com>,\n\tUmang Jain <umang.jain@ideasonboard.com>,\n\tLaurent Pinchart <laurent.pinchart@ideasonboard.com>,\n\tDaniel Scally <dan.scally@ideasonboard.com>",
        "Subject": "[PATCH v4 00/18] Software ISP refactoring",
        "Date": "Thu, 15 Aug 2024 10:16:04 +0200",
        "Message-ID": "<20240815081622.174210-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-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": "<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": "The purpose of this patch series is to bring software ISP code\nstructuring closer to the hardware pipelines.  Most notably, the API\naround algorithm.h is used now.  This should make software ISP easier to\nunderstand, extend, maintain, and code-share with the other pipelines.\n\nWhat is omitted in the patch series:\n\n- Any bigger or unrelated functional changes.  The purpose of this\n  series is code restructuring, which is enough already.\n- Stats and params buffers are still used in the original way.  Making\n  their handling closer to the hardware pipelines will be a subject of\n  followup patches.  This series is a preparation step for that.\n- Any IPA code sharing with hardware pipelines.  If there is an\n  opportunity for this, it can be addressed in followup patches.\n\nAvailable in git at\nhttps://gitlab.freedesktop.org/camera/libcamera-softisp/-/commits/pdm-algorithm\n\nPending (see v3 review discussions):\n- Should `frame' argument name be kept for consistency with other\n  pipelines for now or already renamed to something like\n  `sequenceNumber'?\n- Should black level be stored as a 0..1 number or a pixel value\n  number?\n\nChanges in v4:\n- Removed the mistakenly included patches by Umang.\n- IPASoftInterface::prepare() is async now.\n- IPAConfigInfo definition moved to an earlier patch to avoid\n  unnecessary confusion.\n- colors.cpp/h split to gamma and awb.\n- Using the right black level variable in Agc::process.\n- Documentation of the newly introduced SwStatsCpu::finishFrame\n  arguments added.\n- Formatting changes as requested.\n- A forgotten obsolete source code comment removed.\n- Improvements to some commit messages.\n\nChanges in v3:\n- SoftwareIsp::queueRequest changed to async.\n- IPAActiveState docstring reworded.\n- Minor formatting fixes.\n\nChanges in v2:\n- Several cosmetic changes and patch arrangement problems pointed out by\n  Umang applied.\n- Added ipa_context.cpp, as a documentation file for ipa_context.h.\n- Added a clarification source comment why SoftwareIsp::queueBuffers needs\n  to get the frame number as a separate argument.\n- core_ipa_interface.h no longer included in module.h.\n- The context used by \"14/19 Move black level to an algorithm module\"\n  was changed and the black level changes tracking was put closer to the\n  pre-refactoring version, which makes more sense.\n\nMilan Zamazal (18):\n  libcamera: software_isp: Remove superfluous includes\n  libcamera: software_isp: Move BlackLevel to libcamera::ipa::soft\n  libcamera: software_isp: Define skeletons for IPA refactoring\n  libcamera: software_isp: Let IPASoftSimple inherit Module\n  libcamera: software_isp: Make stats frame and buffer aware\n  libcamera: software_isp: Remove final dots in debayer.cpp docstrings\n  libcamera: software_isp: Track and pass frame ids\n  libcamera: software_isp: Create algorithms\n  libcamera: software_isp: Call Algorithm::configure\n  libcamera: software_isp: Call Algorithm::queueRequest\n  libcamera: software_isp: Call Algorithm::prepare\n  libcamera: software_isp: Call Algorithm::process\n  libcamera: software_isp: Move black level to an algorithm module\n  libcamera: software_isp: Move color handling to an algorithm module\n  libcamera: software_isp: Use floating point for color parameters\n  libcamera: software_isp: Use DelayedControls\n  libcamera: software_isp: Move exposure+gain to an algorithm module\n  libcamera: software_isp: Update black level only on exposure changes\n\n .../internal/software_isp/software_isp.h      |  15 +-\n include/libcamera/ipa/soft.mojom              |  12 +-\n src/ipa/simple/algorithms/agc.cpp             | 139 +++++++++\n src/ipa/simple/algorithms/agc.h               |  36 +++\n src/ipa/simple/algorithms/algorithm.h         |  22 ++\n src/ipa/simple/algorithms/awb.cpp             |  96 ++++++\n src/ipa/simple/algorithms/awb.h               |  43 +++\n src/ipa/simple/algorithms/blc.cpp             |  78 +++++\n src/ipa/simple/algorithms/blc.h               |  41 +++\n src/ipa/simple/algorithms/gamma.cpp           |  64 ++++\n src/ipa/simple/algorithms/gamma.h             |  42 +++\n src/ipa/simple/algorithms/meson.build         |   8 +\n src/ipa/simple/black_level.cpp                |  88 ------\n src/ipa/simple/black_level.h                  |  29 --\n src/ipa/simple/data/uncalibrated.yaml         |   5 +\n src/ipa/simple/ipa_context.cpp                | 102 +++++++\n src/ipa/simple/ipa_context.h                  |  66 ++++\n src/ipa/simple/meson.build                    |   9 +-\n src/ipa/simple/module.h                       |  31 ++\n src/ipa/simple/soft_simple.cpp                | 283 ++++++------------\n src/libcamera/pipeline/simple/simple.cpp      |  45 ++-\n src/libcamera/software_isp/TODO               |  39 ---\n src/libcamera/software_isp/debayer.cpp        |  51 ++--\n src/libcamera/software_isp/debayer.h          |   2 +-\n src/libcamera/software_isp/debayer_cpu.cpp    |   9 +-\n src/libcamera/software_isp/debayer_cpu.h      |   2 +-\n src/libcamera/software_isp/software_isp.cpp   |  43 ++-\n src/libcamera/software_isp/swstats_cpu.cpp    |   6 +-\n src/libcamera/software_isp/swstats_cpu.h      |   4 +-\n 29 files changed, 987 insertions(+), 423 deletions(-)\n create mode 100644 src/ipa/simple/algorithms/agc.cpp\n create mode 100644 src/ipa/simple/algorithms/agc.h\n create mode 100644 src/ipa/simple/algorithms/algorithm.h\n create mode 100644 src/ipa/simple/algorithms/awb.cpp\n create mode 100644 src/ipa/simple/algorithms/awb.h\n create mode 100644 src/ipa/simple/algorithms/blc.cpp\n create mode 100644 src/ipa/simple/algorithms/blc.h\n create mode 100644 src/ipa/simple/algorithms/gamma.cpp\n create mode 100644 src/ipa/simple/algorithms/gamma.h\n create mode 100644 src/ipa/simple/algorithms/meson.build\n delete mode 100644 src/ipa/simple/black_level.cpp\n delete mode 100644 src/ipa/simple/black_level.h\n create mode 100644 src/ipa/simple/ipa_context.cpp\n create mode 100644 src/ipa/simple/ipa_context.h\n create mode 100644 src/ipa/simple/module.h"
}