Patch Detail

HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 15088,
    "url": "https://patchwork.libcamera.org/api/patches/15088/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/15088/",
    "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": "<20211209092906.37303-5-tomi.valkeinen@ideasonboard.com>",
    "date": "2021-12-09T09:29:05",
    "name": "[libcamera-devel,RFC,v3,4/5] Add Python bindings",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "f6039659a1951f621f8751fb6cb428be04dd16ad",
    "submitter": {
        "id": 109,
        "url": "https://patchwork.libcamera.org/api/people/109/?format=api",
        "name": "Tomi Valkeinen",
        "email": "tomi.valkeinen@ideasonboard.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/15088/mbox/",
    "series": [
        {
            "id": 2829,
            "url": "https://patchwork.libcamera.org/api/series/2829/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=2829",
            "date": "2021-12-09T09:29:01",
            "name": "Python bindings",
            "version": 3,
            "mbox": "https://patchwork.libcamera.org/series/2829/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/15088/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/15088/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 34333C3258\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu,  9 Dec 2021 09:29:49 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id AC42A60882;\n\tThu,  9 Dec 2021 10:29:48 +0100 (CET)",
            "from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id D65CE60894\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu,  9 Dec 2021 10:29:44 +0100 (CET)",
            "from deskari.lan (91-156-85-209.elisa-laajakaista.fi\n\t[91.156.85.209])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 359905B0;\n\tThu,  9 Dec 2021 10:29:44 +0100 (CET)"
        ],
        "Authentication-Results": "lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"Ir1qNEKb\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1639042184;\n\tbh=xS4Avf+O/u4s8lmVKykPAiozjSsoK0Aov8RMIeFaICE=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=Ir1qNEKb5BYnh3GE/4DOe35zePJFr4MCmd0Eb7DPuNsB3HpXo3tnbNnzH6IVvKNGO\n\tQVKT4RCYSiD9b9C/nutdvqlax6Xf0ear/FohqpIDEIbpPy5F9do05ujuWKPE0bH/og\n\tPEQRFpy7Y8Y2jAN6M5JlWIXttcTMKD8OsKszNAxI=",
        "From": "Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Date": "Thu,  9 Dec 2021 11:29:05 +0200",
        "Message-Id": "<20211209092906.37303-5-tomi.valkeinen@ideasonboard.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20211209092906.37303-1-tomi.valkeinen@ideasonboard.com>",
        "References": "<20211209092906.37303-1-tomi.valkeinen@ideasonboard.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [RFC v3 4/5] Add Python bindings",
        "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": "Add libcamera Python bindings. pybind11 is used to generate the C++ <->\nPython layer.\n\nOnly a subset of libcamera classes are exposed.\n\nSigned-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\n---\n .gitignore                  |   1 +\n meson.build                 |   1 +\n meson_options.txt           |   5 +\n src/meson.build             |   1 +\n src/py/meson.build          |   1 +\n src/py/pycamera/__init__.py |  10 +\n src/py/pycamera/meson.build |  43 ++++\n src/py/pycamera/pymain.cpp  | 424 ++++++++++++++++++++++++++++++++++++\n subprojects/pybind11.wrap   |  12 +\n 9 files changed, 498 insertions(+)\n create mode 100644 src/py/meson.build\n create mode 100644 src/py/pycamera/__init__.py\n create mode 100644 src/py/pycamera/meson.build\n create mode 100644 src/py/pycamera/pymain.cpp\n create mode 100644 subprojects/pybind11.wrap",
    "diff": "diff --git a/.gitignore b/.gitignore\nindex cca829fa..aae56b2d 100644\n--- a/.gitignore\n+++ b/.gitignore\n@@ -3,6 +3,7 @@\n __pycache__/\n build/\n patches/\n+subprojects/pybind11-2.*/\n *.patch\n *.pyc\n .cache\ndiff --git a/meson.build b/meson.build\nindex a20cc29e..0f885c14 100644\n--- a/meson.build\n+++ b/meson.build\n@@ -181,6 +181,7 @@ summary({\n             'qcam application': qcam_enabled,\n             'lc-compliance application': lc_compliance_enabled,\n             'Unit tests': test_enabled,\n+            'Python bindings': pycamera_enabled,\n         },\n         section : 'Configuration',\n         bool_yn : true)\ndiff --git a/meson_options.txt b/meson_options.txt\nindex 2c80ad8b..ca00c78e 100644\n--- a/meson_options.txt\n+++ b/meson_options.txt\n@@ -58,3 +58,8 @@ option('v4l2',\n         type : 'boolean',\n         value : false,\n         description : 'Compile the V4L2 compatibility layer')\n+\n+option('pycamera',\n+        type : 'feature',\n+        value : 'auto',\n+        description : 'Enable libcamera Python bindings (experimental)')\ndiff --git a/src/meson.build b/src/meson.build\nindex e0ea9c35..4a1e3cb0 100644\n--- a/src/meson.build\n+++ b/src/meson.build\n@@ -38,3 +38,4 @@ subdir('qcam')\n \n subdir('gstreamer')\n subdir('v4l2')\n+subdir('py')\ndiff --git a/src/py/meson.build b/src/py/meson.build\nnew file mode 100644\nindex 00000000..42ffa221\n--- /dev/null\n+++ b/src/py/meson.build\n@@ -0,0 +1 @@\n+subdir('pycamera')\ndiff --git a/src/py/pycamera/__init__.py b/src/py/pycamera/__init__.py\nnew file mode 100644\nindex 00000000..a5c198dc\n--- /dev/null\n+++ b/src/py/pycamera/__init__.py\n@@ -0,0 +1,10 @@\n+# SPDX-License-Identifier: GPL-2.0-or-later\n+# Copyright (C) 2021, Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\n+\n+from .pycamera import *\n+import mmap\n+\n+def __FrameBuffer__mmap(self, plane):\n+\treturn mmap.mmap(self.fd(plane), self.length(plane), mmap.MAP_SHARED, mmap.PROT_READ)\n+\n+FrameBuffer.mmap = __FrameBuffer__mmap\ndiff --git a/src/py/pycamera/meson.build b/src/py/pycamera/meson.build\nnew file mode 100644\nindex 00000000..c490a18d\n--- /dev/null\n+++ b/src/py/pycamera/meson.build\n@@ -0,0 +1,43 @@\n+# SPDX-License-Identifier: CC0-1.0\n+\n+py3_dep = dependency('python3', required : get_option('pycamera'))\n+\n+if not py3_dep.found()\n+    pycamera_enabled = false\n+    subdir_done()\n+endif\n+\n+pycamera_enabled = true\n+\n+pybind11_proj = subproject('pybind11')\n+pybind11_dep = pybind11_proj.get_variable('pybind11_dep')\n+\n+pycamera_sources = files([\n+    'pymain.cpp',\n+])\n+\n+pycamera_deps = [\n+    libcamera_public,\n+    py3_dep,\n+    pybind11_dep,\n+]\n+\n+pycamera_args = [ '-fvisibility=hidden' ]\n+pycamera_args += [ '-Wno-shadow' ]\n+\n+destdir = get_option('libdir') + '/python' + py3_dep.version() + '/site-packages/pycamera'\n+\n+pycamera = shared_module('pycamera',\n+                         pycamera_sources,\n+                         install : true,\n+                         install_dir : destdir,\n+                         name_prefix : '',\n+                         dependencies : pycamera_deps,\n+                         cpp_args : pycamera_args)\n+\n+# XXX > You could also create a symlink. There's an example in the top-level\n+# > meson.build.\n+# Copy __init__.py to build dir so that we can run without installing\n+configure_file(input: '__init__.py', output: '__init__.py', copy: true)\n+\n+install_data(['__init__.py'], install_dir : destdir)\ndiff --git a/src/py/pycamera/pymain.cpp b/src/py/pycamera/pymain.cpp\nnew file mode 100644\nindex 00000000..0088e133\n--- /dev/null\n+++ b/src/py/pycamera/pymain.cpp\n@@ -0,0 +1,424 @@\n+/* SPDX-License-Identifier: LGPL-2.1-or-later */\n+/*\n+ * Copyright (C) 2021, Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\n+ *\n+ * Python bindings\n+ */\n+\n+#include <chrono>\n+#include <fcntl.h>\n+#include <mutex>\n+#include <sys/eventfd.h>\n+#include <sys/mman.h>\n+#include <thread>\n+#include <unistd.h>\n+\n+#include <libcamera/libcamera.h>\n+\n+#include <pybind11/functional.h>\n+#include <pybind11/pybind11.h>\n+#include <pybind11/stl.h>\n+#include <pybind11/stl_bind.h>\n+\n+namespace py = pybind11;\n+\n+using namespace std;\n+using namespace libcamera;\n+\n+static py::object ControlValueToPy(const ControlValue &cv)\n+{\n+\t//assert(!cv.isArray());\n+\t//assert(cv.numElements() == 1);\n+\n+\tswitch (cv.type()) {\n+\tcase ControlTypeBool:\n+\t\treturn py::cast(cv.get<bool>());\n+\tcase ControlTypeByte:\n+\t\treturn py::cast(cv.get<uint8_t>());\n+\tcase ControlTypeInteger32:\n+\t\treturn py::cast(cv.get<int32_t>());\n+\tcase ControlTypeInteger64:\n+\t\treturn py::cast(cv.get<int64_t>());\n+\tcase ControlTypeFloat:\n+\t\treturn py::cast(cv.get<float>());\n+\tcase ControlTypeString:\n+\t\treturn py::cast(cv.get<string>());\n+\tcase ControlTypeRectangle: {\n+\t\tconst Rectangle *v = reinterpret_cast<const Rectangle *>(cv.data().data());\n+\t\treturn py::make_tuple(v->x, v->y, v->width, v->height);\n+\t}\n+\tcase ControlTypeSize: {\n+\t\tconst Size *v = reinterpret_cast<const Size *>(cv.data().data());\n+\t\treturn py::make_tuple(v->width, v->height);\n+\t}\n+\tcase ControlTypeNone:\n+\tdefault:\n+\t\tthrow runtime_error(\"Unsupported ControlValue type\");\n+\t}\n+}\n+\n+static ControlValue PyToControlValue(const py::object &ob, ControlType type)\n+{\n+\tswitch (type) {\n+\tcase ControlTypeBool:\n+\t\treturn ControlValue(ob.cast<bool>());\n+\tcase ControlTypeByte:\n+\t\treturn ControlValue(ob.cast<uint8_t>());\n+\tcase ControlTypeInteger32:\n+\t\treturn ControlValue(ob.cast<int32_t>());\n+\tcase ControlTypeInteger64:\n+\t\treturn ControlValue(ob.cast<int64_t>());\n+\tcase ControlTypeFloat:\n+\t\treturn ControlValue(ob.cast<float>());\n+\tcase ControlTypeString:\n+\t\treturn ControlValue(ob.cast<string>());\n+\tcase ControlTypeRectangle:\n+\tcase ControlTypeSize:\n+\tcase ControlTypeNone:\n+\tdefault:\n+\t\tthrow runtime_error(\"Control type not implemented\");\n+\t}\n+}\n+\n+static weak_ptr<CameraManager> g_camera_manager;\n+static int g_eventfd;\n+static mutex g_reqlist_mutex;\n+static vector<Request *> g_reqlist;\n+\n+static void handle_request_completed(Request *req)\n+{\n+\t{\n+\t\tlock_guard guard(g_reqlist_mutex);\n+\t\tg_reqlist.push_back(req);\n+\t}\n+\n+\tuint64_t v = 1;\n+\twrite(g_eventfd, &v, 8);\n+}\n+\n+PYBIND11_MODULE(pycamera, m)\n+{\n+\tm.def(\"logSetLevel\", &logSetLevel);\n+\n+\tpy::class_<CameraManager, std::shared_ptr<CameraManager>>(m, \"CameraManager\")\n+\t\t.def_static(\"singleton\", []() {\n+\t\t\tshared_ptr<CameraManager> cm = g_camera_manager.lock();\n+\t\t\tif (cm)\n+\t\t\t\treturn cm;\n+\n+\t\t\tint fd = eventfd(0, 0);\n+\t\t\tif (fd == -1)\n+\t\t\t\tthrow std::system_error(errno, std::generic_category(), \"Failed to create eventfd\");\n+\n+\t\t\tcm = shared_ptr<CameraManager>(new CameraManager, [](auto p) {\n+\t\t\t\tclose(g_eventfd);\n+\t\t\t\tg_eventfd = -1;\n+\t\t\t\tdelete p;\n+\t\t\t});\n+\n+\t\t\tg_eventfd = fd;\n+\t\t\tg_camera_manager = cm;\n+\n+\t\t\tint ret = cm->start();\n+\t\t\tif (ret)\n+\t\t\t\tthrow std::system_error(-ret, std::generic_category(), \"Failed to start CameraManager\");\n+\n+\t\t\treturn cm;\n+\t\t})\n+\n+\t\t.def_property_readonly(\"version\", &CameraManager::version)\n+\n+\t\t.def_property_readonly(\"efd\", [](CameraManager &) {\n+\t\t\treturn g_eventfd;\n+\t\t})\n+\n+\t\t.def(\"getReadyRequests\", [](CameraManager &) {\n+\t\t\tvector<Request *> v;\n+\n+\t\t\t{\n+\t\t\t\tlock_guard guard(g_reqlist_mutex);\n+\t\t\t\tswap(v, g_reqlist);\n+\t\t\t}\n+\n+\t\t\tvector<py::object> ret;\n+\n+\t\t\tfor (Request *req : v) {\n+\t\t\t\tpy::object o = py::cast(req);\n+\t\t\t\t// decrease the ref increased in Camera::queueRequest()\n+\t\t\t\to.dec_ref();\n+\t\t\t\tret.push_back(o);\n+\t\t\t}\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def(\"get\", py::overload_cast<const string &>(&CameraManager::get), py::keep_alive<0, 1>())\n+\n+\t\t.def(\"find\", [](CameraManager &self, string str) {\n+\t\t\tstd::transform(str.begin(), str.end(), str.begin(), ::tolower);\n+\n+\t\t\tfor (auto c : self.cameras()) {\n+\t\t\t\tstring id = c->id();\n+\n+\t\t\t\tstd::transform(id.begin(), id.end(), id.begin(), ::tolower);\n+\n+\t\t\t\tif (id.find(str) != string::npos)\n+\t\t\t\t\treturn c;\n+\t\t\t}\n+\n+\t\t\treturn shared_ptr<Camera>();\n+\t\t}, py::keep_alive<0, 1>())\n+\n+\t\t// Create a list of Cameras, where each camera has a keep-alive to CameraManager\n+\t\t.def_property_readonly(\"cameras\", [](CameraManager &self) {\n+\t\t\tpy::list l;\n+\n+\t\t\tfor (auto &c : self.cameras()) {\n+\t\t\t\tpy::object py_cm = py::cast(self);\n+\t\t\t\tpy::object py_cam = py::cast(c);\n+\t\t\t\tpy::detail::keep_alive_impl(py_cam, py_cm);\n+\t\t\t\tl.append(py_cam);\n+\t\t\t}\n+\n+\t\t\treturn l;\n+\t\t});\n+\n+\tpy::class_<Camera, shared_ptr<Camera>>(m, \"Camera\")\n+\t\t.def_property_readonly(\"id\", &Camera::id)\n+\t\t.def(\"acquire\", &Camera::acquire)\n+\t\t.def(\"release\", &Camera::release)\n+\t\t.def(\"start\", [](shared_ptr<Camera> &self) {\n+\t\t\tself->requestCompleted.connect(handle_request_completed);\n+\n+\t\t\tint ret = self->start();\n+\t\t\tif (ret)\n+\t\t\t\tself->requestCompleted.disconnect(handle_request_completed);\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def(\"stop\", [](shared_ptr<Camera> &self) {\n+\t\t\tint ret = self->stop();\n+\t\t\tif (!ret)\n+\t\t\t\tself->requestCompleted.disconnect(handle_request_completed);\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def(\"__repr__\", [](shared_ptr<Camera> &self) {\n+\t\t\treturn \"<pycamera.Camera '\" + self->id() + \"'>\";\n+\t\t})\n+\n+\t\t// Keep the camera alive, as StreamConfiguration contains a Stream*\n+\t\t.def(\"generateConfiguration\", &Camera::generateConfiguration, py::keep_alive<0, 1>())\n+\t\t.def(\"configure\", &Camera::configure)\n+\n+\t\t.def(\"createRequest\", &Camera::createRequest, py::arg(\"cookie\") = 0)\n+\n+\t\t.def(\"queueRequest\", [](Camera &self, Request *req) {\n+\t\t\tpy::object py_req = py::cast(req);\n+\n+\t\t\tpy_req.inc_ref();\n+\n+\t\t\tint ret = self.queueRequest(req);\n+\t\t\tif (ret)\n+\t\t\t\tpy_req.dec_ref();\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def_property_readonly(\"streams\", [](Camera &self) {\n+\t\t\tpy::set set;\n+\t\t\tfor (auto &s : self.streams()) {\n+\t\t\t\tpy::object py_self = py::cast(self);\n+\t\t\t\tpy::object py_s = py::cast(s);\n+\t\t\t\tpy::detail::keep_alive_impl(py_s, py_self);\n+\t\t\t\tset.add(py_s);\n+\t\t\t}\n+\t\t\treturn set;\n+\t\t})\n+\n+\t\t.def_property_readonly(\"controls\", [](Camera &self) {\n+\t\t\tpy::dict ret;\n+\n+\t\t\tfor (const auto &[id, ci] : self.controls()) {\n+\t\t\t\tret[id->name().c_str()] = make_tuple<py::object>(ControlValueToPy(ci.min()),\n+\t\t\t\t\t\t\t\t\t\t ControlValueToPy(ci.max()),\n+\t\t\t\t\t\t\t\t\t\t ControlValueToPy(ci.def()));\n+\t\t\t}\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def_property_readonly(\"properties\", [](Camera &self) {\n+\t\t\tpy::dict ret;\n+\n+\t\t\tfor (const auto &[key, cv] : self.properties()) {\n+\t\t\t\tconst ControlId *id = properties::properties.at(key);\n+\t\t\t\tpy::object ob = ControlValueToPy(cv);\n+\n+\t\t\t\tret[id->name().c_str()] = ob;\n+\t\t\t}\n+\n+\t\t\treturn ret;\n+\t\t});\n+\n+\tpy::enum_<CameraConfiguration::Status>(m, \"ConfigurationStatus\")\n+\t\t.value(\"Valid\", CameraConfiguration::Valid)\n+\t\t.value(\"Adjusted\", CameraConfiguration::Adjusted)\n+\t\t.value(\"Invalid\", CameraConfiguration::Invalid);\n+\n+\tpy::class_<CameraConfiguration>(m, \"CameraConfiguration\")\n+\t\t.def(\"__iter__\", [](CameraConfiguration &self) {\n+\t\t\treturn py::make_iterator<py::return_value_policy::reference_internal>(self);\n+\t\t}, py::keep_alive<0, 1>())\n+\t\t.def(\"__len__\", [](CameraConfiguration &self) {\n+\t\t\treturn self.size();\n+\t\t})\n+\t\t.def(\"validate\", &CameraConfiguration::validate)\n+\t\t.def(\"at\", py::overload_cast<unsigned int>(&CameraConfiguration::at), py::return_value_policy::reference_internal)\n+\t\t.def_property_readonly(\"size\", &CameraConfiguration::size)\n+\t\t.def_property_readonly(\"empty\", &CameraConfiguration::empty);\n+\n+\tpy::class_<StreamConfiguration>(m, \"StreamConfiguration\")\n+\t\t.def(\"toString\", &StreamConfiguration::toString)\n+\t\t.def_property_readonly(\"stream\", &StreamConfiguration::stream, py::return_value_policy::reference_internal)\n+\t\t.def_property(\n+\t\t\t\"size\",\n+\t\t\t[](StreamConfiguration &self) { return make_tuple(self.size.width, self.size.height); },\n+\t\t\t[](StreamConfiguration &self, tuple<uint32_t, uint32_t> size) { self.size.width = get<0>(size); self.size.height = get<1>(size); })\n+\t\t.def_property(\n+\t\t\t\"fmt\",\n+\t\t\t[](StreamConfiguration &self) { return self.pixelFormat.toString(); },\n+\t\t\t[](StreamConfiguration &self, string fmt) { self.pixelFormat = PixelFormat::fromString(fmt); })\n+\t\t.def_readwrite(\"stride\", &StreamConfiguration::stride)\n+\t\t.def_readwrite(\"frameSize\", &StreamConfiguration::frameSize)\n+\t\t.def_readwrite(\"bufferCount\", &StreamConfiguration::bufferCount)\n+\t\t.def_property_readonly(\"formats\", &StreamConfiguration::formats, py::return_value_policy::reference_internal);\n+\t;\n+\n+\tpy::class_<StreamFormats>(m, \"StreamFormats\")\n+\t\t.def_property_readonly(\"pixelFormats\", [](StreamFormats &self) {\n+\t\t\tvector<string> fmts;\n+\t\t\tfor (auto &fmt : self.pixelformats())\n+\t\t\t\tfmts.push_back(fmt.toString());\n+\t\t\treturn fmts;\n+\t\t})\n+\t\t.def(\"sizes\", [](StreamFormats &self, const string &pixelFormat) {\n+\t\t\tauto fmt = PixelFormat::fromString(pixelFormat);\n+\t\t\tvector<tuple<uint32_t, uint32_t>> fmts;\n+\t\t\tfor (const auto &s : self.sizes(fmt))\n+\t\t\t\tfmts.push_back(make_tuple(s.width, s.height));\n+\t\t\treturn fmts;\n+\t\t})\n+\t\t.def(\"range\", [](StreamFormats &self, const string &pixelFormat) {\n+\t\t\tauto fmt = PixelFormat::fromString(pixelFormat);\n+\t\t\tconst auto &range = self.range(fmt);\n+\t\t\treturn make_tuple(make_tuple(range.hStep, range.vStep),\n+\t\t\t\t\t  make_tuple(range.min.width, range.min.height),\n+\t\t\t\t\t  make_tuple(range.max.width, range.max.height));\n+\t\t});\n+\n+\tpy::enum_<StreamRole>(m, \"StreamRole\")\n+\t\t.value(\"StillCapture\", StreamRole::StillCapture)\n+\t\t.value(\"Raw\", StreamRole::Raw)\n+\t\t.value(\"VideoRecording\", StreamRole::VideoRecording)\n+\t\t.value(\"Viewfinder\", StreamRole::Viewfinder);\n+\n+\tpy::class_<FrameBufferAllocator>(m, \"FrameBufferAllocator\")\n+\t\t.def(py::init<shared_ptr<Camera>>(), py::keep_alive<1, 2>())\n+\t\t.def(\"allocate\", &FrameBufferAllocator::allocate)\n+\t\t.def_property_readonly(\"allocated\", &FrameBufferAllocator::allocated)\n+\t\t// Create a list of FrameBuffers, where each FrameBuffer has a keep-alive to FrameBufferAllocator\n+\t\t.def(\"buffers\", [](FrameBufferAllocator &self, Stream *stream) {\n+\t\t\tpy::object py_self = py::cast(self);\n+\t\t\tpy::list l;\n+\t\t\tfor (auto &ub : self.buffers(stream)) {\n+\t\t\t\tpy::object py_buf = py::cast(ub.get(), py::return_value_policy::reference_internal, py_self);\n+\t\t\t\tl.append(py_buf);\n+\t\t\t}\n+\t\t\treturn l;\n+\t\t});\n+\n+\tpy::class_<FrameBuffer>(m, \"FrameBuffer\")\n+\t\t// TODO: implement FrameBuffer::Plane properly\n+\t\t.def(py::init([](vector<tuple<int, unsigned int>> planes, unsigned int cookie) {\n+\t\t\tvector<FrameBuffer::Plane> v;\n+\t\t\tfor (const auto &t : planes)\n+\t\t\t\tv.push_back({ SharedFD(get<0>(t)), FrameBuffer::Plane::kInvalidOffset, get<1>(t) });\n+\t\t\treturn new FrameBuffer(v, cookie);\n+\t\t}))\n+\t\t.def_property_readonly(\"metadata\", &FrameBuffer::metadata, py::return_value_policy::reference_internal)\n+\t\t.def(\"length\", [](FrameBuffer &self, uint32_t idx) {\n+\t\t\tconst FrameBuffer::Plane &plane = self.planes()[idx];\n+\t\t\treturn plane.length;\n+\t\t})\n+\t\t.def(\"fd\", [](FrameBuffer &self, uint32_t idx) {\n+\t\t\tconst FrameBuffer::Plane &plane = self.planes()[idx];\n+\t\t\treturn plane.fd.get();\n+\t\t})\n+\t\t.def_property(\"cookie\", &FrameBuffer::cookie, &FrameBuffer::setCookie);\n+\n+\tpy::class_<Stream>(m, \"Stream\")\n+\t\t.def_property_readonly(\"configuration\", &Stream::configuration);\n+\n+\tpy::enum_<Request::ReuseFlag>(m, \"ReuseFlag\")\n+\t\t.value(\"Default\", Request::ReuseFlag::Default)\n+\t\t.value(\"ReuseBuffers\", Request::ReuseFlag::ReuseBuffers);\n+\n+\tpy::class_<Request>(m, \"Request\")\n+\t\t.def_property_readonly(\"camera\", &Request::camera)\n+\t\t.def(\"addBuffer\", &Request::addBuffer, py::keep_alive<1, 3>()) // Request keeps Framebuffer alive\n+\t\t.def_property_readonly(\"status\", &Request::status)\n+\t\t.def_property_readonly(\"buffers\", &Request::buffers)\n+\t\t.def_property_readonly(\"cookie\", &Request::cookie)\n+\t\t.def_property_readonly(\"hasPendingBuffers\", &Request::hasPendingBuffers)\n+\t\t.def(\"set_control\", [](Request &self, string &control, py::object value) {\n+\t\t\tconst auto &controls = self.camera()->controls();\n+\n+\t\t\tauto it = find_if(controls.begin(), controls.end(),\n+\t\t\t\t\t  [&control](const auto &kvp) { return kvp.first->name() == control; });\n+\n+\t\t\tif (it == controls.end())\n+\t\t\t\tthrow runtime_error(\"Control not found\");\n+\n+\t\t\tconst auto &id = it->first;\n+\n+\t\t\tself.controls().set(id->id(), PyToControlValue(value, id->type()));\n+\t\t})\n+\t\t.def_property_readonly(\"metadata\", [](Request &self) {\n+\t\t\tpy::dict ret;\n+\n+\t\t\tfor (const auto &[key, cv] : self.metadata()) {\n+\t\t\t\tconst ControlId *id = controls::controls.at(key);\n+\t\t\t\tpy::object ob = ControlValueToPy(cv);\n+\n+\t\t\t\tret[id->name().c_str()] = ob;\n+\t\t\t}\n+\n+\t\t\treturn ret;\n+\t\t})\n+\t\t// As we add a keep_alive to the fb in addBuffers(), we can only allow reuse with ReuseBuffers.\n+\t\t.def(\"reuse\", [](Request &self) { self.reuse(Request::ReuseFlag::ReuseBuffers); });\n+\n+\tpy::enum_<Request::Status>(m, \"RequestStatus\")\n+\t\t.value(\"Pending\", Request::RequestPending)\n+\t\t.value(\"Complete\", Request::RequestComplete)\n+\t\t.value(\"Cancelled\", Request::RequestCancelled);\n+\n+\tpy::enum_<FrameMetadata::Status>(m, \"FrameMetadataStatus\")\n+\t\t.value(\"Success\", FrameMetadata::FrameSuccess)\n+\t\t.value(\"Error\", FrameMetadata::FrameError)\n+\t\t.value(\"Cancelled\", FrameMetadata::FrameCancelled);\n+\n+\tpy::class_<FrameMetadata>(m, \"FrameMetadata\")\n+\t\t.def_readonly(\"status\", &FrameMetadata::status)\n+\t\t.def_readonly(\"sequence\", &FrameMetadata::sequence)\n+\t\t.def_readonly(\"timestamp\", &FrameMetadata::timestamp)\n+\t\t.def_property_readonly(\"bytesused\", [](FrameMetadata &self) {\n+\t\t\tvector<unsigned int> v;\n+\t\t\tv.resize(self.planes().size());\n+\t\t\ttransform(self.planes().begin(), self.planes().end(), v.begin(), [](const auto &p) { return p.bytesused; });\n+\t\t\treturn v;\n+\t\t});\n+}\ndiff --git a/subprojects/pybind11.wrap b/subprojects/pybind11.wrap\nnew file mode 100644\nindex 00000000..9d6e7acb\n--- /dev/null\n+++ b/subprojects/pybind11.wrap\n@@ -0,0 +1,12 @@\n+[wrap-file]\n+directory = pybind11-2.6.1\n+source_url = https://github.com/pybind/pybind11/archive/v2.6.1.tar.gz\n+source_filename = pybind11-2.6.1.tar.gz\n+source_hash = cdbe326d357f18b83d10322ba202d69f11b2f49e2d87ade0dc2be0c5c34f8e2a\n+patch_url = https://wrapdb.mesonbuild.com/v2/pybind11_2.6.1-1/get_patch\n+patch_filename = pybind11-2.6.1-1-wrap.zip\n+patch_hash = 6de5477598b56c8a2e609196420c783ac35b79a31d6622121602e6ade6b3cee8\n+\n+[provide]\n+pybind11 = pybind11_dep\n+\n",
    "prefixes": [
        "libcamera-devel",
        "RFC",
        "v3",
        "4/5"
    ]
}