Show a patch.

GET /api/patches/15091/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 15091,
    "url": "https://patchwork.libcamera.org/api/patches/15091/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/15091/",
    "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": "<20211209101245.6187-2-david.plowman@raspberrypi.com>",
    "date": "2021-12-09T10:12:38",
    "name": "[libcamera-devel,v10,1/8] libcamera: Add ColorSpace class",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "18a69638de8d7fe9af264e5ae7fc355d5aeee3e0",
    "submitter": {
        "id": 42,
        "url": "https://patchwork.libcamera.org/api/people/42/?format=api",
        "name": "David Plowman",
        "email": "david.plowman@raspberrypi.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/15091/mbox/",
    "series": [
        {
            "id": 2830,
            "url": "https://patchwork.libcamera.org/api/series/2830/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=2830",
            "date": "2021-12-09T10:12:37",
            "name": "Colour spaces",
            "version": 10,
            "mbox": "https://patchwork.libcamera.org/series/2830/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/15091/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/15091/checks/",
    "tags": {},
    "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 CC730C324B\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu,  9 Dec 2021 10:13:34 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 1ED8460889;\n\tThu,  9 Dec 2021 11:13:33 +0100 (CET)",
            "from mail-wr1-x42f.google.com (mail-wr1-x42f.google.com\n\t[IPv6:2a00:1450:4864:20::42f])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 057E460224\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu,  9 Dec 2021 11:13:32 +0100 (CET)",
            "by mail-wr1-x42f.google.com with SMTP id t9so8757848wrx.7\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 09 Dec 2021 02:13:32 -0800 (PST)",
            "from pi4-davidp.pitowers.org\n\t([2a00:1098:3142:14:e4a2:3070:eea4:e434])\n\tby smtp.gmail.com with ESMTPSA id\n\tj8sm5079449wrh.16.2021.12.09.02.13.30\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tThu, 09 Dec 2021 02:13:30 -0800 (PST)"
        ],
        "Authentication-Results": "lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=raspberrypi.com header.i=@raspberrypi.com\n\theader.b=\"SgOk1daF\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=raspberrypi.com; s=google;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:mime-version:content-transfer-encoding;\n\tbh=rXCAAkH7rZsll+xp0ceTS/onnCa0D67p71c9GYeoz3c=;\n\tb=SgOk1daF+TXVT0fOmONNDf3jB+Ao1v1xGq2dOpi5LbOfbYZkpegbuy3Zt8Olsv0U1m\n\tqAftYKFvGbf+3XodnwHShY5OqfBjGPcY+Py9c4Tmep4msx7W0TdoM9Ty5nMxSZIr3jiR\n\tH71uTDddQVCcQDd6rQTIu53QNSm1Hw6d8J59VNKJlVFRpqd+77C/SPWEgou5GX3ImXxl\n\tZqgitTG4SShculqs1b08yCVTC6dn9mRskL7k81h53dSPGqU9QjKHzX3phOjnKU4UVApN\n\tpOqJX1u2UmKRqQ7V2rBxqcPTEW/ENnIiI10nZSn85XXc5Isk+CIje1EXBR8M7hcpitC4\n\t1Blg==",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20210112;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references:mime-version:content-transfer-encoding;\n\tbh=rXCAAkH7rZsll+xp0ceTS/onnCa0D67p71c9GYeoz3c=;\n\tb=ddQ8IJcsZYtT04Zubzk+Hhhrzj4/ThkwAR3AT6u+pU48LToIq3oMKMi6eoRsVbaALk\n\tQuDc1t/1+V3//0bsCbxcVtS9id2QkX5kY9RgepM6HBaorxf5k8LCEpz2yxZcjcnpQ6Yg\n\tvF4YO1L7JdDRUvj8ii+FJvxjNWC1vd8gZyyY5cOJCt1t+jWsr3lMWKtu6ZaNmlJclfbI\n\tgSoEd+wDuNfRv3Mt/2Vb37n2ktfFGVmVdsHMrFvQcCF0p/ZjTAzkMp1kaToY8JvAgnKy\n\t54JGg6mdjxgjk3VF1l3yJ+qrI/A8bXQ7tyD+Vc64okgERXWp9yrQPBDM2QZb6T+dDAef\n\trCYg==",
        "X-Gm-Message-State": "AOAM531/nezR2MBBvjEULHsnbN/aZXKM0yrjdoo3u6lEYkN/8yAp87ML\n\tWHKGf1EBkZUhCbOTlsyJ3gtFTdpVxgYeKRAZ",
        "X-Google-Smtp-Source": "ABdhPJwJXQUGpWljdQlaDh/zm3ZPp/+7QFrLynTXHVPITCqqPy6ETOI12d1JOELYwhN1ihEUT4j5Kg==",
        "X-Received": "by 2002:adf:82d3:: with SMTP id 77mr5279150wrc.377.1639044811159;\n\tThu, 09 Dec 2021 02:13:31 -0800 (PST)",
        "From": "David Plowman <david.plowman@raspberrypi.com>",
        "To": "libcamera-devel@lists.libcamera.org,\n\tLaurent Pinchart <laurent.pinchart@ideasonboard.com>,\n\tKieran Bingham <kieran.bingham@ideasonboard.com>,\n\tHans Verkuil <hverkuil-cisco@xs4all.nl>, Tomasz Figa <tfiga@google.com>, \n\tJacopo Mondi <jacopo@jmondi.org>, Naushir Patuck <naush@raspberrypi.com>",
        "Date": "Thu,  9 Dec 2021 10:12:38 +0000",
        "Message-Id": "<20211209101245.6187-2-david.plowman@raspberrypi.com>",
        "X-Mailer": "git-send-email 2.30.2",
        "In-Reply-To": "<20211209101245.6187-1-david.plowman@raspberrypi.com>",
        "References": "<20211209101245.6187-1-david.plowman@raspberrypi.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH v10 1/8] libcamera: Add ColorSpace class",
        "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 class represents a color space by defining its color primaries,\nthe transfer (gamma) function it uses, the YCbCr encoding and whether\nthe output is full or limited range.\n\nSigned-off-by: David Plowman <david.plowman@raspberrypi.com>\nReviewed-by: Naushir Patuck <naush@raspberrypi.com>\nReviewed-by: Umang Jain <umang.jain@ideasonboard.com>\nReviewed-by: Jacopo Mondi <jacopo@jmondi.org>\nReviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\n---\n include/libcamera/color_space.h |  70 +++++++\n include/libcamera/meson.build   |   1 +\n src/libcamera/color_space.cpp   | 318 ++++++++++++++++++++++++++++++++\n src/libcamera/meson.build       |   1 +\n 4 files changed, 390 insertions(+)\n create mode 100644 include/libcamera/color_space.h\n create mode 100644 src/libcamera/color_space.cpp",
    "diff": "diff --git a/include/libcamera/color_space.h b/include/libcamera/color_space.h\nnew file mode 100644\nindex 00000000..086c56c1\n--- /dev/null\n+++ b/include/libcamera/color_space.h\n@@ -0,0 +1,70 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2021, Raspberry Pi (Trading) Limited\n+ *\n+ * color_space.h - color space definitions\n+ */\n+\n+#pragma once\n+\n+#include <optional>\n+#include <string>\n+\n+namespace libcamera {\n+\n+class ColorSpace\n+{\n+public:\n+\tenum class Primaries {\n+\t\tRaw,\n+\t\tSmpte170m,\n+\t\tRec709,\n+\t\tRec2020,\n+\t};\n+\n+\tenum class TransferFunction {\n+\t\tLinear,\n+\t\tSrgb,\n+\t\tRec709,\n+\t};\n+\n+\tenum class YcbcrEncoding {\n+\t\tNone,\n+\t\tRec601,\n+\t\tRec709,\n+\t\tRec2020,\n+\t};\n+\n+\tenum class Range {\n+\t\tFull,\n+\t\tLimited,\n+\t};\n+\n+\tconstexpr ColorSpace(Primaries p, TransferFunction t, YcbcrEncoding e, Range r)\n+\t\t: primaries(p), transferFunction(t), ycbcrEncoding(e), range(r)\n+\t{\n+\t}\n+\n+\tstatic const ColorSpace Raw;\n+\tstatic const ColorSpace Jpeg;\n+\tstatic const ColorSpace Srgb;\n+\tstatic const ColorSpace Smpte170m;\n+\tstatic const ColorSpace Rec709;\n+\tstatic const ColorSpace Rec2020;\n+\n+\tPrimaries primaries;\n+\tTransferFunction transferFunction;\n+\tYcbcrEncoding ycbcrEncoding;\n+\tRange range;\n+\n+\tstd::string toString() const;\n+\tstatic std::string toString(const std::optional<ColorSpace> &colorSpace);\n+};\n+\n+bool operator==(const ColorSpace &lhs, const ColorSpace &rhs);\n+static inline bool operator!=(const ColorSpace &lhs, const ColorSpace &rhs)\n+{\n+\treturn !(lhs == rhs);\n+}\n+\n+} /* namespace libcamera */\ndiff --git a/include/libcamera/meson.build b/include/libcamera/meson.build\nindex 5f42977c..fd767b11 100644\n--- a/include/libcamera/meson.build\n+++ b/include/libcamera/meson.build\n@@ -5,6 +5,7 @@ libcamera_include_dir = 'libcamera' / 'libcamera'\n libcamera_public_headers = files([\n     'camera.h',\n     'camera_manager.h',\n+    'color_space.h',\n     'controls.h',\n     'framebuffer.h',\n     'framebuffer_allocator.h',\ndiff --git a/src/libcamera/color_space.cpp b/src/libcamera/color_space.cpp\nnew file mode 100644\nindex 00000000..6c587068\n--- /dev/null\n+++ b/src/libcamera/color_space.cpp\n@@ -0,0 +1,318 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2021, Raspberry Pi (Trading) Limited\n+ *\n+ * color_space.cpp - color spaces.\n+ */\n+\n+#include <libcamera/color_space.h>\n+\n+#include <algorithm>\n+#include <array>\n+#include <map>\n+#include <sstream>\n+#include <utility>\n+\n+/**\n+ * \\file color_space.h\n+ * \\brief Class and enums to represent color spaces\n+ */\n+\n+namespace libcamera {\n+\n+/**\n+ * \\class ColorSpace\n+ * \\brief Class to describe a color space\n+ *\n+ * The ColorSpace class defines the color primaries, the Y'CbCr encoding,\n+ * the transfer function associated with the color space, and the range\n+ * (sometimes also referred to as the quantisation) of the color space.\n+ *\n+ * Certain combinations of these fields form well-known standard color\n+ * spaces such as \"JPEG\" or \"REC709\".\n+ *\n+ * In the strictest sense a \"color space\" formally only refers to the\n+ * color primaries and white point. Here, however, the ColorSpace class\n+ * adopts the common broader usage that includes the transfer function,\n+ * Y'CbCr encoding method and quantisation.\n+ *\n+ * For more information on the specific color spaces described here, please\n+ * see:\n+ *\n+ * - <a href=\"https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/colorspaces-details.html#col-srgb\">sRGB</a>\n+ * - <a href=\"https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/colorspaces-details.html#col-jpeg\">JPEG</a>\n+ * - <a href=\"https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/colorspaces-details.html#col-smpte-170m\">SMPTE 170M</a>\n+ * - <a href=\"https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/colorspaces-details.html#col-rec709\">Rec.709</a>\n+ * - <a href=\"https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/colorspaces-details.html#col-bt2020\">Rec.2020</a>\n+ */\n+\n+/**\n+ * \\enum ColorSpace::Primaries\n+ * \\brief The color primaries for this color space\n+ *\n+ * \\var ColorSpace::Primaries::Raw\n+ * \\brief These are raw colors directly from a sensor, the primaries are\n+ * unspecified\n+ *\n+ * \\var ColorSpace::Primaries::Smpte170m\n+ * \\brief SMPTE 170M color primaries\n+ *\n+ * \\var ColorSpace::Primaries::Rec709\n+ * \\brief Rec.709 color primaries\n+ *\n+ * \\var ColorSpace::Primaries::Rec2020\n+ * \\brief Rec.2020 color primaries\n+ */\n+\n+/**\n+ * \\enum ColorSpace::TransferFunction\n+ * \\brief The transfer function used for this color space\n+ *\n+ * \\var ColorSpace::TransferFunction::Linear\n+ * \\brief This color space uses a linear (identity) transfer function\n+ *\n+ * \\var ColorSpace::TransferFunction::Srgb\n+ * \\brief sRGB transfer function\n+ *\n+ * \\var ColorSpace::TransferFunction::Rec709\n+ * \\brief Rec.709 transfer function\n+ */\n+\n+/**\n+ * \\enum ColorSpace::YcbcrEncoding\n+ * \\brief The Y'CbCr encoding\n+ *\n+ * \\var ColorSpace::YcbcrEncoding::None\n+ * \\brief There is no defined Y'CbCr encoding\n+ *\n+ * \\var ColorSpace::YcbcrEncoding::Rec601\n+ * \\brief Rec.601 Y'CbCr encoding\n+ *\n+ * \\var ColorSpace::YcbcrEncoding::Rec709\n+ * \\brief Rec.709 Y'CbCr encoding\n+ *\n+ * \\var ColorSpace::YcbcrEncoding::Rec2020\n+ * \\brief Rec.2020 Y'CbCr encoding\n+ */\n+\n+/**\n+ * \\enum ColorSpace::Range\n+ * \\brief The range (sometimes \"quantisation\") for this color space\n+ *\n+ * \\var ColorSpace::Range::Full\n+ * \\brief This color space uses full range pixel values\n+ *\n+ * \\var ColorSpace::Range::Limited\n+ * \\brief This color space uses limited range pixel values, being\n+ * 16 to 235 for Y' and 16 to 240 for Cb and Cr (8 bits per sample)\n+ * or 64 to 940 for Y' and 16 to 960 for Cb and Cr (10 bits)\n+ */\n+\n+/**\n+ * \\fn ColorSpace::ColorSpace(Primaries p, TransferFunction t, Encoding e, Range r)\n+ * \\brief Construct a ColorSpace from explicit values\n+ * \\param[in] p The color primaries\n+ * \\param[in] t The transfer function for the color space\n+ * \\param[in] e The Y'CbCr encoding\n+ * \\param[in] r The range of the pixel values in this color space\n+ */\n+\n+/**\n+ * \\brief Assemble and return a readable string representation of the\n+ * ColorSpace\n+ *\n+ * If the color space matches a standard ColorSpace (such as ColorSpace::Jpeg)\n+ * then the short name of the color space (\"JPEG\") is returned. Otherwise\n+ * the four constituent parts of the ColorSpace are assembled into a longer\n+ * string.\n+ *\n+ * \\return A string describing the ColorSpace\n+ */\n+std::string ColorSpace::toString() const\n+{\n+\t/* Print out a brief name only for standard color spaces. */\n+\n+\tstatic const std::array<std::pair<ColorSpace, const char *>, 6> colorSpaceNames = {\n+\t\t{\n+\t\t\t{ ColorSpace::Raw, \"RAW\" },\n+\t\t\t{ ColorSpace::Jpeg, \"JPEG\" },\n+\t\t\t{ ColorSpace::Srgb, \"sRGB\" },\n+\t\t\t{ ColorSpace::Smpte170m, \"SMPTE170M\" },\n+\t\t\t{ ColorSpace::Rec709, \"Rec709\" },\n+\t\t\t{ ColorSpace::Rec2020, \"Rec2020\" },\n+\t\t}\n+\t};\n+\tauto it = std::find_if(colorSpaceNames.begin(), colorSpaceNames.end(),\n+\t\t\t       [this](const auto &item) {\n+\t\t\t\t       return *this == item.first;\n+\t\t\t       });\n+\tif (it != colorSpaceNames.end())\n+\t\treturn std::string(it->second);\n+\n+\t/* Assemble a name made of the constituent fields. */\n+\n+\tstatic const std::map<Primaries, std::string> primariesNames = {\n+\t\t{ Primaries::Raw, \"Raw\" },\n+\t\t{ Primaries::Smpte170m, \"Smpte170m\" },\n+\t\t{ Primaries::Rec709, \"Rec709\" },\n+\t\t{ Primaries::Rec2020, \"Rec2020\" },\n+\t};\n+\tstatic const std::map<TransferFunction, std::string> transferNames = {\n+\t\t{ TransferFunction::Linear, \"Linear\" },\n+\t\t{ TransferFunction::Srgb, \"Srgb\" },\n+\t\t{ TransferFunction::Rec709, \"Rec709\" },\n+\t};\n+\tstatic const std::map<YcbcrEncoding, std::string> encodingNames = {\n+\t\t{ YcbcrEncoding::None, \"None\" },\n+\t\t{ YcbcrEncoding::Rec601, \"Rec601\" },\n+\t\t{ YcbcrEncoding::Rec709, \"Rec709\" },\n+\t\t{ YcbcrEncoding::Rec2020, \"Rec2020\" },\n+\t};\n+\tstatic const std::map<Range, std::string> rangeNames = {\n+\t\t{ Range::Full, \"Full\" },\n+\t\t{ Range::Limited, \"Limited\" },\n+\t};\n+\n+\tauto itPrimaries = primariesNames.find(primaries);\n+\tstd::string primariesName =\n+\t\titPrimaries == primariesNames.end() ? \"Invalid\" : itPrimaries->second;\n+\n+\tauto itTransfer = transferNames.find(transferFunction);\n+\tstd::string transferName =\n+\t\titTransfer == transferNames.end() ? \"Invalid\" : itTransfer->second;\n+\n+\tauto itEncoding = encodingNames.find(ycbcrEncoding);\n+\tstd::string encodingName =\n+\t\titEncoding == encodingNames.end() ? \"Invalid\" : itEncoding->second;\n+\n+\tauto itRange = rangeNames.find(range);\n+\tstd::string rangeName =\n+\t\titRange == rangeNames.end() ? \"Invalid\" : itRange->second;\n+\n+\tstd::stringstream ss;\n+\tss << primariesName << \"/\" << transferName << \"/\" << encodingName << \"/\" << rangeName;\n+\n+\treturn ss.str();\n+}\n+\n+/**\n+ * \\brief Assemble and return a readable string representation of an\n+ * optional ColorSpace\n+ *\n+ * This is a convenience helper to easily obtain a string representation\n+ * for a ColorSpace in parts of the libcamera API where it is stored in a\n+ * std::optional<>. If the ColorSpace is set, this function returns\n+ * \\a colorSpace.toString(), otherwise it returns \"Unset\".\n+ *\n+ * \\return A string describing the optional ColorSpace\n+ */\n+std::string ColorSpace::toString(const std::optional<ColorSpace> &colorSpace)\n+{\n+\tif (!colorSpace)\n+\t\treturn \"Unset\";\n+\n+\treturn colorSpace->toString();\n+}\n+\n+/**\n+ * \\var ColorSpace::primaries\n+ * \\brief The color primaries of this color space\n+ */\n+\n+/**\n+ * \\var ColorSpace::ycbcrEncoding\n+ * \\brief The Y'CbCr encoding used by this color space\n+ */\n+\n+/**\n+ * \\var ColorSpace::transferFunction\n+ * \\brief The transfer function used by this color space\n+ */\n+\n+/**\n+ * \\var ColorSpace::range\n+ * \\brief The pixel range used with by color space\n+ */\n+\n+/**\n+ * \\brief A constant representing a raw color space (from a sensor)\n+ */\n+const ColorSpace ColorSpace::Raw = {\n+\tPrimaries::Raw,\n+\tTransferFunction::Linear,\n+\tYcbcrEncoding::None,\n+\tRange::Full\n+};\n+\n+/**\n+ * \\brief A constant representing the JPEG color space used for\n+ * encoding JPEG images\n+ */\n+const ColorSpace ColorSpace::Jpeg = {\n+\tPrimaries::Rec709,\n+\tTransferFunction::Srgb,\n+\tYcbcrEncoding::Rec601,\n+\tRange::Full\n+};\n+\n+/**\n+ * \\brief A constant representing the sRGB color space.\n+ * This is identical to the JPEG color space except that the Y'CbCr\n+ * range is limited rather than full.\n+ */\n+const ColorSpace ColorSpace::Srgb = {\n+\tPrimaries::Rec709,\n+\tTransferFunction::Srgb,\n+\tYcbcrEncoding::Rec601,\n+\tRange::Limited\n+};\n+\n+/**\n+ * \\brief A constant representing the SMPTE170M color space\n+ */\n+const ColorSpace ColorSpace::Smpte170m = {\n+\tPrimaries::Smpte170m,\n+\tTransferFunction::Rec709,\n+\tYcbcrEncoding::Rec601,\n+\tRange::Limited\n+};\n+\n+/**\n+ * \\brief A constant representing the Rec.709 color space\n+ */\n+const ColorSpace ColorSpace::Rec709 = {\n+\tPrimaries::Rec709,\n+\tTransferFunction::Rec709,\n+\tYcbcrEncoding::Rec709,\n+\tRange::Limited\n+};\n+\n+/**\n+ * \\brief A constant representing the Rec.2020 color space\n+ */\n+const ColorSpace ColorSpace::Rec2020 = {\n+\tPrimaries::Rec2020,\n+\tTransferFunction::Rec709,\n+\tYcbcrEncoding::Rec2020,\n+\tRange::Limited\n+};\n+\n+/**\n+ * \\brief Compare color spaces for equality\n+ * \\return True if the two color spaces are identical, false otherwise\n+ */\n+bool operator==(const ColorSpace &lhs, const ColorSpace &rhs)\n+{\n+\treturn lhs.primaries == rhs.primaries &&\n+\t       lhs.transferFunction == rhs.transferFunction &&\n+\t       lhs.ycbcrEncoding == rhs.ycbcrEncoding &&\n+\t       lhs.range == rhs.range;\n+}\n+\n+/**\n+ * \\fn bool operator!=(const ColorSpace &lhs, const ColorSpace &rhs)\n+ * \\brief Compare color spaces for inequality\n+ * \\return True if the two color spaces are not identical, false otherwise\n+ */\n+\n+} /* namespace libcamera */\ndiff --git a/src/libcamera/meson.build b/src/libcamera/meson.build\nindex 2e54cc04..4045e24e 100644\n--- a/src/libcamera/meson.build\n+++ b/src/libcamera/meson.build\n@@ -9,6 +9,7 @@ libcamera_sources = files([\n     'camera_manager.cpp',\n     'camera_sensor.cpp',\n     'camera_sensor_properties.cpp',\n+    'color_space.cpp',\n     'controls.cpp',\n     'control_serializer.cpp',\n     'control_validator.cpp',\n",
    "prefixes": [
        "libcamera-devel",
        "v10",
        "1/8"
    ]
}