CustomParamsKey.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include <QLatin1Char>
#include <QLatin1String>
#include <QString>
 
namespace PhosphorShaders {
 
inline constexpr double kMinBufferScale = 0.125;
inline constexpr double kMaxBufferScale = 1.0;
 
inline constexpr int kMaxBufferPasses = 4;
 
inline bool isValidWrapToken(const QString& wrap)
{
    return wrap == QLatin1String("clamp") || wrap == QLatin1String("repeat") || wrap == QLatin1String("mirror");
}
 
inline bool isValidFilterToken(const QString& filter)
{
    return filter == QLatin1String("linear") || filter == QLatin1String("nearest") || filter == QLatin1String("mipmap");
}
 
namespace CustomParams {
 
inline constexpr int kVecCount = 8;
 
inline constexpr int kFlatSlotCount = 4 * kVecCount;
 
inline QString slotKey(int vec, char comp)
{
    // Same graceful-degradation contract as the flat slotKey(int) below: an
    // out-of-range vec or a component outside {x,y,z,w} returns an empty string
    // rather than fabricating a key that could collide with a valid one.
    if (vec < 0 || vec >= kVecCount || (comp != 'x' && comp != 'y' && comp != 'z' && comp != 'w')) {
        return {};
    }
    return QStringLiteral("customParams") + QString::number(vec + 1) + QLatin1Char('_') + QLatin1Char(comp);
}
 
inline QString slotKey(int slot)
{
    if (slot < 0 || slot >= kFlatSlotCount) {
        return {};
    }
    static constexpr char kComponents[4] = {'x', 'y', 'z', 'w'};
    return slotKey(slot / 4, kComponents[slot & 3]);
}
 
inline QString glslAccessor(int slot)
{
    if (slot < 0 || slot >= kFlatSlotCount) {
        return {};
    }
    static constexpr char kComponents[4] = {'x', 'y', 'z', 'w'};
    return QStringLiteral("customParams[") + QString::number(slot / 4) + QStringLiteral("].")
        + QLatin1Char(kComponents[slot & 3]);
}
 
} // namespace CustomParams
 
namespace CustomColors {
 
inline constexpr int kColorCount = 16;
 
inline QString colorKey(int slot)
{
    if (slot < 0 || slot >= kColorCount) {
        return {};
    }
    return QStringLiteral("customColor") + QString::number(slot + 1);
}
 
inline QString glslAccessor(int slot)
{
    if (slot < 0 || slot >= kColorCount) {
        return {};
    }
    return QStringLiteral("customColors[") + QString::number(slot) + QLatin1Char(']');
}
 
} // namespace CustomColors
 
} // namespace PhosphorShaders