Phosphor
Qt6 / Wayland library suite for window-management tools
Loading...
Searching...
No Matches
ShaderPresetRegistry.h
Go to the documentation of this file.
1// SPDX-FileCopyrightText: 2026 fuddlesworth
2// SPDX-License-Identifier: LGPL-2.1-or-later
3
4#pragma once
5
8#include <PhosphorShaders/phosphorshaders_export.h>
9
10#include <QHash>
11#include <QSet>
12#include <QList>
13#include <QObject>
14#include <QString>
15#include <QVariantMap>
16
17namespace PhosphorShaders {
18
50class PHOSPHORSHADERS_EXPORT ShaderPresetRegistry : public QObject
51{
52 Q_OBJECT
53
54public:
55 explicit ShaderPresetRegistry(QObject* parent = nullptr);
57
58 // ─────── Lookup ───────
59
63 QList<ShaderPreset> presetsFor(ShaderFamily family, const QString& packId) const;
64
72 ShaderPreset preset(ShaderFamily family, const QString& packId, const QString& presetId) const;
73
89 ShaderPreset presetById(ShaderFamily family, const QString& presetId) const;
90
104 QVariantMap resolveParams(ShaderFamily family, const QString& packId, const QString& presetId,
105 const QVariantMap& deltas) const;
106
107 // ─────── Population ───────
108
121 void setPackPresets(ShaderFamily family, const QString& packId, const PackPresets& presets,
122 const PresetValueBounds& bounds = {});
123
135 void setPackPresetsForFamily(ShaderFamily family, const QHash<QString, PackPresets>& byPackId,
136 const QHash<QString, PresetValueBounds>& boundsByPackId = {});
137
145 void setUserPresets(ShaderFamily family, const QList<ShaderPreset>& presets);
146
147Q_SIGNALS:
154 void presetsChanged(PhosphorShaders::ShaderFamily family, const QString& packId);
155
156private:
160 QHash<QString, QHash<QString, ShaderPreset>> m_packDeclared;
161 QHash<QString, QHash<QString, ShaderPreset>> m_userDefined;
165 QHash<QString, PresetValueBounds> m_packBounds;
166
174 QSet<QString> m_reportedIdClashes;
175
176 static QString scopeKey(ShaderFamily family, const QString& packId);
177 QList<ShaderPreset> mergedFor(ShaderFamily family, const QString& packId) const;
179 void clampToBounds(const QString& key, QVariantMap& values) const;
182 bool applyPackBucket(const QString& key, const QString& packId, const PackPresets& presets,
183 const PresetValueBounds& bounds);
184};
185
206template<typename EffectList>
207void seedPackPresets(ShaderPresetRegistry& registry, ShaderFamily family, const EffectList& effects)
208{
209 QHash<QString, PackPresets> byPack;
210 QHash<QString, PresetValueBounds> bounds;
211 for (const auto& effect : effects) {
212 byPack.insert(effect.id, effect.presets);
213 bounds.insert(effect.id, presetBoundsFrom(effect.parameters));
214 }
215 registry.setPackPresetsForFamily(family, byPack, bounds);
216}
217
218} // namespace PhosphorShaders
219
220Q_DECLARE_METATYPE(PhosphorShaders::ShaderFamily)
The one place a presetId on an assignment turns into parameters.
Definition ShaderPresetRegistry.h:51
ShaderPreset preset(ShaderFamily family, const QString &packId, const QString &presetId) const
The preset presetId names, or an invalid preset when it names none.
void presetsChanged(PhosphorShaders::ShaderFamily family, const QString &packId)
The presets offered for (family, packId) changed: one was added, removed, renamed,...
QList< ShaderPreset > presetsFor(ShaderFamily family, const QString &packId) const
Every preset offered for packId in family, user presets first, each group sorted by display name so t...
ShaderPreset presetById(ShaderFamily family, const QString &presetId) const
The preset presetId names, searched across every pack in family.
QVariantMap resolveParams(ShaderFamily family, const QString &packId, const QString &presetId, const QVariantMap &deltas) const
The effective parameter map for an assignment: the preset's parameters overlaid with deltas,...
void setUserPresets(ShaderFamily family, const QList< ShaderPreset > &presets)
Replace every user preset in family with presets.
ShaderPresetRegistry(QObject *parent=nullptr)
void setPackPresetsForFamily(ShaderFamily family, const QHash< QString, PackPresets > &byPackId, const QHash< QString, PresetValueBounds > &boundsByPackId={})
Replace every pack-declared preset for EVERY pack in family at once.
void setPackPresets(ShaderFamily family, const QString &packId, const PackPresets &presets, const PresetValueBounds &bounds={})
Replace every pack-declared preset for packId in family.
Definition ShaderProfile.h:21
PresetValueBounds presetBoundsFrom(const ParameterList &parameters)
Collect PresetValueBounds from any family's declared parameter list.
Definition ShaderPreset.h:70
ShaderFamily
Which shader family a preset belongs to.
Definition ShaderPreset.h:28
QHash< QString, PresetValueRange > PresetValueBounds
The declared ranges for a pack's parameters, by parameter id.
Definition ShaderPreset.h:61
void seedPackPresets(ShaderPresetRegistry &registry, ShaderFamily family, const EffectList &effects)
Seed registry with every pack-declared preset in effects, for family.
Definition ShaderPresetRegistry.h:207
QMap< QString, QVariantMap > PackPresets
Pack-declared named parameter presets: preset name → { paramId → value }.
Definition ShaderPresetParse.h:32
One named parameter tuning for one shader pack.
Definition ShaderPreset.h:98