Patch Detail
Show a patch.
GET /api/patches/16084/?format=api
{ "id": 16084, "url": "https://patchwork.libcamera.org/api/patches/16084/?format=api", "web_url": "https://patchwork.libcamera.org/patch/16084/", "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": "<20220527144447.94891-14-tomi.valkeinen@ideasonboard.com>", "date": "2022-05-27T14:44:30", "name": "[libcamera-devel,v3,13/30] py: Re-structure the controls API", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": false, "hash": "2935f2f2cd24214c3e049932a1d6787d2f130d2b", "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/16084/mbox/", "series": [ { "id": 3146, "url": "https://patchwork.libcamera.org/api/series/3146/?format=api", "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=3146", "date": "2022-05-27T14:44:17", "name": "More misc Python patches", "version": 3, "mbox": "https://patchwork.libcamera.org/series/3146/mbox/" } ], "comments": "https://patchwork.libcamera.org/api/patches/16084/comments/", "check": "pending", "checks": "https://patchwork.libcamera.org/api/patches/16084/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 B30CDC3256\n\tfor <parsemail@patchwork.libcamera.org>;\n\tFri, 27 May 2022 14:45:25 +0000 (UTC)", "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 4EBA165697;\n\tFri, 27 May 2022 16:45:25 +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 410E865644\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tFri, 27 May 2022 16:45:11 +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 AA0B81440;\n\tFri, 27 May 2022 16:45:10 +0200 (CEST)" ], "DKIM-Signature": [ "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1653662725;\n\tbh=KjPMCtIKmKLBPOuGyREMU890hdHrQ1ucqHg7xWG38eo=;\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=m4x8yLKb0TNSfQwx8e0qIOWgX+4BaktUO7LvB+QPfhy5a4Rrq5Q6xsruPlq4w/w8B\n\tLRjwXU/8HToef2L/OkrMau8lf+R1J5OppQYBH6U8OFEfq2FxAzvGHvQIKhWJZwrVJm\n\t5xAYrMG1RYZ1UzEFeeFyyiq3tM28Ni3fcqwiBLkmBdNP/dfYcOlP2bWpxT5KaVA6F5\n\tJqGzTUrlViTiWIzJ6+kK7vXnipurjfANCulN2nEsMjKIm+vfc1SNC1YIKW41Jn3Nx7\n\tXXyYqucMkwpkPPRHBky/FMbgKjkKebLUXHtkiF+GQPcFt1QrVKoTFr16hICgvQ2PP+\n\tkFhZrfdxP2uhA==", "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1653662711;\n\tbh=KjPMCtIKmKLBPOuGyREMU890hdHrQ1ucqHg7xWG38eo=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=tE2Xh/B88ZhbKPJypIhMcEM2UCgdg4RAeHo243iQYH7gITNuehi9P3+ilqdHo3gU/\n\tC0Tf6Dery1F2T/EoYMA1z6oB2kVKZEH6STMb2rBtSMUP/9L2h3QoP+Fu6mXJ8dqKcn\n\tZqK2NU8XwjFCrrmq+YoMiyXR8beCXKlGrkWXyEBo=" ], "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"tE2Xh/B8\"; 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": "Fri, 27 May 2022 17:44:30 +0300", "Message-Id": "<20220527144447.94891-14-tomi.valkeinen@ideasonboard.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20220527144447.94891-1-tomi.valkeinen@ideasonboard.com>", "References": "<20220527144447.94891-1-tomi.valkeinen@ideasonboard.com>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "Subject": "[libcamera-devel] [PATCH v3 13/30] py: Re-structure the controls API", "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 ControlInfo class and change the controls related methods to\nresemble the C++ API (e.g. no more string based control methods).\n\nWe don't implement ControlList or ControlInfoMap but just expose the\nsame data via standard Python dict.\n\nSigned-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\nReviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>\n---\n src/py/cam/cam.py | 8 +--\n src/py/cam/cam_qt.py | 9 +--\n src/py/libcamera/py_main.cpp | 104 +++++++++++++++++------------------\n 3 files changed, 61 insertions(+), 60 deletions(-)", "diff": "diff --git a/src/py/cam/cam.py b/src/py/cam/cam.py\nindex c8ffb084..677dd680 100755\n--- a/src/py/cam/cam.py\n+++ b/src/py/cam/cam.py\n@@ -46,14 +46,14 @@ class CameraContext:\n def do_cmd_list_props(self):\n print('Properties for', self.id)\n \n- for name, prop in self.camera.properties.items():\n- print('\\t{}: {}'.format(name, prop))\n+ for cid, val in self.camera.properties.items():\n+ print('\\t{}: {}'.format(cid, val))\n \n def do_cmd_list_controls(self):\n print('Controls for', self.id)\n \n- for name, prop in self.camera.controls.items():\n- print('\\t{}: {}'.format(name, prop))\n+ for cid, info in self.camera.controls.items():\n+ print('\\t{}: {}'.format(cid, info))\n \n def do_cmd_info(self):\n print('Stream info for', self.id)\ndiff --git a/src/py/cam/cam_qt.py b/src/py/cam/cam_qt.py\nindex d638e9cc..e2395c4b 100644\n--- a/src/py/cam/cam_qt.py\n+++ b/src/py/cam/cam_qt.py\n@@ -267,9 +267,9 @@ class MainWindow(QtWidgets.QWidget):\n \n camera = ctx.camera\n \n- for k, v in camera.properties.items():\n+ for cid, cv in camera.properties.items():\n lab = QtWidgets.QLabel()\n- lab.setText(k + ' = ' + str(v))\n+ lab.setText('{} = {}'.format(cid, cv))\n groupLayout.addWidget(lab)\n \n group = QtWidgets.QGroupBox('Controls')\n@@ -277,9 +277,10 @@ class MainWindow(QtWidgets.QWidget):\n group.setLayout(groupLayout)\n controlsLayout.addWidget(group)\n \n- for k, (min, max, default) in camera.controls.items():\n+ for cid, cinfo in camera.controls.items():\n lab = QtWidgets.QLabel()\n- lab.setText('{} = {}/{}/{}'.format(k, min, max, default))\n+ lab.setText('{} = {}/{}/{}'\n+ .format(cid, cinfo.min, cinfo.max, cinfo.default))\n groupLayout.addWidget(lab)\n \n controlsLayout.addStretch()\ndiff --git a/src/py/libcamera/py_main.cpp b/src/py/libcamera/py_main.cpp\nindex 33ecc1cd..4fb66866 100644\n--- a/src/py/libcamera/py_main.cpp\n+++ b/src/py/libcamera/py_main.cpp\n@@ -5,10 +5,6 @@\n * Python bindings\n */\n \n-/*\n- * \\todo Add bindings for the ControlInfo class\n- */\n-\n #include <mutex>\n #include <stdexcept>\n #include <sys/eventfd.h>\n@@ -159,6 +155,7 @@ PYBIND11_MODULE(_libcamera, m)\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 pyControlInfo = py::class_<ControlInfo>(m, \"ControlInfo\");\n \tauto pyRequest = py::class_<Request>(m, \"Request\");\n \tauto pyRequestStatus = py::enum_<Request::Status>(pyRequest, \"Status\");\n \tauto pyRequestReuse = py::enum_<Request::ReuseFlag>(pyRequest, \"Reuse\");\n@@ -260,28 +257,17 @@ PYBIND11_MODULE(_libcamera, m)\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, py::dict controls) {\n+\t\t.def(\"start\", [](Camera &self,\n+\t\t const std::unordered_map<const ControlId *, py::object> &controls) {\n \t\t\t/* \\todo What happens if someone calls start() multiple times? */\n \n \t\t\tself.requestCompleted.connect(handleRequestCompleted);\n \n-\t\t\tconst ControlInfoMap &controlMap = self.controls();\n-\t\t\tControlList controlList(controlMap);\n-\t\t\tfor (const auto& [hkey, hval]: controls) {\n-\t\t\t\tauto key = hkey.cast<std::string>();\n-\n-\t\t\t\tauto it = std::find_if(controlMap.begin(), controlMap.end(),\n-\t\t\t\t\t\t [&key](const auto &kvp) {\n-\t\t\t\t\t\t\t\treturn kvp.first->name() == key;\n-\t\t\t\t\t\t });\n+\t\t\tControlList controlList(self.controls());\n \n-\t\t\t\tif (it == controlMap.end())\n-\t\t\t\t\tthrow std::runtime_error(\"Control \" + key + \" not found\");\n-\n-\t\t\t\tconst auto &id = it->first;\n-\t\t\t\tauto obj = py::cast<py::object>(hval);\n-\n-\t\t\t\tcontrolList.set(id->id(), pyToControlValue(obj, id->type()));\n+\t\t\tfor (const auto& [id, obj]: controls) {\n+\t\t\t\tauto val = pyToControlValue(obj, id->type());\n+\t\t\t\tcontrolList.set(id->id(), val);\n \t\t\t}\n \n \t\t\tint ret = self.start(&controlList);\n@@ -291,7 +277,7 @@ PYBIND11_MODULE(_libcamera, m)\n \t\t\t}\n \n \t\t\treturn 0;\n-\t\t}, py::arg(\"controls\") = py::dict())\n+\t\t}, py::arg(\"controls\") = std::unordered_map<const ControlId *, py::object>())\n \n \t\t.def(\"stop\", [](Camera &self) {\n \t\t\tint ret = self.stop();\n@@ -341,40 +327,26 @@ PYBIND11_MODULE(_libcamera, m)\n \t\t\treturn set;\n \t\t})\n \n-\t\t.def(\"find_control\", [](Camera &self, const std::string &name) {\n-\t\t\tconst auto &controls = self.controls();\n-\n-\t\t\tauto it = std::find_if(controls.begin(), controls.end(),\n-\t\t\t\t\t [&name](const auto &kvp) {\n-\t\t\t\t\t\t\treturn kvp.first->name() == name;\n-\t\t\t\t\t });\n-\n-\t\t\tif (it == controls.end())\n-\t\t\t\tthrow std::runtime_error(\"Control '\" + name + \"' 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+\t\t\t/* Convert ControlInfoMap to std container */\n \n-\t\t\tfor (const auto &[id, ci] : self.controls()) {\n-\t\t\t\tret[id->name().c_str()] = std::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+\t\t\tstd::unordered_map<const ControlId *, ControlInfo> ret;\n+\n+\t\t\tfor (const auto &[k, cv] : self.controls())\n+\t\t\t\tret[k] = cv;\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+\t\t\t/* Convert ControlList to std container */\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+\t\t\tstd::unordered_map<const ControlId *, py::object> ret;\n \n-\t\t\t\tret[id->name().c_str()] = ob;\n+\t\t\tfor (const auto &[k, cv] : self.properties()) {\n+\t\t\t\tconst ControlId *id = properties::properties.at(k);\n+\t\t\t\tpy::object ob = controlValueToPy(cv);\n+\t\t\t\tret[id] = ob;\n \t\t\t}\n \n \t\t\treturn ret;\n@@ -464,7 +436,34 @@ PYBIND11_MODULE(_libcamera, m)\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+\t\t.def_property_readonly(\"type\", &ControlId::type)\n+\t\t.def(\"__str__\", [](const ControlId &self) { return self.name(); })\n+\t\t.def(\"__repr__\", [](const ControlId &self) {\n+\t\t\treturn py::str(\"libcamera.ControlId({}, {}, {})\")\n+\t\t\t\t.format(self.id(), self.name(), self.type());\n+\t\t});\n+\n+\tpyControlInfo\n+\t\t.def_property_readonly(\"min\", [](const ControlInfo &self) {\n+\t\t\treturn controlValueToPy(self.min());\n+\t\t})\n+\t\t.def_property_readonly(\"max\", [](const ControlInfo &self) {\n+\t\t\treturn controlValueToPy(self.max());\n+\t\t})\n+\t\t.def_property_readonly(\"default\", [](const ControlInfo &self) {\n+\t\t\treturn controlValueToPy(self.def());\n+\t\t})\n+\t\t.def_property_readonly(\"values\", [](const ControlInfo &self) {\n+\t\t\tpy::list l;\n+\t\t\tfor (const auto &v : self.values())\n+\t\t\t\tl.append(controlValueToPy(v));\n+\t\t\treturn l;\n+\t\t})\n+\t\t.def(\"__str__\", &ControlInfo::toString)\n+\t\t.def(\"__repr__\", [](const ControlInfo &self) {\n+\t\t\treturn py::str(\"libcamera.ControlInfo({})\")\n+\t\t\t\t.format(self.toString());\n+\t\t});\n \n \tpyRequest\n \t\t/* \\todo Fence is not supported, so we cannot expose addBuffer() directly */\n@@ -475,17 +474,18 @@ PYBIND11_MODULE(_libcamera, m)\n \t\t.def_property_readonly(\"buffers\", &Request::buffers)\n \t\t.def_property_readonly(\"cookie\", &Request::cookie)\n \t\t.def_property_readonly(\"has_pending_buffers\", &Request::hasPendingBuffers)\n-\t\t.def(\"set_control\", [](Request &self, ControlId &id, py::object value) {\n+\t\t.def(\"set_control\", [](Request &self, const 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+\t\t\t/* Convert ControlList to std container */\n+\n+\t\t\tstd::unordered_map<const ControlId *, py::object> 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\tret[id] = ob;\n \t\t\t}\n \n \t\t\treturn ret;\n", "prefixes": [ "libcamera-devel", "v3", "13/30" ] }