external_libcamera/src/ipa/rkisp1/algorithms/cproc.cpp

/* SPDX-License-Identifier: LGPL-2.1-or-later */
/*
 * Copyright (C) 2021-2022, Ideas On Board
 *
 * RkISP1 Color Processing control
 */

#include "cproc.h"

#include <algorithm>
#include <cmath>

#include <libcamera/base/log.h>

#include <libcamera/control_ids.h>

/**
 * \file cproc.h
 */

namespace libcamera {

namespace ipa::rkisp1::algorithms {

/**
 * \class ColorProcessing
 * \brief RkISP1 Color Processing control
 *
 * The ColorProcessing algorithm is responsible for applying brightness,
 * contrast and saturation corrections. The values are directly provided
 * through requests by the corresponding controls.
 */

LOG_DEFINE_CATEGORY(RkISP1CProc)

namespace {

constexpr float kDefaultBrightness = 0.0f;
constexpr float kDefaultContrast = 1.0f;
constexpr float kDefaultHue = 0.0f;
constexpr float kDefaultSaturation = 1.0f;

/*
 * The Hue scale is negated as the hardware performs the opposite phase shift
 * to what is expected and defined from the libcamera Hue control value.
 */
constexpr float kHueScale = -90.0f;

} /* namespace */

/**
 * \copydoc libcamera::ipa::Algorithm::init
 */
int ColorProcessing::init(IPAContext &context,
			  [[maybe_unused]] const ValueNode &tuningData)
{
	auto &cmap = context.ctrlMap;

	cmap[&controls::Brightness] = ControlInfo(-1.0f, 0.993f, kDefaultBrightness);
	cmap[&controls::Contrast] = ControlInfo(0.0f, 1.993f, kDefaultContrast);
	cmap[&controls::Saturation] = ControlInfo(0.0f, 1.993f, kDefaultSaturation);

	/* Hue adjustment is negated by kHueScale, min/max are swapped */
	cmap[&controls::Hue] = ControlInfo(HueQ::TraitsType::max * kHueScale,
					   HueQ::TraitsType::min * kHueScale,
					   kDefaultHue);

	return 0;
}

/**
 * \copydoc libcamera::ipa::Algorithm::configure
 */
int ColorProcessing::configure(IPAContext &context,
			       [[maybe_unused]] const IPACameraSensorInfo &configInfo)
{
	auto &cproc = context.activeState.cproc;

	cproc.brightness = BrightnessQ(kDefaultBrightness);
	cproc.contrast = ContrastQ(kDefaultContrast);
	cproc.hue = HueQ(kDefaultHue);
	cproc.saturation = SaturationQ(kDefaultSaturation);

	return 0;
}

/**
 * \copydoc libcamera::ipa::Algorithm::queueRequest
 */
void ColorProcessing::queueRequest(IPAContext &context,
				   const uint32_t frame,
				   IPAFrameContext &frameContext,
				   const ControlList &controls)
{
	auto &cproc = context.activeState.cproc;
	bool update = false;

	if (frame == 0)
		update = true;

	const auto &brightness = controls.get(controls::Brightness);
	if (brightness) {
		BrightnessQ value = *brightness;
		if (cproc.brightness != value) {
			cproc.brightness = value;
			update = true;
		}

		LOG(RkISP1CProc, Debug) << "Set brightness to " << value;
	}

	const auto &contrast = controls.get(controls::Contrast);
	if (contrast) {
		ContrastQ value = *contrast;
		if (cproc.contrast != value) {
			cproc.contrast = value;
			update = true;
		}

		LOG(RkISP1CProc, Debug) << "Set contrast to " << value;
	}

	const auto &hue = controls.get(controls::Hue);
	if (hue) {
		/* Scale the Hue from ]-90, +90] */
		HueQ value = *hue / kHueScale;
		if (cproc.hue != value) {
			cproc.hue = value;
			update = true;
		}

		LOG(RkISP1CProc, Debug) << "Set hue to " << value;
	}

	const auto saturation = controls.get(controls::Saturation);
	if (saturation) {
		SaturationQ value = *saturation;
		if (cproc.saturation != value) {
			cproc.saturation = value;
			update = true;
		}

		LOG(RkISP1CProc, Debug) << "Set saturation to " << value;
	}

	frameContext.cproc.brightness = cproc.brightness;
	frameContext.cproc.contrast = cproc.contrast;
	frameContext.cproc.hue = cproc.hue;
	frameContext.cproc.saturation = cproc.saturation;
	frameContext.cproc.update = update;
}

/**
 * \copydoc libcamera::ipa::Algorithm::prepare
 */
void ColorProcessing::prepare([[maybe_unused]] IPAContext &context,
			      [[maybe_unused]] const uint32_t frame,
			      IPAFrameContext &frameContext,
			      RkISP1Params *params)
{
	/* Check if the algorithm configuration has been updated. */
	if (!frameContext.cproc.update)
		return;

	auto config = params->block<BlockType::Cproc>();
	config.setEnabled(true);
	config->brightness = frameContext.cproc.brightness.quantized();
	config->contrast = frameContext.cproc.contrast.quantized();
	config->hue = frameContext.cproc.hue.quantized();
	config->sat = frameContext.cproc.saturation.quantized();
}

/**
 * \copydoc libcamera::ipa::Algorithm::process
 */
void ColorProcessing::process([[maybe_unused]] IPAContext &context,
			      [[maybe_unused]] const uint32_t frame,
			      IPAFrameContext &frameContext,
			      [[maybe_unused]] const rkisp1_stat_buffer *stats,
			      ControlList &metadata)
{
	metadata.set(controls::Brightness, frameContext.cproc.brightness.value());
	metadata.set(controls::Contrast, frameContext.cproc.contrast.value());
	metadata.set(controls::Hue, frameContext.cproc.hue.value() * kHueScale);
	metadata.set(controls::Saturation, frameContext.cproc.saturation.value());
}

REGISTER_IPA_ALGORITHM(ColorProcessing, "ColorProcessing")

} /* namespace ipa::rkisp1::algorithms */

} /* namespace libcamera */