quantumgraphicspreset.cpp

Go to the documentation of this file.

/**
 * @file quantumgraphicspreset.cpp
 * @brief Implements the quantumgraphicspreset visualization component used by QPE.
 * @ingroup qpe_graphics
 *
 * Source: @c graphics/renderer/quantumgraphicspreset.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 "quantumgraphicspreset.h"
 
namespace qpe {
 
QuantumGraphicsPresetValues QuantumGraphicsPreset::values(QuantumGraphicsPresetKind kind)
{
    QuantumGraphicsPresetValues preset;
 
    switch (kind) {
    case QuantumGraphicsPresetKind::Scientific:
        // Quantitative reference view: linear transfer, no HDR glow and no
        // highlight compression beyond the framebuffer's ordinary display.
        preset.paletteIndex = 0;          // Scientific
        preset.displayScaleIndex = 0;     // Linear
        preset.exposureEv = 0.0;
        preset.gamma = 1.0;
        preset.postPreviewIndex = 0;      // Scene
        preset.brightThreshold = 0.72;
        preset.brightSoftKnee = 0.08;
        preset.blurSpread = 2.0;
        preset.bloomStrength = 0.0;
        preset.toneMapIndex = 0;          // Off / Clip
        break;
 
    case QuantumGraphicsPresetKind::Presentation:
        // Readable live-demo view: preserve a mostly linear scene, add only a
        // restrained highlight halo and use ACES to protect bright cores.
        preset.paletteIndex = 0;          // Scientific
        preset.displayScaleIndex = 0;     // Linear
        preset.exposureEv = 0.25;
        preset.gamma = 1.0;
        preset.postPreviewIndex = 3;      // Bloom
        preset.brightThreshold = 0.72;
        preset.brightSoftKnee = 0.08;
        preset.blurSpread = 2.0;
        preset.bloomStrength = 0.65;
        preset.toneMapIndex = 2;          // ACES Filmic
        break;
 
    case QuantumGraphicsPresetKind::Cinematic:
    default:
        // Demonstration / "wow" view: reveal weak structures, broaden the
        // extracted highlights and use a stronger HDR glow with ACES.
        preset.paletteIndex = 0;          // Scientific
        preset.displayScaleIndex = 1;     // Log (~3 decades)
        preset.exposureEv = -1.0;
        preset.gamma = 1.15;
        preset.postPreviewIndex = 3;      // Bloom
        preset.brightThreshold = 0.62;
        preset.brightSoftKnee = 0.12;
        preset.blurSpread = 3.25;
        preset.bloomStrength = 1.80;
        preset.toneMapIndex = 2;          // ACES Filmic
        break;
    }
 
    return preset;
}
 
const char *QuantumGraphicsPreset::name(QuantumGraphicsPresetKind kind)
{
    switch (kind) {
    case QuantumGraphicsPresetKind::Scientific:
        return "Scientific";
    case QuantumGraphicsPresetKind::Presentation:
        return "Presentation";
    case QuantumGraphicsPresetKind::Cinematic:
    default:
        return "Cinematic";
    }
}
 
} // namespace qpe