libcamera/Documentation
Laurent Pinchart 8ea6912c96 libcamera: controls: Auto-generate control_ids.h and control_ids.cpp
Bring back auto-generation of control ids. In this version, both the
header and the source files are generated from a single YAML file that
stores all control definitions. This allows centralising controls in a
single file, while the previous version required keeping both
declarations (in a header) and documentation (in a the source) in sync
manually.

Using YAML as a format to store control definitions is a trade-off
between ease of use (there are many YAML parsers available) and
simplicity (XML was considered, but would have lead to more complex
processing). A new build time dependency is added on python3-yaml, which
should be available as a package in all distributions and build
environments.

The YAML format is likely to change over time as we improve
documentation of controls, the first version simply copies the
information currently available. Future improvements should also include
a YAML schema to validate the YAML source file.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Niklas Söderlund <niklas.soderlund@ragnatech.se>
2019-10-05 20:02:51 +03:00
..
api-html Documentation: Add placeholder for Doxygen-generated API documentation 2019-01-11 17:17:22 +02:00
theme Documentation: Add custom theme 2019-01-11 15:26:25 +02:00
coding-style.rst libcamera: Document documentation style and update the code accordingly 2019-04-19 13:20:46 +03:00
conf.py libcamera: Auto generate version information 2019-07-04 22:11:27 +01:00
contributing.rst licenses: Add the Developer CoO 2019-01-02 21:59:46 +02:00
docs.rst Documentation: Fix trivial spelling error 2019-07-10 13:03:31 +01:00
Doxyfile.in libcamera: controls: Auto-generate control_ids.h and control_ids.cpp 2019-10-05 20:02:51 +03:00
index.rst readme: Move index page content to README 2019-08-16 08:51:28 +01:00
meson.build libcamera: Move ipa includes to the same level as libcamera 2019-09-15 13:57:08 +03:00