From patchwork Mon Sep 13 14:57:59 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jean-Michel Hautbois X-Patchwork-Id: 13828 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 35926BDB1D for ; Mon, 13 Sep 2021 14:58:17 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 595E16918D; Mon, 13 Sep 2021 16:58:16 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="goaktFKy"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 1D7E96024C for ; Mon, 13 Sep 2021 16:58:14 +0200 (CEST) Received: from tatooine.ideasonboard.com (unknown [IPv6:2a01:e0a:169:7140:edc5:688b:2ede:8b4b]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id AC50B499; Mon, 13 Sep 2021 16:58:13 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1631545093; bh=Of90STXszdM/Qw2RuzxOaRAbKvPsTOymCRRRxZ2KhCs=; h=From:To:Cc:Subject:Date:From; b=goaktFKyeJhlUBZMxX4hb5cMs1BLAKPjjQM2xI1yp4YVfwhA/3dJ715m0vwXzrsuz yWDaUKvO4Mdc8cKjq8ILPmioK9JDphMjLhQeWlRl2E+peBmfGQOtQSEAz+gzSwGOrD hSovwNqK6IYPi3cDEqB2UTJxcAGlQfok+axEu2L4= From: Jean-Michel Hautbois To: libcamera-devel@lists.libcamera.org Date: Mon, 13 Sep 2021 16:57:59 +0200 Message-Id: <20210913145810.66515-1-jeanmichel.hautbois@ideasonboard.com> X-Mailer: git-send-email 2.30.2 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH 00/11] Document all the IPU3 IPA classes X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" 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. This patch series applies on top of "Move and improve AWB structures". The first sequence (patch 1/11 to 5/11) concerns the IPAIPU3 class, and documents it to detail how events are handled, how the algorithms are used, etc. Next, a bit more documentation is added in AWB to reference the grey-world algorithm used, and the inputs/outputs of it. The third sequence (from 7/11 to 9/11) follows the same path with AGC, adding the missing definitions where they lack, etc. And tonemapping was not documented either. While at it in patch 10/11 we will first cache the gamma value to apply in order to avoid unneeded calculations, and eventually add the documentation in the latest 11/11. Jean-Michel Hautbois (11): ipa: ipu3: Document IPAIPU3 class interface ipa: ipu3: Improve the documentation of BDS grid 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 ipu3: ipa: agc: Determine cell size from ipu3_uapi_awb_set_item ipa: ipu3: agc: Remove unused variable count 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 src/ipa/ipu3/algorithms/agc.cpp | 120 ++++++++++++++--- src/ipa/ipu3/algorithms/agc.h | 2 +- src/ipa/ipu3/algorithms/awb.cpp | 33 +++++ src/ipa/ipu3/algorithms/tone_mapping.cpp | 40 +++++- src/ipa/ipu3/ipa_context.h | 1 + src/ipa/ipu3/ipu3.cpp | 162 ++++++++++++++++++++++- 6 files changed, 330 insertions(+), 28 deletions(-)