[libcamera-devel,v4,00/19] Document IPU3 IPA

14311 mbox series

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 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"

As there was a mismatch, the branch used in v2 did not include Laurent's
comments (sorry :-/) so those should now be taken into account.

v4:
- re-authored some patches to Kieran
- comments adressed

Enjoy :-) !

Jean-Michel Hautbois (12):
  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: awb: Reword accumulator documentation
  ipa: ipu3: agc: Document AGC mean-based algorithm
  ipa: ipu3: tonemapping: Generate the LUT only on gamma change
  ipa: ipu3: tonemapping: Implement configure call
  ipa: ipu3: tonemapping: Add the documentation for ToneMapping
  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
  Documentation: Include IPU3 in Doxygen build
  ipa: ipu3: ipa_context: Fix doxygen references

 Documentation/Doxyfile.in                |   3 +-
 Documentation/meson.build                |   1 +
 src/ipa/ipu3/algorithms/agc.cpp          |  80 +++++-
 src/ipa/ipu3/algorithms/agc.h            |   6 +-
 src/ipa/ipu3/algorithms/awb.cpp          | 120 +++++----
 src/ipa/ipu3/algorithms/awb.h            |   1 +
 src/ipa/ipu3/algorithms/tone_mapping.cpp |  51 +++-
 src/ipa/ipu3/algorithms/tone_mapping.h   |   1 +
 src/ipa/ipu3/ipa_context.cpp             | 136 +++++++++++
 src/ipa/ipu3/ipa_context.h               |   3 +-
 src/ipa/ipu3/ipu3-ipa-design-guide.rst   | 155 ++++++++++++
 src/ipa/ipu3/ipu3.cpp                    | 298 +++++++++++++----------
 src/ipa/ipu3/meson.build                 |   1 +
 13 files changed, 665 insertions(+), 191 deletions(-)
 create mode 100644 src/ipa/ipu3/ipa_context.cpp
 create mode 100644 src/ipa/ipu3/ipu3-ipa-design-guide.rst