PixelHistory.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 Valentin Eloy
// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include <cstddef>
#include <string_view>
#include <vector>
 
#include "HMI/Editor/PixelOperations.h"

 
namespace hmi {

enum class PixelOperationKind {
    Brush,
    Eraser,
    Fill,
    // Outils de région (LOT-54 TACHE-06).
    Move,
    FlipHorizontal,
    FlipVertical,
    RotateClockwise,
    RotateCounterClockwise,
    Paste,
};

[[nodiscard]] std::string_view pixelOperationTranslationKey(PixelOperationKind kind) noexcept;

struct PixelHistoryEntry {
    PixelOperationKind kind = PixelOperationKind::Brush;
    PixelRegion region;
    std::vector<std::uint32_t> before;
    std::vector<std::uint32_t> after;
};

class PixelHistory {
public:
    explicit PixelHistory(std::size_t maxDepth = 100);

    void push(PixelOperationKind kind, PixelRegion region, std::vector<std::uint32_t> before,
              std::vector<std::uint32_t> after);

    bool undo(DecodedImage& image);

    bool redo(DecodedImage& image);

    bool jumpTo(DecodedImage& image, std::size_t index);

    [[nodiscard]] bool canUndo() const noexcept {
        return !_applied.empty();
    }

    [[nodiscard]] bool canRedo() const noexcept {
        return !_undone.empty();
    }

    [[nodiscard]] const std::vector<PixelHistoryEntry>& appliedEntries() const noexcept {
        return _applied;
    }
 
private:
    std::size_t _maxDepth;
    std::vector<PixelHistoryEntry> _applied;  
    std::vector<PixelHistoryEntry> _undone;   
};
 
}  // namespace hmi