{"id":9337,"url":"https://patchwork.libcamera.org/api/1.1/covers/9337/?format=json","web_url":"https://patchwork.libcamera.org/cover/9337/","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":"<20200820134751.278033-1-kieran.bingham@ideasonboard.com>","date":"2020-08-20T13:47:48","name":"[libcamera-devel,v4,0/3] Developer Guides","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/1.1/people/4/?format=json","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"mbox":"https://patchwork.libcamera.org/cover/9337/mbox/","series":[{"id":1225,"url":"https://patchwork.libcamera.org/api/1.1/series/1225/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=1225","date":"2020-08-20T13:47:48","name":"Developer Guides","version":4,"mbox":"https://patchwork.libcamera.org/series/1225/mbox/"}],"comments":"https://patchwork.libcamera.org/api/covers/9337/comments/","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 82F2BBE173\n\tfor ;\n\tThu, 20 Aug 2020 13:47:58 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id BCA7D61F61;\n\tThu, 20 Aug 2020 15:47:57 +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 F2DE560381\n\tfor ;\n\tThu, 20 Aug 2020 15:47:56 +0200 (CEST)","from Q.local (cpc89244-aztw30-2-0-cust3082.18-1.cable.virginm.net\n\t[86.31.172.11])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 3B06B23D;\n\tThu, 20 Aug 2020 15:47:56 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"GsZILi9N\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1597931276;\n\tbh=Bv3QLuaeqIAtZ7E0qMsZ8fEEP2BZvSElY0qQjC9UVeU=;\n\th=From:To:Cc:Subject:Date:From;\n\tb=GsZILi9NqtxoQMBoHs+NFQaFCLFmYsq8r1C4rC5oHy+0Or91Nuc8AS2jfatXAWrAI\n\tRzpYxmvJ8bSscBGdqyh6RE9YBsOU1nTJvCMm3oB6uILZVN+JiADbeKkRTWGMfl4nOg\n\tnfkXqYYfviVinhFzhXqMb+p6nLQNKmGOkVaJ3oGI=","From":"Kieran Bingham ","To":"libcamera devel ,\n\tChris Ward , Jacopo Mondi ","Date":"Thu, 20 Aug 2020 14:47:48 +0100","Message-Id":"<20200820134751.278033-1-kieran.bingham@ideasonboard.com>","X-Mailer":"git-send-email 2.25.1","MIME-Version":"1.0","Subject":"[libcamera-devel] [PATCH v4 0/3] Developer Guides","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","Content-Type":"text/plain; charset=\"us-ascii\"","Content-Transfer-Encoding":"7bit","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"Hi All,\n\nHere is the culmination of work from Chris, Jacopo and Myself preparing\nsome developer guides for libcamera. This is marked as v4, as they are\nbased upon earlier versions of work previously posted by Chris.\n\nThese three guides aim to cover detail across the areas that a developer\nwanting to make use of libcamera would look at, including a dedicated\nwalkthrough of the steps of creating a new pipeline handler, or a user\napplication which will make use of libcamera to capture frames.\n\nThe guides start with an introduction and overview, which replicates\nquite a bit from the existing \"Docs\" page, but forms part of refactoring\nthat documentation.\n\nThe Pipeline handler guide walks through the creation of a new pipeline\nhandler from scratch, implementing a PipelineHandlerVivid for the\nvirtual video test driver provided by the kernel. The aim of this guide\nis to provide readers with a full walkthrough of the various functions\nwhich must be impelmented when writing a new pipeline handler, and can\nbe followed without having a real device available (however the 'vivid'\nmodule must be provided by your kernel or distribution).\n\nThe Application writers guide discusses key aspects as the reader\nimplements a basic application to use the CameraManager to obtain a\ncamera, configure it, and capture frames.\n\nAn IPA writers guide is expected in the near future, but due to the\ncurrent activity and changes ongoing with the IPA API, that will be\nprovided after the current work activity with IPC has settled.\n\nThese guides are not yet built by the libcamera.org website (further\nrefactoring and organising will happen first), but are integrated into\nany local build which can be generated with Sphinx during the normal\nlibcamera build process.\n\nFurther expansion to all of these documents is also likely, but I hope\nto integrate these in their current form and build on top.\n\n\nChris Chinchilla (3):\n Documentation: Guides: Developers Guide to Libcamera\n Documentation: Guides: Pipeline Handler Writers Guide\n Documentation: Guides: Application Writers Guide\n\n .../guides/application-developer.rst | 644 +++++++\n Documentation/guides/introduction.rst | 319 ++++\n Documentation/guides/pipeline-handler.rst | 1473 +++++++++++++++++\n Documentation/index.rst | 4 +\n Documentation/meson.build | 3 +\n 5 files changed, 2443 insertions(+)\n create mode 100644 Documentation/guides/application-developer.rst\n create mode 100644 Documentation/guides/introduction.rst\n create mode 100644 Documentation/guides/pipeline-handler.rst"}