Patch Detail
Show a patch.
GET /api/1.1/patches/15787/?format=api
{ "id": 15787, "url": "https://patchwork.libcamera.org/api/1.1/patches/15787/?format=api", "web_url": "https://patchwork.libcamera.org/patch/15787/", "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": "<20220505104104.70841-5-tomi.valkeinen@ideasonboard.com>", "date": "2022-05-05T10:40:55", "name": "[libcamera-devel,v7,04/13] Add Python bindings", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": false, "hash": "2169aa112b14ed8a8d9ff8b42807c0ece135af1c", "submitter": { "id": 109, "url": "https://patchwork.libcamera.org/api/1.1/people/109/?format=api", "name": "Tomi Valkeinen", "email": "tomi.valkeinen@ideasonboard.com" }, "delegate": null, "mbox": "https://patchwork.libcamera.org/patch/15787/mbox/", "series": [ { "id": 3093, "url": "https://patchwork.libcamera.org/api/1.1/series/3093/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=3093", "date": "2022-05-05T10:40:51", "name": "Python bindings", "version": 7, "mbox": "https://patchwork.libcamera.org/series/3093/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/15787/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/15787/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 109D9C0F2A\n\tfor <parsemail@patchwork.libcamera.org>;\n\tThu, 5 May 2022 10:41:34 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 81ED96565D;\n\tThu, 5 May 2022 12:41:30 +0200 (CEST)", "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 5BFA360424\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 5 May 2022 12:41:27 +0200 (CEST)", "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 C1131A50;\n\tThu, 5 May 2022 12:41:26 +0200 (CEST)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1651747290;\n\tbh=yEHy2G907recooxGYC6CB2JBjvpEGkYmPe1aZLsmaWo=;\n\th=To:Date:In-Reply-To:References:Subject:List-Id:List-Unsubscribe:\n\tList-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:\n\tFrom;\n\tb=D9qOnj9VgjPmmX5Y4Db4E4hBmISfDv7uf+ysvb9DdNzvhe+o2PSw78ImsznZ20X33\n\t+cbE8v5L1rWc52b/tKnnOlwSEp/ZkiAwyFbSVF0OSEUscnBbmyNsVFRFOpRr8DF723\n\t7HMmQ7VYcI1r9y0uH8Gnm4dYVF5hVTgJ2CgfkqHW2D2jxdK8xe7+8dm9V3DcF/8GnH\n\t+sKd0HSTfh/HCBVrw+fvbK4XhDg+2MdZM1fgWR/Si5YiKs39C3fNNG2hPVE4DhnhZG\n\trXdBYmAOWyzQgL9mXbQ5Fytsywnt+g1X2+/NljiLrDM08/4kg8qg+isNcbrAssbVbU\n\tQOlBbpM5Bp9vQ==", "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1651747287;\n\tbh=yEHy2G907recooxGYC6CB2JBjvpEGkYmPe1aZLsmaWo=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=Es33la3cWIKobgDMmighOc3nWp+yUdoSv4gHxvLM7JLznMNt8IAnalL1UfzEuEHcX\n\tBfJ8yioVpriRJTiqiI8vHtW/TjZPqjBQN5kvmiN0H6QUSArs4vgxcDvc5ZoG0LE6IY\n\tDYVKXip9n6qDIFGmJbP3G4DfLGGI6zMRipDTaY04=" ], "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"Es33la3c\"; dkim-atps=neutral", "To": "libcamera-devel@lists.libcamera.org,\n\tDavid Plowman <david.plowman@raspberrypi.com>,\n\tKieran Bingham <kieran.bingham@ideasonboard.com>,\n\tLaurent Pinchart <laurent.pinchart@ideasonboard.com>,\n\tJacopo Mondi <jacopo@jmondi.org>", "Date": "Thu, 5 May 2022 13:40:55 +0300", "Message-Id": "<20220505104104.70841-5-tomi.valkeinen@ideasonboard.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20220505104104.70841-1-tomi.valkeinen@ideasonboard.com>", "References": "<20220505104104.70841-1-tomi.valkeinen@ideasonboard.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[libcamera-devel] [PATCH v7 04/13] 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>", "From": "Tomi Valkeinen via libcamera-devel\n\t<libcamera-devel@lists.libcamera.org>", "Reply-To": "Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>", "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\nWe use pybind11 'smart_holder' version to avoid issues with private\ndestructors and shared_ptr. There is also an alternative solution here:\n\nhttps://github.com/pybind/pybind11/pull/2067\n\nOnly a subset of libcamera classes are exposed. Implementing and testing\nthe wrapper classes is challenging, and as such only classes that I have\nneeded have been added so far.\n\nSigned-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\n---\n meson.build | 1 +\n meson_options.txt | 5 +\n src/meson.build | 1 +\n src/py/libcamera/__init__.py | 12 +\n src/py/libcamera/meson.build | 44 ++\n src/py/libcamera/pyenums.cpp | 53 ++\n src/py/libcamera/pymain.cpp | 452 ++++++++++++++++++\n src/py/meson.build | 1 +\n subprojects/.gitignore | 3 +-\n subprojects/packagefiles/pybind11/meson.build | 8 +\n subprojects/pybind11.wrap | 8 +\n 11 files changed, 587 insertions(+), 1 deletion(-)\n create mode 100644 src/py/libcamera/__init__.py\n create mode 100644 src/py/libcamera/meson.build\n create mode 100644 src/py/libcamera/pyenums.cpp\n create mode 100644 src/py/libcamera/pymain.cpp\n create mode 100644 src/py/meson.build\n create mode 100644 subprojects/packagefiles/pybind11/meson.build\n create mode 100644 subprojects/pybind11.wrap", "diff": "diff --git a/meson.build b/meson.build\nindex 0124e7d3..60a911e0 100644\n--- a/meson.build\n+++ b/meson.build\n@@ -177,6 +177,7 @@ summary({\n 'Tracing support': tracing_enabled,\n 'Android support': android_enabled,\n 'GStreamer support': gst_enabled,\n+ 'Python bindings': pycamera_enabled,\n 'V4L2 emulation support': v4l2_enabled,\n 'cam application': cam_enabled,\n 'qcam application': qcam_enabled,\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..34663a6f 100644\n--- a/src/meson.build\n+++ b/src/meson.build\n@@ -37,4 +37,5 @@ subdir('cam')\n subdir('qcam')\n \n subdir('gstreamer')\n+subdir('py')\n subdir('v4l2')\ndiff --git a/src/py/libcamera/__init__.py b/src/py/libcamera/__init__.py\nnew file mode 100644\nindex 00000000..cd7512a2\n--- /dev/null\n+++ b/src/py/libcamera/__init__.py\n@@ -0,0 +1,12 @@\n+# SPDX-License-Identifier: LGPL-2.1-or-later\n+# Copyright (C) 2021, Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\n+\n+from ._libcamera import *\n+import mmap\n+\n+\n+def __FrameBuffer__mmap(self, plane):\n+ return mmap.mmap(self.fd(plane), self.length(plane), mmap.MAP_SHARED, mmap.PROT_READ)\n+\n+\n+FrameBuffer.mmap = __FrameBuffer__mmap\ndiff --git a/src/py/libcamera/meson.build b/src/py/libcamera/meson.build\nnew file mode 100644\nindex 00000000..e1f5cf21\n--- /dev/null\n+++ b/src/py/libcamera/meson.build\n@@ -0,0 +1,44 @@\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+ 'pyenums.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+pycamera_args += ['-DPYBIND11_USE_SMART_HOLDER_AS_DEFAULT']\n+\n+destdir = get_option('libdir') + '/python' + py3_dep.version() + '/site-packages/libcamera'\n+\n+pycamera = shared_module('_libcamera',\n+ pycamera_sources,\n+ install : true,\n+ install_dir : destdir,\n+ name_prefix : '',\n+ dependencies : pycamera_deps,\n+ cpp_args : pycamera_args)\n+\n+run_command('ln', '-fsT', '../../../../src/py/libcamera/__init__.py',\n+ meson.current_build_dir() / '__init__.py',\n+ check: true)\n+\n+install_data(['__init__.py'], install_dir : destdir)\ndiff --git a/src/py/libcamera/pyenums.cpp b/src/py/libcamera/pyenums.cpp\nnew file mode 100644\nindex 00000000..39886656\n--- /dev/null\n+++ b/src/py/libcamera/pyenums.cpp\n@@ -0,0 +1,53 @@\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 <libcamera/libcamera.h>\n+\n+#include <pybind11/smart_holder.h>\n+\n+namespace py = pybind11;\n+\n+using namespace libcamera;\n+\n+void init_pyenums(py::module &m)\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::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::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::enum_<Request::ReuseFlag>(m, \"ReuseFlag\")\n+\t\t.value(\"Default\", Request::ReuseFlag::Default)\n+\t\t.value(\"ReuseBuffers\", Request::ReuseFlag::ReuseBuffers);\n+\n+\tpy::enum_<ControlType>(m, \"ControlType\")\n+\t\t.value(\"None\", ControlType::ControlTypeNone)\n+\t\t.value(\"Bool\", ControlType::ControlTypeBool)\n+\t\t.value(\"Byte\", ControlType::ControlTypeByte)\n+\t\t.value(\"Integer32\", ControlType::ControlTypeInteger32)\n+\t\t.value(\"Integer64\", ControlType::ControlTypeInteger64)\n+\t\t.value(\"Float\", ControlType::ControlTypeFloat)\n+\t\t.value(\"String\", ControlType::ControlTypeString)\n+\t\t.value(\"Rectangle\", ControlType::ControlTypeRectangle)\n+\t\t.value(\"Size\", ControlType::ControlTypeSize);\n+}\ndiff --git a/src/py/libcamera/pymain.cpp b/src/py/libcamera/pymain.cpp\nnew file mode 100644\nindex 00000000..54674caf\n--- /dev/null\n+++ b/src/py/libcamera/pymain.cpp\n@@ -0,0 +1,452 @@\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+/*\n+ * To generate pylibcamera stubs:\n+ * PYTHONPATH=build/src/py pybind11-stubgen --no-setup-py -o build/src/py libcamera\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/smart_holder.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+template<typename T>\n+static py::object ValueOrTuple(const ControlValue &cv)\n+{\n+\tif (cv.isArray()) {\n+\t\tconst T *v = reinterpret_cast<const T *>(cv.data().data());\n+\t\tauto t = py::tuple(cv.numElements());\n+\n+\t\tfor (size_t i = 0; i < cv.numElements(); ++i)\n+\t\t\tt[i] = v[i];\n+\n+\t\treturn t;\n+\t}\n+\n+\treturn py::cast(cv.get<T>());\n+}\n+\n+static py::object ControlValueToPy(const ControlValue &cv)\n+{\n+\tswitch (cv.type()) {\n+\tcase ControlTypeBool:\n+\t\treturn ValueOrTuple<bool>(cv);\n+\tcase ControlTypeByte:\n+\t\treturn ValueOrTuple<uint8_t>(cv);\n+\tcase ControlTypeInteger32:\n+\t\treturn ValueOrTuple<int32_t>(cv);\n+\tcase ControlTypeInteger64:\n+\t\treturn ValueOrTuple<int64_t>(cv);\n+\tcase ControlTypeFloat:\n+\t\treturn ValueOrTuple<float>(cv);\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 handleRequestCompleted(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+void init_pyenums(py::module &m);\n+\n+PYBIND11_MODULE(_libcamera, m)\n+{\n+\tinit_pyenums(m);\n+\n+\t/* Forward declarations */\n+\n+\t/*\n+\t * We need to declare all the classes here so that Python docstrings\n+\t * can be generated correctly.\n+\t * https://pybind11.readthedocs.io/en/latest/advanced/misc.html#avoiding-c-types-in-docstrings\n+\t */\n+\n+\tauto pyCameraManager = py::class_<CameraManager>(m, \"CameraManager\");\n+\tauto pyCamera = py::class_<Camera>(m, \"Camera\");\n+\tauto pyCameraConfiguration = py::class_<CameraConfiguration>(m, \"CameraConfiguration\");\n+\tauto pyStreamConfiguration = py::class_<StreamConfiguration>(m, \"StreamConfiguration\");\n+\tauto pyStreamFormats = py::class_<StreamFormats>(m, \"StreamFormats\");\n+\tauto pyFrameBufferAllocator = py::class_<FrameBufferAllocator>(m, \"FrameBufferAllocator\");\n+\tauto pyFrameBuffer = py::class_<FrameBuffer>(m, \"FrameBuffer\");\n+\tauto pyStream = py::class_<Stream>(m, \"Stream\");\n+\tauto pyControlId = py::class_<ControlId>(m, \"ControlId\");\n+\tauto pyRequest = py::class_<Request>(m, \"Request\");\n+\tauto pyFrameMetadata = py::class_<FrameMetadata>(m, \"FrameMetadata\");\n+\n+\t/* Global functions */\n+\tm.def(\"logSetLevel\", &logSetLevel);\n+\n+\t/* Classes */\n+\tpyCameraManager\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+\tpyCamera\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\", [](Camera &self) {\n+\t\t\tself.requestCompleted.connect(handleRequestCompleted);\n+\n+\t\t\tint ret = self.start();\n+\t\t\tif (ret)\n+\t\t\t\tself.requestCompleted.disconnect(handleRequestCompleted);\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def(\"stop\", [](Camera &self) {\n+\t\t\tint ret = self.stop();\n+\t\t\tif (!ret)\n+\t\t\t\tself.requestCompleted.disconnect(handleRequestCompleted);\n+\n+\t\t\treturn ret;\n+\t\t})\n+\n+\t\t.def(\"__repr__\", [](Camera &self) {\n+\t\t\treturn \"<libcamera.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(\"find_control\", [](Camera &self, const string &name) {\n+\t\t\tconst auto &controls = self.controls();\n+\n+\t\t\tauto it = find_if(controls.begin(), controls.end(),\n+\t\t\t\t\t [&name](const auto &kvp) { return kvp.first->name() == name; });\n+\n+\t\t\tif (it == controls.end())\n+\t\t\t\tthrow runtime_error(\"Control not found\");\n+\n+\t\t\treturn it->first;\n+\t\t}, py::return_value_policy::reference_internal)\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+\tpyCameraConfiguration\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+\tpyStreamConfiguration\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\"pixelFormat\",\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+\n+\tpyStreamFormats\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+\tpyFrameBufferAllocator\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+\tpyFrameBuffer\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+\tpyStream\n+\t\t.def_property_readonly(\"configuration\", &Stream::configuration);\n+\n+\tpyControlId\n+\t\t.def_property_readonly(\"id\", &ControlId::id)\n+\t\t.def_property_readonly(\"name\", &ControlId::name)\n+\t\t.def_property_readonly(\"type\", &ControlId::type);\n+\n+\tpyRequest\n+\t\t/* Fence is not supported, so we cannot expose addBuffer() directly */\n+\t\t.def(\"addBuffer\", [](Request &self, const Stream *stream, FrameBuffer *buffer) {\n+\t\t\treturn self.addBuffer(stream, buffer);\n+\t\t}, 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, ControlId &id, py::object value) {\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+\tpyFrameMetadata\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/* temporary helper, to be removed */\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/src/py/meson.build b/src/py/meson.build\nnew file mode 100644\nindex 00000000..4ce9668c\n--- /dev/null\n+++ b/src/py/meson.build\n@@ -0,0 +1 @@\n+subdir('libcamera')\ndiff --git a/subprojects/.gitignore b/subprojects/.gitignore\nindex 391fde2c..0e194289 100644\n--- a/subprojects/.gitignore\n+++ b/subprojects/.gitignore\n@@ -1,3 +1,4 @@\n /googletest-release*\n /libyuv\n-/packagecache\n\\ No newline at end of file\n+/packagecache\n+/pybind11\ndiff --git a/subprojects/packagefiles/pybind11/meson.build b/subprojects/packagefiles/pybind11/meson.build\nnew file mode 100644\nindex 00000000..67e89aec\n--- /dev/null\n+++ b/subprojects/packagefiles/pybind11/meson.build\n@@ -0,0 +1,8 @@\n+project('pybind11', 'cpp',\n+ version : '2.9.1',\n+ license : 'BSD-3-Clause')\n+\n+pybind11_incdir = include_directories('include')\n+\n+pybind11_dep = declare_dependency(\n+ include_directories : pybind11_incdir)\ndiff --git a/subprojects/pybind11.wrap b/subprojects/pybind11.wrap\nnew file mode 100644\nindex 00000000..2413e9ca\n--- /dev/null\n+++ b/subprojects/pybind11.wrap\n@@ -0,0 +1,8 @@\n+[wrap-git]\n+url = https://github.com/pybind/pybind11.git\n+revision = 82734801f23314b4c34d70a79509e060a2648e04\n+depth = 1\n+patch_directory = pybind11\n+\n+[provide]\n+pybind11 = pybind11_dep\n", "prefixes": [ "libcamera-devel", "v7", "04/13" ] }