Show a cover letter.

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

{
    "id": 21278,
    "url": "https://patchwork.libcamera.org/api/covers/21278/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/21278/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/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": "<20240916045802.3799103-1-chenghaoyang@google.com>",
    "date": "2024-09-16T04:51:54",
    "name": "[0/1] Add StreamRole into StreamConfiguration",
    "submitter": {
        "id": 117,
        "url": "https://patchwork.libcamera.org/api/people/117/?format=api",
        "name": "Cheng-Hao Yang",
        "email": "chenghaoyang@chromium.org"
    },
    "mbox": "https://patchwork.libcamera.org/cover/21278/mbox/",
    "series": [
        {
            "id": 4600,
            "url": "https://patchwork.libcamera.org/api/series/4600/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=4600",
            "date": "2024-09-16T04:51:54",
            "name": "Add StreamRole into StreamConfiguration",
            "version": 1,
            "mbox": "https://patchwork.libcamera.org/series/4600/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/21278/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 B372DC3257\n\tfor <parsemail@patchwork.libcamera.org>;\n\tMon, 16 Sep 2024 04:58:16 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id A3020634FD;\n\tMon, 16 Sep 2024 06:58:15 +0200 (CEST)",
            "from mail-pf1-x429.google.com (mail-pf1-x429.google.com\n\t[IPv6:2607:f8b0:4864:20::429])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 6C704618E3\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon, 16 Sep 2024 06:58:13 +0200 (CEST)",
            "by mail-pf1-x429.google.com with SMTP id\n\td2e1a72fcca58-718e3c98b5aso2677813b3a.0\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tSun, 15 Sep 2024 21:58:13 -0700 (PDT)",
            "from chenghaoyang-low.c.googlers.com.com\n\t(208.158.221.35.bc.googleusercontent.com. [35.221.158.208])\n\tby smtp.gmail.com with ESMTPSA id\n\td2e1a72fcca58-71944ab5590sm2996267b3a.65.2024.09.15.21.58.10\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tSun, 15 Sep 2024 21:58:10 -0700 (PDT)"
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=chromium.org header.i=@chromium.org\n\theader.b=\"d3Y/wzrs\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=chromium.org; s=google; t=1726462691; x=1727067491;\n\tdarn=lists.libcamera.org; \n\th=content-transfer-encoding:mime-version:message-id:date:subject:cc\n\t:to:from:from:to:cc:subject:date:message-id:reply-to;\n\tbh=vt+F6Gx1EW4w19X7jkYCEZKCkX7oeYRk4LgxKfpnNgc=;\n\tb=d3Y/wzrsX2G82yFPQae3xjrmimRyo5+W3Prg11gyeCd+NjYqKtj5FsPtLsRUbkA3Uz\n\tnluCKqZtf8kjqWYL/46tQDfBy9uIpYMjlKoAgmnkJfFZ5zWBENbAuIlBVttKItSv00rM\n\tRGGiasWEkS12A09RSH1eymWmc3D8Yuehh2NhI=",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20230601; t=1726462691; x=1727067491;\n\th=content-transfer-encoding:mime-version:message-id:date:subject:cc\n\t:to:from:x-gm-message-state:from:to:cc:subject:date:message-id\n\t:reply-to;\n\tbh=vt+F6Gx1EW4w19X7jkYCEZKCkX7oeYRk4LgxKfpnNgc=;\n\tb=H5AFrj8jnu32S8cZlktbI4tT/meKz+N39YBmBpGI3KuHm+npke5GcFtW05vNerlg/p\n\tZmmLJTWCSQ/UWju3WHpALRGuDjmu8ryJlaBCdKJZfnZswpqebQUv5H0AvWEUw5AAwGGU\n\tiXQsOfgzHSeqlCTLMJSwpzD/BxWsXPgH4dpyk1ZZvaLDVGCWh8Wqcn08FTe3EgmbLN+N\n\tYCyUBbD65ayDo+1rrL+pLMumQMGyTQtYBciB/vtaHsW5No1R/zDRv+w0z+PyZrP2F7Ul\n\tm+uRpuXbWoFJKJ4o4H06aUJga9/klKnoRB0vGuZY9j0Tkf9EkhyWnGwX9dsrZMcvQ64c\n\tdFiw==",
        "X-Gm-Message-State": "AOJu0YwI22lRX9rSy3xo59jUD/yQeQgDzo0Mp5KT33yFchKHv82WeLKX\n\tRlVap9aGF1BOpEftC2ppYkyWS5UTTqqMscORHug2DM5BXAwOOfrsfdM/90ojYnj0L2dZ9FXRp5o\n\t=",
        "X-Google-Smtp-Source": "AGHT+IFrMW3xI1l4YK0im6/ZtRLnYTNa7wxpDJjxSCKUDblWidNsoUdd4Gdc4T2XN63scL3ykhjAEA==",
        "X-Received": "by 2002:a05:6a00:ac9:b0:718:d8dc:308a with SMTP id\n\td2e1a72fcca58-7192606c44emr20998632b3a.12.1726462691479; \n\tSun, 15 Sep 2024 21:58:11 -0700 (PDT)",
        "From": "Harvey Yang <chenghaoyang@chromium.org>",
        "X-Google-Original-From": "Harvey Yang <chenghaoyang@google.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Cc": "Harvey Yang <chenghaoyang@google.com>",
        "Subject": "[PATCH 0/1] Add StreamRole into StreamConfiguration",
        "Date": "Mon, 16 Sep 2024 04:51:54 +0000",
        "Message-ID": "<20240916045802.3799103-1-chenghaoyang@google.com>",
        "X-Mailer": "git-send-email 2.46.0.662.g92d0881bb0-goog",
        "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": "<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": "Hi folks,\n\nCurrently applications set resolutions, pixelFormat, bufferCount, etc,\ninto StreamConfigurations, and Pipeline Handler decides which streams\nthey're assigned to. However, it doesn't allow application to assign\nstreams that cannot be distinguished by those arguments into\nVideoRecording or StillCapture (say YUV/NV12 format), which is needed in\nmtkisp7.\n\nThis patch allows application to set the desired StreamRole directly.\n\nThis patch passed gitlab pipeline:\nhttps://gitlab.freedesktop.org/chenghaoyang/libcamera/-/pipelines/1271770\n\nIt might be controversial. Let me know the concerns. Thanks!\n\nBR,\nHarvey\n\n\n\nHan-Lin Chen (1):\n  libcamera: Add StreamRole into StreamConfiguration\n\n include/libcamera/stream.h |  2 ++\n src/libcamera/stream.cpp   | 12 ++++++++++--\n 2 files changed, 12 insertions(+), 2 deletions(-)"
}