Settings.h

Go to the documentation of this file.

// Copyright 2015 - 2026, GIBIS-UNIFESP and the wiRedPanda contributors
// SPDX-License-Identifier: GPL-3.0-or-later

 
#pragma once
 
#include <QByteArray>
#include <QRect>
#include <QSettings>
#include <QStringList>
 
#include "App/Core/ThemeManager.h"

class Settings
{
public:
    Settings() = delete;

    static QString fileName();
 
    // --- Typed accessors ---
 
    // Window state
    static QByteArray mainWindowGeometry();
    static void setMainWindowGeometry(const QByteArray &geometry);
    static QByteArray mainWindowState();
    static void setMainWindowState(const QByteArray &state);
    static QByteArray splitterGeometry();
    static void setSplitterGeometry(const QByteArray &geometry);
    static QByteArray splitterState();
    static void setSplitterState(const QByteArray &state);
    static QByteArray dolphinGeometry();
    static void setDolphinGeometry(const QByteArray &geometry);
 
    // UI preferences
    static bool fastMode();
    static void setFastMode(bool enabled);
    static bool labelsUnderIcons();
    static void setLabelsUnderIcons(bool enabled);
    static bool icPreviewDisabled();
    static void setIcPreviewDisabled(bool disabled);
 
    // Language
    static QString language();
    static void setLanguage(const QString &lang);
 
    // Theme
    static Theme theme();
    static void setTheme(Theme theme);
 
    // Recent files
    static QStringList recentFiles();
    static void setRecentFiles(const QStringList &files);
 
    // Autosave
    static QStringList autosaveFiles();
    static void setAutosaveFiles(const QStringList &files);
 
    // V4 format warning suppression
    static bool hideV4Warning();
    static void setHideV4Warning(bool hide);
 
    // Update checker
    static QString updateCheckLastDate();
    static void setUpdateCheckLastDate(const QString &date);
    static QString updateCheckSkippedVersion();
    static void setUpdateCheckSkippedVersion(const QString &version);
    static bool updateChecksDisabled();
    static void setUpdateChecksDisabled(bool disabled);
 
    // Exercise progress
    static QStringList completedExercises();
    static void        setCompletedExercises(const QStringList &ids);
    static int         exerciseProgress(const QString &exerciseId); 
    static void        setExerciseProgress(const QString &exerciseId, int step);
 
    // Tour progress
    static QStringList completedTours();
    static void        setCompletedTours(const QStringList &ids);
    static int         tourProgress(const QString &tourId); 
    static void        setTourProgress(const QString &tourId, int step);

    static bool welcomeTourShown();
    static void setWelcomeTourShown(bool shown);
 
    // Minimap preferences
    static bool minimapVisible();
    static void setMinimapVisible(bool visible);
    static QRect minimapGeometry();
    static void setMinimapGeometry(const QRect &geometry);
 
private:
    static QVariant value(const QString &key);
    static void setValue(const QString &key, const QVariant &value);
    static QSettings *settingsInstance();
 
    // --- Members ---
 
    inline static QSettings *settings = nullptr;
};