[libcamera-devel,00/18] Document IPU3 IPA
mbox series

Message ID 20210930095513.76213-1-jeanmichel.hautbois@ideasonboard.com
Headers show
Series
  • Document IPU3 IPA
Related show

Message

Jean-Michel Hautbois Sept. 30, 2021, 9:54 a.m. UTC 
Hi everyone !

We have modified most of the AWB and AGC algorithms now, we have better
structure names and handling, it is time to make all the documentation
follow the same path.

It includes patches from both Kieran and me.

This patch series applies on top of "[PATCH v2 00/12] Improve ImgU
statistics usage".

This series merges multiple patches/series already sent to ease the
follow-up.

We have four parts:
- Add documentation for the IPA IPU3 class
- Improve IPU3 algorithms documentation
  -> those two parts were mostly in "[PATCH 00/11] Document all the IPU3 IPA
     classes"
- Make it compile with Doxygen (this is new)
- Add a design document for IPU3 IPA
  -> this has been sent before as "[RFC PATCH] Documentation: IPU3 IPA Design
     guide"

Enjoy :-) !

Jean-Michel Hautbois (11):
  ipa: ipu3: Document IPAIPU3 class interface
  ipa: ipu3: Document IPAIPU3::configure
  ipa: ipu3: Document the IPAIPU3 class
  ipa: ipu3: Explicitly use the statistics parameter
  ipa: ipu3: awb: Add AWB class documentation
  ipa: ipu3: agc: Document AGC mean-based algorithm
  ipa: ipu3: tonemapping: Generate the LUT only on gamma change
  ipa: ipu3: tonemapping: Add the documentation for ToneMapping
  ipa: ipu3: awb: Document the Accumulator::sum variable
  ipa: ipu3: Fix badly documented context variables
  ipa: ipu3: Implement an empty stop() function

Kieran Bingham (7):
  Documentation: IPU3 IPA Design guide
  ipa: ipu3: ipa_context: Fix file reference.
  ipa: ipu3: Fix the IPU3 AWB doxygen references
  ipa: ipu3: algorithms: awb: Privatize internal structures
  ipa: ipu3: Isolate ipa_context documentation
  ipa: ipu3: ipa_context: Fix doxygen references
  Documentation: Include IPU3 in Doxygen build

 Documentation/Doxyfile.in                |   1 +
 Documentation/meson.build                |   1 +
 src/ipa/ipu3/algorithms/agc.cpp          | 102 +++++++--
 src/ipa/ipu3/algorithms/agc.h            |   2 +-
 src/ipa/ipu3/algorithms/awb.cpp          |  38 +++-
 src/ipa/ipu3/algorithms/awb.h            |   1 +
 src/ipa/ipu3/algorithms/tone_mapping.cpp |  40 +++-
 src/ipa/ipu3/ipa_context.cpp             | 116 +++++++++++
 src/ipa/ipu3/ipa_context.h               |   3 +-
 src/ipa/ipu3/ipu3-ipa-design-guide.rst   | 155 ++++++++++++++
 src/ipa/ipu3/ipu3.cpp                    | 251 +++++++++++++----------
 src/ipa/ipu3/meson.build                 |   1 +
 12 files changed, 589 insertions(+), 122 deletions(-)
 create mode 100644 src/ipa/ipu3/ipa_context.cpp
 create mode 100644 src/ipa/ipu3/ipu3-ipa-design-guide.rst