Show a patch.

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

{
    "id": 3791,
    "url": "https://patchwork.libcamera.org/api/patches/3791/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/3791/",
    "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": "<20200513172950.72685-4-email@uajain.com>",
    "date": "2020-05-13T17:29:59",
    "name": "[libcamera-devel,v2,3/5] libcamera: camera_manager: Introduce signals when a camera is added/removed",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": false,
    "hash": "5be2809b484f61f6fc1ed46e69c63aaa29508928",
    "submitter": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/people/1/?format=api",
        "name": "Umang Jain",
        "email": "email@uajain.com"
    },
    "delegate": {
        "id": 12,
        "url": "https://patchwork.libcamera.org/api/users/12/?format=api",
        "username": "uajain",
        "first_name": "Umang",
        "last_name": "Jain",
        "email": "umang.jain@ideasonboard.com"
    },
    "mbox": "https://patchwork.libcamera.org/patch/3791/mbox/",
    "series": [
        {
            "id": 903,
            "url": "https://patchwork.libcamera.org/api/series/903/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=903",
            "date": "2020-05-13T17:29:57",
            "name": "Introduce UVC hotplug support",
            "version": 2,
            "mbox": "https://patchwork.libcamera.org/series/903/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/3791/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/3791/checks/",
    "tags": {},
    "headers": {
        "Return-Path": "<bounces+15657259-5c31-libcamera-devel=lists.libcamera.org@em7280.uajain.com>",
        "Received": [
            "from o1.f.az.sendgrid.net (o1.f.az.sendgrid.net [208.117.55.132])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 264F560DE6\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tWed, 13 May 2020 19:30:00 +0200 (CEST)",
            "by filter0084p3las1.sendgrid.net with SMTP id\n\tfilter0084p3las1-1974-5EBC2E97-A8\n\t2020-05-13 17:29:59.468607979 +0000 UTC m=+2402891.606114937",
            "from mail.uajain.com (unknown)\n\tby ismtpd0007p1hnd1.sendgrid.net (SG) with ESMTP\n\tid Gkgx097gT6GynUsY8W18QQ Wed, 13 May 2020 17:29:59.102 +0000 (UTC)"
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=uajain.com\n\theader.i=@uajain.com header.b=\"V0QaL3Eu\"; \n\tdkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=uajain.com;\n\th=from:subject:in-reply-to:references:mime-version:to:cc:\n\tcontent-transfer-encoding:content-type;\n\ts=s1; bh=myHKDE1Oi/9sT1ZJw6qypPYkAFgznzgR4RInb2p4cBE=;\n\tb=V0QaL3EuQGrTy4g+XtFQWKBmyEhpSnmSPbQYJUtImecxg2p5ppZarjsf5tlsT+hVPp8v\n\tSjLbIYV6vD+LWffgMAfLtXNYSBA7spCUwuq6r07duanpCeSG3WwoxSCuVRMn5Pu6/RUzoN\n\tQA0THz6u/OUaHW+W4al2dak0BMfhZnwLg=",
        "From": "Umang Jain <email@uajain.com>",
        "Date": "Wed, 13 May 2020 17:29:59 +0000 (UTC)",
        "Message-Id": "<20200513172950.72685-4-email@uajain.com>",
        "In-Reply-To": "<20200513172950.72685-1-email@uajain.com>",
        "References": "<20200513172950.72685-1-email@uajain.com>",
        "Mime-Version": "1.0",
        "X-SG-EID": "1Q40EQ7YGir8a9gjSIAdTjhngY657NMk9ckeo4dbHZDiOpywc/L3L9rFqlwE4KPc1PzzgVzhjC45/EOdGbf2jl8Uv6lsWFJUNfuYgvUvwL2Veutc7YVJYIRWH04KiR/RM4E+KTHz/IT2aqxrkQ0NlM+vozLypV2eut18n+1jz+VLxS381CRLFTcE6+TfVG8j+mqjSm/a4yBZY1jyAFNnTXO5gEL7KXEhq7/rk3U30X9bQAD4xRg0LxSdWGAoX71O",
        "To": "libcamera-devel <libcamera-devel@lists.libcamera.org>",
        "Content-Transfer-Encoding": "7bit",
        "Content-Type": "text/plain; charset=us-ascii",
        "Subject": "[libcamera-devel] [PATCH v2 3/5] libcamera: camera_manager:\n\tIntroduce signals when a camera is added/removed",
        "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>",
        "X-List-Received-Date": "Wed, 13 May 2020 17:30:02 -0000"
    },
    "content": "Emit 'cameraAdded' and 'cameraRemoved' from CameraManager to enable\nhotplug and hot-unplug support in appplications like QCam.\n\nSigned-off-by: Umang Jain <email@uajain.com>\n---\n include/libcamera/camera_manager.h |  6 +++++-\n src/libcamera/camera_manager.cpp   | 34 +++++++++++++++++++++++++++---\n src/libcamera/pipeline_handler.cpp |  2 +-\n 3 files changed, 37 insertions(+), 5 deletions(-)",
    "diff": "diff --git a/include/libcamera/camera_manager.h b/include/libcamera/camera_manager.h\nindex 079f848..366fa07 100644\n--- a/include/libcamera/camera_manager.h\n+++ b/include/libcamera/camera_manager.h\n@@ -13,6 +13,7 @@\n #include <vector>\n \n #include <libcamera/object.h>\n+#include <libcamera/signal.h>\n \n namespace libcamera {\n \n@@ -35,13 +36,16 @@ public:\n \tstd::shared_ptr<Camera> get(dev_t devnum);\n \n \tvoid addCamera(std::shared_ptr<Camera> camera, dev_t devnum);\n-\tvoid removeCamera(Camera *camera);\n+\tvoid removeCamera(std::shared_ptr<Camera> camera);\n \n \tstatic const std::string &version() { return version_; }\n \n \tvoid setEventDispatcher(std::unique_ptr<EventDispatcher> dispatcher);\n \tEventDispatcher *eventDispatcher();\n \n+\tSignal<std::shared_ptr<Camera>> cameraAdded;\n+\tSignal<std::shared_ptr<Camera>> cameraRemoved;\n+\n private:\n \tstatic const std::string version_;\n \tstatic CameraManager *self_;\ndiff --git a/src/libcamera/camera_manager.cpp b/src/libcamera/camera_manager.cpp\nindex a13cfe1..b9d2496 100644\n--- a/src/libcamera/camera_manager.cpp\n+++ b/src/libcamera/camera_manager.cpp\n@@ -186,7 +186,7 @@ void CameraManager::Private::addCamera(std::shared_ptr<Camera> &camera,\n \t\t}\n \t}\n \n-\tcameras_.push_back(std::move(camera));\n+\tcameras_.push_back(camera);\n \n \tif (devnum) {\n \t\tunsigned int index = cameras_.size() - 1;\n@@ -376,6 +376,32 @@ std::shared_ptr<Camera> CameraManager::get(dev_t devnum)\n \treturn iter->second.lock();\n }\n \n+/**\n+ * \\brief Notify of a new camera added to the system\n+ *\n+ * This signal is emitted when a new camera is detected and successfully handled\n+ * by the camera manager. The notification occurs alike for cameras detected\n+ * when the manager is started with start() or when new cameras are later\n+ * connected to the system. When the signal is emitted the new camera is already\n+ * available from the list of cameras().\n+ *\n+ * The signal is emitted from the CameraManager thread. Applications shall\n+ * minimize the time spent in the signal handler and shall in particular not\n+ * perform any blocking operation.\n+ */\n+\n+/**\n+ * \\brief Notify of a new camera removed from the system\n+ *\n+ * This signal is emitted when a camera is removed from the system. When the\n+ * signal is emitted the camera is not available from the list of cameras()\n+ * anymore.\n+ *\n+ * The signal is emitted from the CameraManager thread. Applications shall\n+ * minimize the time spent in the signal handler and shall in particular not\n+ * perform any blocking operation.\n+ */\n+\n /**\n  * \\brief Add a camera to the camera manager\n  * \\param[in] camera The camera to be added\n@@ -395,6 +421,7 @@ void CameraManager::addCamera(std::shared_ptr<Camera> camera, dev_t devnum)\n \tASSERT(Thread::current() == p_.get());\n \n \tp_->addCamera(camera, devnum);\n+\tcameraAdded.emit(camera);\n }\n \n /**\n@@ -407,11 +434,12 @@ void CameraManager::addCamera(std::shared_ptr<Camera> camera, dev_t devnum)\n  *\n  * \\context This function shall be called from the CameraManager thread.\n  */\n-void CameraManager::removeCamera(Camera *camera)\n+void CameraManager::removeCamera(std::shared_ptr<Camera> camera)\n {\n \tASSERT(Thread::current() == p_.get());\n \n-\tp_->removeCamera(camera);\n+\tp_->removeCamera(camera.get());\n+\tcameraRemoved.emit(camera);\n }\n \n /**\ndiff --git a/src/libcamera/pipeline_handler.cpp b/src/libcamera/pipeline_handler.cpp\nindex 254d341..a9187e1 100644\n--- a/src/libcamera/pipeline_handler.cpp\n+++ b/src/libcamera/pipeline_handler.cpp\n@@ -555,7 +555,7 @@ void PipelineHandler::disconnect()\n \t\t\tcontinue;\n \n \t\tcamera->disconnect();\n-\t\tmanager_->removeCamera(camera.get());\n+\t\tmanager_->removeCamera(camera);\n \t}\n \n \tcameras_.clear();\n",
    "prefixes": [
        "libcamera-devel",
        "v2",
        "3/5"
    ]
}