[libcamera-devel] [PATCH v4 0/3] Developer Guides

[Kieran Bingham]

Hi All,

Here is the culmination of work from Chris, Jacopo and Myself preparing
some developer guides for libcamera. This is marked as v4, as they are
based upon earlier versions of work previously posted by Chris.

These three guides aim to cover detail across the areas that a developer
wanting to make use of libcamera would look at, including a dedicated
walkthrough of the steps of creating a new pipeline handler, or a user
application which will make use of libcamera to capture frames.

The guides start with an introduction and overview, which replicates
quite a bit from the existing "Docs" page, but forms part of refactoring
that documentation.

The Pipeline handler guide walks through the creation of a new pipeline
handler from scratch, implementing a PipelineHandlerVivid for the
virtual video test driver provided by the kernel. The aim of this guide
is to provide readers with a full walkthrough of the various functions
which must be impelmented when writing a new pipeline handler, and can
be followed without having a real device available (however the 'vivid'
module must be provided by your kernel or distribution).

The Application writers guide discusses key aspects as the reader
implements a basic application to use the CameraManager to obtain a
camera, configure it, and capture frames.

An IPA writers guide is expected in the near future, but due to the
current activity and changes ongoing with the IPA API, that will be
provided after the current work activity with IPC has settled.

These guides are not yet built by the libcamera.org website (further
refactoring and organising will happen first), but are integrated into
any local build which can be generated with Sphinx during the normal
libcamera build process.

Further expansion to all of these documents is also likely, but I hope
to integrate these in their current form and build on top.


Chris Chinchilla (3):
  Documentation: Guides: Developers Guide to Libcamera
  Documentation: Guides: Pipeline Handler Writers Guide
  Documentation: Guides: Application Writers Guide

 .../guides/application-developer.rst          |  644 +++++++
 Documentation/guides/introduction.rst         |  319 ++++
 Documentation/guides/pipeline-handler.rst     | 1473 +++++++++++++++++
 Documentation/index.rst                       |    4 +
 Documentation/meson.build                     |    3 +
 5 files changed, 2443 insertions(+)
 create mode 100644 Documentation/guides/application-developer.rst
 create mode 100644 Documentation/guides/introduction.rst
 create mode 100644 Documentation/guides/pipeline-handler.rst

-- 
2.25.1