quantumbrightpass_tests.cpp

Go to the documentation of this file.

/**
 * @file quantumbrightpass_tests.cpp
 * @brief Implements regression and invariant tests for quantumbrightpass tests.
 * @ingroup qpe_tests
 *
 * Source: @c tests/quantumbrightpass_tests.cpp. This file is part of Quantum Phenomena Explorer (QPE),
 * maintained by Officina Turini. See LICENSE_IT.txt / LICENSE.txt for the
 * QPE freeware source-available terms and THIRD_PARTY_NOTICES.txt for
 * third-party components.
 */
 
#include "quantumbrightpass_tests.h"
 
#include "graphics/renderer/quantumbrightpass.h"
 
#include <cmath>
 
namespace qpe {
namespace tests {
 
namespace {
 
/**
 * @brief Performs nearly equal.
 * @param a The a value used by the operation.
 * @param b The b value used by the operation.
 * @param eps The eps value used by the operation.
 */
bool nearlyEqual(float a, float b, float eps = 1.0e-6f)
{
    return std::fabs(a - b) <= eps;
}
 
} // namespace
 
/**
 * @brief Runs quantum bright pass tests.
 * @param error Output diagnostic text on failure.
 */
bool runQuantumBrightPassTests(std::string &error)
{
    error.clear();
 
    if (!nearlyEqual(QuantumBrightPass::mask(0.49f, 0.50f, 0.0f), 0.0f)) {
        error = "Hard threshold must reject luminance below threshold";
        return false;
    }
    if (!nearlyEqual(QuantumBrightPass::mask(0.50f, 0.50f, 0.0f), 1.0f)) {
        error = "Hard threshold must accept luminance at threshold";
        return false;
    }
 
    if (!nearlyEqual(QuantumBrightPass::mask(0.50f, 0.50f, 0.10f), 0.5f)) {
        error = "Soft knee must be half-selected at the threshold";
        return false;
    }
 
    if (!nearlyEqual(QuantumBrightPass::mask(0.30f, 0.50f, 0.10f), 0.0f)) {
        error = "Soft knee must fully reject luminance below its lower edge";
        return false;
    }
    if (!nearlyEqual(QuantumBrightPass::mask(0.70f, 0.50f, 0.10f), 1.0f)) {
        error = "Soft knee must fully select luminance above its upper edge";
        return false;
    }
 
    return true;
}
 
} // namespace tests
} // namespace qpe