MainWindow.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <QByteArray>
#include <QHash>
#include <QMainWindow>
#include <array>
#include <filesystem>
#include <memory>
#include <optional>
#include <string>
 
#include "HMI/Audio/AudioEngine.h"
#include "HMI/Audio/SoundCatalog.h"
#include "HMI/Editor/EditContextTarget.h"
#include "HMI/Editor/EditorTool.h"
#include "HMI/Editor/PanelFocus.h"
#include "HMI/Editor/PixelPalette.h"
#include "HMI/Editor/PixelTool.h"
#include "HMI/Game/GameEvents.h"
#include "HMI/Input/GamepadPoller.h"
#include "HMI/Input/InputState.h"
#include "HMI/Interface/EditorWorkspace.h"
#include "HMI/Localization/Localization.h"

 
class QAction;
class QLabel;
class QMenu;
class QStackedWidget;
class QTimer;
class QToolBar;
class QToolButton;
class QWidget;
 
namespace Ui {
class EditorMainWindow;
}
 
namespace core {
class MemoryLogSink;
}
 
namespace hmi {
 
class EditorActions;
class GameViewport;
class MainMenu;
class OptionsPage;
class PauseScreen;
class CreditsScreen;
class RpgScreenHost;
class PalettePanel;
class PlanesPanel;
class LevelBrowserPanel;
class LinkPanel;
class TexturePanel;
class PixelCanvas;
class PixelHistoryPanel;
class PixelPalettePanel;

class MainWindow : public QMainWindow {
public:
    explicit MainWindow(core::MemoryLogSink* sessionLog = nullptr);
    ~MainWindow() override;
 
protected:
    void closeEvent(QCloseEvent* event) override;
    void resizeEvent(QResizeEvent* event) override;
 
private:
    void applyWorkspace(EditorWorkspace workspace);

    void switchToWorkspace(EditorWorkspace workspace);

    [[nodiscard]] static QString layoutKeyFor(EditorWorkspace workspace);
    [[nodiscard]] static QString workspaceSettingsName(EditorWorkspace workspace);
    [[nodiscard]] static EditorWorkspace workspaceFromSettingsName(const QString& name);
    [[nodiscard]] QAction* workspaceSelector(EditorWorkspace workspace) const;

    [[nodiscard]] std::array<std::pair<QDockWidget*, hmi::PanelId>, hmi::PANEL_COUNT>
    workspacePanels() const;
 
protected:
    void moveEvent(QMoveEvent* event) override;
    bool eventFilter(QObject* watched, QEvent* event) override;
 
private:
    void connectPlanesPanel();
    [[nodiscard]] std::filesystem::path planesDirectory() const;
    void createPlane();
    void changePlaneDensity(std::size_t index, int pixelsPerUnit);

    void buildUi();
    void restoreLayout();
    void saveLayout();
    void openResizeDialog();

    void openShortcutsDialog();

    void retranslateUi();
    void refreshStatusHelp();
    void showTransientStatusMessage(const QString& message, int timeoutMs);
    void applyPanelFocus(hmi::EditorTool tool);
    void applyPixelPanelFocus(hmi::PixelTool tool);
    void raisePanel(hmi::PanelId panel);
    void updateActiveEditContext(QWidget* focused);
 
    // Atelier pixel art : ouvrir/créer/enregistrer (LOT-54 TACHE-05).
    [[nodiscard]] bool confirmDiscardPixelChanges();
    void openPixelAssetOpenDialog();
    void openPixelAssetCreateDialog();
    void savePixelAsset(bool saveAs);
 
    // Aperçu live et mode planche à raccords (LOT-54 TACHE-08).
    [[nodiscard]] std::string pixelAssetCacheKey() const;
    void updateLivePreview();
 
    // Mode création : peinture d'un plan pictural dans le canevas (LOT-69 TACHE-08).
    void loadPlaneIntoCanvas(std::size_t index);
    void savePlaneImage();
    void closePlaneInCanvas();
    void refreshPlaneReferences();
    [[nodiscard]] bool confirmDiscardPlaneChanges();
    [[nodiscard]] std::filesystem::path planeFilePath(std::size_t index) const;

    void openPixelColorPicker();
    void updatePixelColorButtonIcon(std::uint32_t color);
 
    // Palette de projet (LOT-54 TACHE-07).
    void syncPaletteToCanvas();
    void savePixelPalette();
    void changeLanguage(const QString& code);
    void saveSessionLogs();
    [[nodiscard]] QString text(const char* key) const;

    void showEditor();
    void setDocksVisible(bool visible);
 
    // Invariant de taille des écrans (`LOT-73`, `EX-IHM-080`).
 
    // Écran de pause (LOT-59 TACHE-02).

    void playInterfaceSound(GameEvent event);
 
    std::unique_ptr<Ui::EditorMainWindow> _ui;  
    GameViewport* _viewport;  
    EditContextTarget* _editContext = nullptr;
    PalettePanel* _palette;  
    PlanesPanel* _planes =
        nullptr;  
    LevelBrowserPanel*
        _levels;  
    LinkPanel* _links;        
    TexturePanel* _textures;  
    PixelCanvas* _pixelCanvas;
    PixelHistoryPanel*
        _pixelHistoryPanel;  
    PixelPalettePanel*
        _pixelPalettePanel;  
    PixelPalette
        _pixelPalette;  
    std::filesystem::path _pixelAssetPath;
    std::optional<std::size_t> _paintedPlane;
    EditorActions*
        _actions;  
    bool _closing = false;
    EditorWorkspace _workspace = EditorWorkspace::Level;
    QToolBar* _toolBar;       
    QToolBar* _pixelToolBar;  
    QToolButton* _pixelColorButton =
        nullptr;  
    QMenu* _pixelMenu =
        nullptr;        
    QMenu* _themeMenu;  
    QAction* _themeSystemAction;
    QAction* _themeLightAction;
    QAction* _themeDarkAction;
    QByteArray _defaultState;  
 
    // Regroupement des panneaux de droite en onglets, suivant l'outil actif (LOT-57 TACHE-02).
    QAction* _actFollowActiveTool = nullptr;  
    bool _userPickedTab = false;
 
    // Mode d'inspection par calque, déplacé du panneau Textures vers le menu Affichage
    // (LOT-57 TACHE-03) : une entrée cochable par calque, dans l'ordre de dessin, plus « tout
    // afficher ».
    std::array<QAction*, 7> _layerVisibilityActions{};
    QAction* _actShowAllLayers = nullptr;
    bool _suppressPanelFocusTracking = false;
 
    // Barre d'état structurée (LOT-57 TACHE-01) : zones permanentes (widgets ajoutés via
    // addPermanentWidget, jamais recouvertes par un message transitoire), dans l'ordre décidé par
    // hmi::editorStatusLines.
    QLabel* _statusLevel = nullptr;
    QLabel* _statusDirty = nullptr;
    QLabel* _statusTool = nullptr;
    QLabel* _statusHover = nullptr;
    QLabel* _statusZoom = nullptr;
    QLabel* _statusColor = nullptr;
    QLabel* _statusCameraFraming = nullptr;
    QTimer* _statusMessageTimer = nullptr;
 
    Localization _loc;  
    hmi::AudioEngine _audio;
    hmi::SoundCatalog _sounds;
    core::MemoryLogSink* _sessionLog;  
};
 
}  // namespace hmi