{"id":16015,"url":"https://patchwork.libcamera.org/api/patches/16015/?format=json","web_url":"https://patchwork.libcamera.org/patch/16015/","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":"<20220524114610.41848-11-tomi.valkeinen@ideasonboard.com>","date":"2022-05-24T11:46:01","name":"[libcamera-devel,v2,10/19] py: examples: Add simple-capture.py","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"58c2d3a6f51e7f1cdaee43a0e20d2820619e9fd3","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/16015/mbox/","series":[{"id":3134,"url":"https://patchwork.libcamera.org/api/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/16015/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/16015/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 7F4C0C3270\n\tfor <parsemail@patchwork.libcamera.org>;\n\tTue, 24 May 2022 11:46:45 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 5E5F96568A;\n\tTue, 24 May 2022 13:46:44 +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 4A8F865674\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tTue, 24 May 2022 13:46:35 +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 A87F759D;\n\tTue, 24 May 2022 13:46:34 +0200 (CEST)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1653392804;\n\tbh=LymWA+q6FABhdVSTivdJLURAgL5L49nG23E9Mlc/HeI=;\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=xFQA5I+V7HbZq4n7eOZ5Py+F1MJ4n7TO3ceZOoplpErIUdrRQugsrgJGaW+8ilx7t\n\t/NSYZ0A1XJ8ePMOurEEiyWzdEKT1EQW0WdAXT4g8u6Fb+WmD7OeMCel+ldkV6DAB6u\n\tNL3yqnn8jJVwAZMziK6BE7paxv0WX2aNx6T+paeFQKFhelpLTz2vz6gdvuCMmfWNEN\n\tWB+G3IeNME2UW8dj9kLP6M8facal1i0rYN+auBVVTJFrjmEmD1eWodbAgdYqjjLdkI\n\tnzFSPfhYYAGH2xM2ZjzRmiDOR3alHZeoOIlzW5NTA2yjVZ7WTWLz3IrJMSw7vqKguo\n\tNH89SDOnXRMgQ==","v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1653392795;\n\tbh=LymWA+q6FABhdVSTivdJLURAgL5L49nG23E9Mlc/HeI=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=iLZ9g1Xw6rumbNJfKV3CUwfPz3VYx2LJITEemYnohkowYc77zRlMF34XyhCWJVMBX\n\t66BhQRASwdU1UKSaXCQi0kAbs8N8zsL9r/2eRKKvVFcvwqgBma0ym85asAHoavA+t9\n\tgBQ6lQeNRLT6nGxXDVOsAhtj+D1mA9iXQb/aqbx4="],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"iLZ9g1Xw\"; 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":"Tue, 24 May 2022 14:46:01 +0300","Message-Id":"<20220524114610.41848-11-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 10/19] py: examples: Add\n\tsimple-capture.py","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 an example to showcase the more-or-less minimal capture case.\n\nSigned-off-by: Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\n---\n src/py/examples/simple-capture.py | 153 ++++++++++++++++++++++++++++++\n 1 file changed, 153 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..45df9e7a\n--- /dev/null\n+++ b/src/py/examples/simple-capture.py\n@@ -0,0 +1,153 @@\n+#!/usr/bin/env python3\n+\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright (C) 2022, Tomi Valkeinen <tomi.valkeinen@ideasonboard.com>\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+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+    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 {num_bufs} frames with {streamconfig}')\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, meta.bytesused, 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","v2","10/19"]}