{"id":16098,"url":"https://patchwork.libcamera.org/api/patches/16098/?format=json","web_url":"https://patchwork.libcamera.org/patch/16098/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/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":"<20220527144447.94891-28-tomi.valkeinen@ideasonboard.com>","date":"2022-05-27T14:44:44","name":"[libcamera-devel,v3,27/30] py: examples: Add simple-capture.py","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"fbc7b266bbb9bf4c6950cfe958be9c7a587dbdc9","submitter":{"id":109,"url":"https://patchwork.libcamera.org/api/people/109/?format=json","name":"Tomi Valkeinen","email":"tomi.valkeinen@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/16098/mbox/","series":[{"id":3146,"url":"https://patchwork.libcamera.org/api/series/3146/?format=json","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/16098/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/16098/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 1A3A2C3271\n\tfor ;\n\tFri, 27 May 2022 14:45:41 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 863A7656A5;\n\tFri, 27 May 2022 16:45:40 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 79C8B65648\n\tfor ;\n\tFri, 27 May 2022 16:45:18 +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 DF5C74D18;\n\tFri, 27 May 2022 16:45:17 +0200 (CEST)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1653662740;\n\tbh=QUnYvFxz4Ygo344WFDS1YECj2E5+A8bUHAIf/hS7j6o=;\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=DQvr4xJ/Vq7TusWU4aiv5cQrjMO2JjIzQtNxWXOXy5jg0iDx2vWZzfG5COSs3Y+g0\n\tu2qFwkIef5SjT5WWaJ8S/2Ieo5xbMB9O8e25U+vQnHSFQy8iMO+1agK8xw8pRYUlRJ\n\t6Zey2XS2YxlHb0xu7v8QoSvhMYxCYZJQpp4+28bGWCl76/0YRnkVKtquDYBtj0mS0q\n\tf2NIrCaKAgxftcS+yMLFklUWWP48afiAK/yBhk5e6TOzktUKyTnjo9CBTFgFxmeRvx\n\tU7GQ6pLWArMsFtmt/F5VcNFsNXLOe4II+3KsklZvrAdwM2BgZptfcUfvGbtO46u0fH\n\tTiQf4MBdMOruQ==","v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1653662718;\n\tbh=QUnYvFxz4Ygo344WFDS1YECj2E5+A8bUHAIf/hS7j6o=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=TEtV9mo/tW0vAXvy0raevSM68gfHE57m0DpWtz6JfsN1edSuzeAXXjFCUrlHmqUyb\n\tvlxsB4or4YvK/a2JeSgAGmrFz4MVBX2420m3FKO/p74k7zDTUqbS1rCXW+Xm3XBv8R\n\tymb8Ptz+c/zQggzMRPEt/eGznNS8e1Soy4+OeOH0="],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"TEtV9mo/\"; dkim-atps=neutral","To":"libcamera-devel@lists.libcamera.org,\n\tDavid Plowman ,\n\tKieran Bingham ,\n\tLaurent Pinchart ,\n\tJacopo Mondi ","Date":"Fri, 27 May 2022 17:44:44 +0300","Message-Id":"<20220527144447.94891-28-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 27/30] py: examples: Add\n\tsimple-capture.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 an example to showcase the more-or-less minimal capture case.\n\nSigned-off-by: Tomi Valkeinen \n---\n src/py/examples/simple-capture.py | 159 ++++++++++++++++++++++++++++++\n 1 file changed, 159 insertions(+)\n create mode 100755 src/py/examples/simple-capture.py","diff":"diff --git a/src/py/examples/simple-capture.py b/src/py/examples/simple-capture.py\nnew file mode 100755\nindex 00000000..4b0c3f0c\n--- /dev/null\n+++ b/src/py/examples/simple-capture.py\n@@ -0,0 +1,159 @@\n+#!/usr/bin/env python3\n+\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright (C) 2022, Tomi Valkeinen \n+\n+# A simple minimal capture example showing:\n+# - How to setup the camera\n+# - Capture frames in a blocking manner\n+# - Memory map the frames\n+# - How to stop the camera\n+#\n+# This simple example is, in many ways, too simple. The purpose of the example\n+# is to introduce the concepts. A more realistic example is given in\n+# simple-continuous-capture.py.\n+\n+import argparse\n+import binascii\n+import libcamera as libcam\n+import libcamera.utils\n+import sys\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+ cam_config = cam.generate_configuration([libcam.StreamRole.Viewfinder])\n+\n+ stream_config = cam_config.at(0)\n+\n+ if args.format:\n+ fmt = libcam.PixelFormat(args.format)\n+ stream_config.pixel_format = fmt\n+\n+ if args.size:\n+ w, h = [int(v) for v in args.size.split('x')]\n+ stream_config.size = libcam.Size(w, h)\n+\n+ ret = cam.configure(cam_config)\n+ assert ret == 0\n+\n+ stream = stream_config.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 {num_bufs} frames with {stream_config}')\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+ # Queue the requests to the camera\n+\n+ for req in reqs:\n+ ret = cam.queue_request(req)\n+ assert ret == 0\n+\n+ # Wait until the requests are finished\n+\n+ reqs = []\n+\n+ while True:\n+ # cm.read_event() blocks until there is an event\n+ cm.read_event()\n+\n+ # Get all the ready requests\n+ ready_reqs = cm.get_ready_requests()\n+\n+ reqs += ready_reqs\n+\n+ if len(reqs) >= num_bufs:\n+ break\n+\n+ # Process the captured frames\n+\n+ for i, req in enumerate(reqs):\n+ assert i == req.cookie\n+\n+ buffers = req.buffers\n+\n+ # A ready Request could contain multiple buffers if multiple streams\n+ # were being used. Here we know we only have a single stream,\n+ # and we use next(iter()) to get the first and only buffer.\n+\n+ assert len(buffers) == 1\n+\n+ stream, fb = next(iter(buffers.items()))\n+\n+ # Use MappedFrameBuffer to access the pixel data with CPU. We calculate\n+ # the crc for each plane.\n+\n+ with libcamera.utils.MappedFrameBuffer(fb) as mfb:\n+ crcs = [binascii.crc32(p) for p in mfb.planes]\n+\n+ meta = fb.metadata\n+\n+ print('seq {}, bytes {}, CRCs {}'\n+ .format(meta.sequence,\n+ '/'.join([str(p.bytes_used) for p in meta.planes]),\n+ crcs))\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","v3","27/30"]}