TexturePanel.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <QImage>
#include <QPixmap>
#include <QWidget>
#include <cstddef>
#include <filesystem>
#include <memory>
#include <optional>
#include <string>
#include <unordered_map>
#include <vector>
 
#include "Core/Ecs/Components/Animation.h"
#include "Core/Levels/CameraFraming.h"
#include "Core/Levels/GridPosition.h"
#include "Core/Levels/Level.h"
#include "Core/Levels/TileType.h"
#include "HMI/Graphics/AnimationCatalog.h"
#include "HMI/Graphics/SkinCatalog.h"

 
class QEvent;
class QModelIndex;
class QStandardItem;
class QStandardItemModel;
class QTimer;
 
namespace Ui {
class TexturePanel;
}
 
namespace core {
class LevelDraft;
}  // namespace core
 
namespace hmi {
 
class AssetThumbnailView;
class Localization;

class TexturePanel : public QWidget {
    Q_OBJECT
 
public:
    explicit TexturePanel(std::filesystem::path skinsDirectory, std::filesystem::path catalogPath,
                          std::filesystem::path backgroundsDirectory,
                          std::filesystem::path objectsDirectory, QWidget* parent = nullptr);
    ~TexturePanel() override;

    void setCatalog(SkinCatalog* catalog);

    void setLevelProperties(const std::optional<std::string>& background,
                            const std::optional<std::string>& skinSet);

    void setLevelCameraFraming(const core::CameraFramingConfig& cameraFraming);

    [[nodiscard]] const std::string& currentSet() const noexcept {
        return _currentSet;
    }

    void retranslateUi(const Localization& loc);

    void reloadAssets();

    void refreshObjects(const core::LevelDraft& draft);
 
protected:
    bool event(QEvent* event) override;
 
signals:
    void assignmentsChanged();
    void reloadRequested();
    void backgroundChanged(const QString& fileName);
    void levelSkinSetChanged(const QString& setName);
    void cameraFramingChanged(core::CameraFramingConfig cameraFraming);
    void cameraZoneRemoveRequested(std::size_t index);
    void textureOverrideAssetSelected(const QString& fileName);
    void textureOverrideSelectionChanged(std::optional<core::GridPosition> position);
    void textureOverrideRemoveRequested(core::GridPosition position);
 
private:
    void rebuildTree();
    void onSetChanged(int index);
    void onItemChanged(QStandardItem* item);
    void onAssetColumnActivated(const QModelIndex& index);
    void save();
    [[nodiscard]] QPixmap thumbnailFor(const std::string& asset);
    void rebuildLevelSkinSetSelector();
    void rebuildCameraFramingSelector();
    void rebuildCameraFramingZonesTable();
    void emitCameraFramingChanged();
    void onCameraFramingZonesSelectionChanged();
    void onCameraFramingZonesRemoveClicked();
    void rebuildObjectRows();
    void onObjectsSelectionChanged();
    void onObjectsRemoveClicked();
    void rebuildAnimationsTree();
    void onAnimationsAssetActivated(const QModelIndex& index);
    void onAnimationsSelectionChanged();
    void tickAnimationPreview();
 
    std::unique_ptr<Ui::TexturePanel> _ui;
    QStandardItemModel* _model;
    AssetThumbnailView*
        _backgroundView;                
    AssetThumbnailView* _objectView;    
    QStandardItemModel* _objectsModel;  
    QStandardItemModel* _cameraFramingZonesModel;
    QStandardItemModel*
        _animationsModel;            
    QTimer* _animationPreviewTimer;  
    QImage _animationPreviewSheet;
    std::optional<AnimationDescription> _animationPreviewDescription;
    core::Animation _animationPreviewAnimation;
    std::filesystem::path _skinsDirectory;
    std::filesystem::path _catalogPath;
    std::filesystem::path _backgroundsDirectory;
    std::filesystem::path _objectsDirectory;
    std::vector<core::TileTextureOverride> _objectRows;
    SkinCatalog* _catalog = nullptr;  
    std::string _currentSet;
    std::optional<std::string> _levelBackground;
    std::optional<std::string> _levelSkinSet;
    core::CameraFramingConfig _levelCameraFraming;
    bool _updating = false;  
    const Localization* _loc = nullptr;  
    std::unordered_map<std::string, QPixmap> _thumbnails;
};
 
}  // namespace hmi