{"id":16017,"url":"https://patchwork.libcamera.org/api/1.1/patches/16017/?format=json","web_url":"https://patchwork.libcamera.org/patch/16017/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/1.1/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20220524114610.41848-13-tomi.valkeinen@ideasonboard.com>","date":"2022-05-24T11:46:03","name":"[libcamera-devel,v2,12/19] py: examples: Add itest.py","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"53df1ef72bd013b56cfae49d8847e08fe5c32514","submitter":{"id":109,"url":"https://patchwork.libcamera.org/api/1.1/people/109/?format=json","name":"Tomi Valkeinen","email":"tomi.valkeinen@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/16017/mbox/","series":[{"id":3134,"url":"https://patchwork.libcamera.org/api/1.1/series/3134/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=3134","date":"2022-05-24T11:45:51","name":"More misc Python patches","version":2,"mbox":"https://patchwork.libcamera.org/series/3134/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/16017/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/16017/checks/","tags":{},"headers":{"Return-Path":"","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 5B1E7C3272\n\tfor ;\n\tTue, 24 May 2022 11:46:51 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 9F85665672;\n\tTue, 24 May 2022 13:46:50 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 490DD65668\n\tfor ;\n\tTue, 24 May 2022 13:46:36 +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 B30194A8;\n\tTue, 24 May 2022 13:46:35 +0200 (CEST)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1653392810;\n\tbh=Ois2QOxtdbz47T73qANKv+lKornBN8Dys4/BCUT8ft4=;\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=tIv3sbjTducq2J7WNTJrvX/d4lSMTdCEEp7Dvj5lzyx+/hmfNOPT6P0pYkTVX0OyO\n\tsjW7SvcelJrDYWa0O8NAUeTjwbTMWSHbGX5qV9ScxnEfRN9UnO829P+sP+273KD+K2\n\t/Pryyza6FYSo4KbkELlGM6hkZxx8KOJHBvXB8920gmW/W6flEMkThoanNaqeFkYqTy\n\tG9YAQnjJ6FnoSC6VZGl63FFWaB3AdoTSavSOqhOJ7S6dpaw3kMxmCOw3fiPM8YIFkz\n\tWX57LIZnctEcUrW2IdeC2dHBWI6B01PaYhDjVH7NXQ53kMbg9bBGdWMpm67jm/mnq2\n\tLmJWfNuNu78Pg==","v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1653392796;\n\tbh=Ois2QOxtdbz47T73qANKv+lKornBN8Dys4/BCUT8ft4=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=G8Q1EeBL134x/LAEQq+6wnbmuoMAOl7zFcvZ8EIieyXHdmTBwQgQdrUekiNAdyYWy\n\tHe8vRcH5AqLc0GjXzZsIudxes5kp19n3v7mdhx/252ZLY/tBuIaBxHma8K4icSgF0T\n\t4iGVmC4wfDZ/tXamYS3LDHA6/yLUehnV27Dtqx2s="],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"G8Q1EeBL\"; dkim-atps=neutral","To":"libcamera-devel@lists.libcamera.org,\n\tDavid Plowman ,\n\tKieran Bingham ,\n\tLaurent Pinchart ,\n\tJacopo Mondi ","Date":"Tue, 24 May 2022 14:46:03 +0300","Message-Id":"<20220524114610.41848-13-tomi.valkeinen@ideasonboard.com>","X-Mailer":"git-send-email 2.34.1","In-Reply-To":"<20220524114610.41848-1-tomi.valkeinen@ideasonboard.com>","References":"<20220524114610.41848-1-tomi.valkeinen@ideasonboard.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH v2 12/19] py: examples: Add itest.py","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","From":"Tomi Valkeinen via libcamera-devel\n\t","Reply-To":"Tomi Valkeinen ","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"Add a small tool which gives the user an IPython based interactive shell\nwith libcamera capturing in the background. Can be used to study and\ntest small things with libcamera.\n\nSigned-off-by: Tomi Valkeinen \n---\n src/py/examples/itest.py | 197 +++++++++++++++++++++++++++++++++++++++\n 1 file changed, 197 insertions(+)\n create mode 100755 src/py/examples/itest.py","diff":"diff --git a/src/py/examples/itest.py b/src/py/examples/itest.py\nnew file mode 100755\nindex 00000000..01e020e2\n--- /dev/null\n+++ b/src/py/examples/itest.py\n@@ -0,0 +1,197 @@\n+#!/usr/bin/env python3\n+\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright (C) 2022, Tomi Valkeinen \n+\n+# This sets up a single camera, starts a capture loop in a background thread,\n+# and starts an IPython shell which can be used to study and test libcamera.\n+#\n+# Note: This is not an example as such, but more of a developer tool to try\n+# out things.\n+\n+import argparse\n+import IPython\n+import libcamera as libcam\n+import selectors\n+import sys\n+import threading\n+\n+\n+def handle_camera_event(ctx):\n+ cm = ctx['cm']\n+ cam = ctx['cam']\n+\n+ # cm.read_event() will not block here, as we know there is an event to read.\n+ # We have to read the event to clear it.\n+\n+ cm.read_event()\n+\n+ reqs = cm.get_ready_requests()\n+\n+ assert len(reqs) > 0\n+\n+ # Process the captured frames\n+\n+ for req in reqs:\n+ buffers = req.buffers\n+\n+ assert len(buffers) == 1\n+\n+ # We want to re-queue the buffer we just handled. Instead of creating\n+ # a new Request, we re-use the old one. We need to call req.reuse()\n+ # to re-initialize the Request before queuing.\n+\n+ req.reuse()\n+ cam.queue_request(req)\n+\n+ scope = ctx['scope']\n+\n+ if 'num_frames' not in scope:\n+ scope['num_frames'] = 0\n+\n+ scope['num_frames'] += 1\n+\n+\n+def capture(ctx):\n+ cm = ctx['cm']\n+ cam = ctx['cam']\n+ reqs = ctx['reqs']\n+\n+ # Queue the requests to the camera\n+\n+ for req in reqs:\n+ ret = cam.queue_request(req)\n+ assert ret == 0\n+\n+ # Use Selector to wait for events from the camera and from the keyboard\n+\n+ sel = selectors.DefaultSelector()\n+ sel.register(cm.efd, selectors.EVENT_READ, lambda fd: handle_camera_event(ctx))\n+\n+ reqs = []\n+\n+ while ctx['running']:\n+ events = sel.select()\n+ for key, mask in events:\n+ key.data(key.fileobj)\n+\n+\n+def main():\n+ parser = argparse.ArgumentParser()\n+ parser.add_argument('-c', '--camera', type=str, default='1',\n+ help='Camera index number (starting from 1) or part of the name')\n+ parser.add_argument('-f', '--format', type=str, help='Pixel format')\n+ parser.add_argument('-s', '--size', type=str, help='Size (\"WxH\")')\n+ args = parser.parse_args()\n+\n+ cm = libcam.CameraManager.singleton()\n+\n+ try:\n+ if args.camera.isnumeric():\n+ cam_idx = int(args.camera)\n+ cam = next((cam for i, cam in enumerate(cm.cameras) if i + 1 == cam_idx))\n+ else:\n+ cam = next((cam for cam in cm.cameras if args.camera in cam.id))\n+ except Exception:\n+ print(f'Failed to find camera \"{args.camera}\"')\n+ return -1\n+\n+ # Acquire the camera for our use\n+\n+ ret = cam.acquire()\n+ assert ret == 0\n+\n+ # Configure the camera\n+\n+ camconfig = cam.generate_configuration([libcam.StreamRole.StillCapture])\n+\n+ streamconfig = camconfig.at(0)\n+\n+ if args.format:\n+ fmt = libcam.PixelFormat(args.format)\n+ streamconfig.pixel_format = fmt\n+\n+ if args.size:\n+ w, h = [int(v) for v in args.size.split('x')]\n+ streamconfig.size = libcam.Size(w, h)\n+\n+ ret = cam.configure(camconfig)\n+ assert ret == 0\n+\n+ stream = streamconfig.stream\n+\n+ # Allocate the buffers for capture\n+\n+ allocator = libcam.FrameBufferAllocator(cam)\n+ ret = allocator.allocate(stream)\n+ assert ret > 0\n+\n+ num_bufs = len(allocator.buffers(stream))\n+\n+ print(f'Capturing {streamconfig} with {num_bufs} buffers from {cam.id}')\n+\n+ # Create the requests and assign a buffer for each request\n+\n+ reqs = []\n+ for i in range(num_bufs):\n+ # Use the buffer index as the \"cookie\"\n+ req = cam.create_request(i)\n+\n+ buffer = allocator.buffers(stream)[i]\n+ ret = req.add_buffer(stream, buffer)\n+ assert ret == 0\n+\n+ reqs.append(req)\n+\n+ # Start the camera\n+\n+ ret = cam.start()\n+ assert ret == 0\n+\n+ # Create a scope for the IPython shell\n+ scope = {\n+ 'cm': cm,\n+ 'cam': cam,\n+ 'libcam': libcam,\n+ }\n+\n+ # Create a simple context shared between the background thread and the main\n+ # thread.\n+ ctx = {\n+ 'running': True,\n+ 'cm': cm,\n+ 'cam': cam,\n+ 'reqs': reqs,\n+ 'scope': scope,\n+ }\n+\n+ # Note that \"In CPython, due to the Global Interpreter Lock, only one thread\n+ # can execute Python code at once\". We rely on that here, which is not very\n+ # nice. I am sure an fd-based polling loop could be integrated with IPython,\n+ # somehow, which would allow us to drop the threading.\n+\n+ t = threading.Thread(target=capture, args=(ctx,))\n+ t.start()\n+\n+ IPython.embed(banner1=\"\", exit_msg=\"\", confirm_exit=False, user_ns=scope)\n+\n+ print(\"Exiting...\")\n+\n+ ctx[\"running\"] = False\n+ t.join()\n+\n+ # Stop the camera\n+\n+ ret = cam.stop()\n+ assert ret == 0\n+\n+ # Release the camera\n+\n+ ret = cam.release()\n+ assert ret == 0\n+\n+ return 0\n+\n+\n+if __name__ == '__main__':\n+ sys.exit(main())\n","prefixes":["libcamera-devel","v2","12/19"]}