AssetThumbnailView.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <QPixmap>
#include <QWidget>
#include <filesystem>
#include <functional>
#include <memory>
#include <string>
#include <unordered_map>
#include <vector>
 
#include "HMI/Graphics/AssetContract.h"

 
class QEvent;
class QListWidgetItem;
 
namespace Ui {
class AssetThumbnailView;
}
 
namespace hmi {
 
class Localization;

class AssetThumbnailView : public QWidget {
    Q_OBJECT
 
public:
    using ReferenceChecker = std::function<std::vector<std::string>(const std::string&)>;
 
    explicit AssetThumbnailView(QWidget* parent = nullptr);
    ~AssetThumbnailView() override;

    void setDirectory(std::filesystem::path directory);

    void setAssetFamily(AssetFamily family) noexcept {
        _family = family;
    }

    void setReferenceChecker(ReferenceChecker checker) {
        _referenceChecker = std::move(checker);
    }

    void setNoneOptionVisible(bool visible);

    void refresh();

    void clearCache();

    void selectAsset(const std::string& fileName);

    [[nodiscard]] std::string selectedAsset() const;

    void retranslateUi(const Localization& loc);
 
protected:
    bool event(QEvent* event) override;
 
signals:
    void assetSelected(const QString& fileName);
    void assetActivated(const QString& fileName);
    void assetsChanged();
 
private:
    void rebuildItems();
    [[nodiscard]] QPixmap thumbnailFor(const std::string& fileName);
    void onFilterChanged(const QString& text);
    void onCurrentItemChanged(QListWidgetItem* current, QListWidgetItem* previous);
    void onItemActivated(QListWidgetItem* item);
    void onImport();
    void onRename();
    void onDuplicate();
    void onDelete();

    [[nodiscard]] QString referencesWarning(const std::string& fileName) const;
 
    std::unique_ptr<Ui::AssetThumbnailView> _ui;
    std::filesystem::path _directory;
    AssetFamily _family = AssetFamily::TileSkin;
    ReferenceChecker _referenceChecker;
    std::string _filterText;
    bool _noneOptionVisible = true;
    std::unordered_map<std::string, QPixmap> _thumbnails;
    const Localization* _loc = nullptr;
};
 
}  // namespace hmi