action.hpp

Go to the documentation of this file.

/*
    Copyright (C) 2008 - 2025
    by Tomasz Sniatowski <kailoran@gmail.com>
    Part of the Battle for Wesnoth Project https://www.wesnoth.org/
 
    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY.
 
    See the COPYING file for more details.
*/
 
/**
 * @file
 * Editor action classes. Some important points:
 * - This is a polymorphic hierarchy of classes, so actions are usually passed around
 *   as editor_action pointers
 * - The pointers can, in general, be null. Always check for null before doing anything.
 *   The helper functions perform_ that take a pointer do that.
 * - The perform() functions can throw when an error occurs. Use smart pointers if you
 *   need to ensure the pointer is deleted.
 */
 
#pragma once
 
#include "editor/action/action_base.hpp"
#include "editor/map/map_fragment.hpp"
 
namespace editor
{
/**
 * Replace contents of the entire map,
 * Useful as a fallback undo method when something else would be impractical
 */
class editor_action_whole_map : public editor_action
{
public:
    editor_action_whole_map(const editor_map& m)
        : m_(m)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    void perform_without_undo(map_context& m) const override;
    const std::string& get_name() const override;
 
protected:
    editor_map m_;
};
 
/**
 * Base class for actions that:
 * 1) operate on an area
 * 2) can be used as undo for a click-drag operation
 * 3) can be extended so one undo action undos several actual drag actions
 */
class editor_action_extendable : public editor_action
{
public:
    editor_action_extendable()
    {
    }
 
    /**
     * The crux of the extendable contract. This member function must be
     * implemented so that the undo behavior is consistent, exactly the
     * same as would be with separate undo actions for every part of
     * the drag.
     */
    virtual void extend(const editor_map& map, const std::set<map_location>& locs) = 0;
 
    const std::string& get_name() const override
    {
        static const std::string name("extendable");
        return name;
    }
};
 
/**
 * Container action wrapping several actions into one.
 * The actions are performed in the order they are added,
 * i.e. in the usual iteration order through the container.
 */
class editor_action_chain : public editor_action
{
public:
    /**
     * Create an empty action chain
     */
    editor_action_chain()
        : actions_()
    {
    }
 
    editor_action_chain(const editor_action_chain& other);
 
    editor_action_chain& operator=(const editor_action_chain& other);
 
    /** Inherited from editor_action, implemented by IMPLEMENT_ACTION. */
    std::unique_ptr<editor_action> clone() const override;
 
    /**
     * Create an action chain from a deque of action pointers.
     * Note: the action chain assumes ownership of the pointers.
     */
    explicit editor_action_chain(std::deque<std::unique_ptr<editor_action>> actions)
        : actions_(std::move(actions))
    {
    }
 
    /**
     * The destructor deletes all the owned action pointers
     */
    ~editor_action_chain() override = default;
 
    /**
     * Go through the chain and add up all the action counts
     */
    int action_count() const override;
 
    /**
     * Add an action at the end of the chain
     */
    void append_action(std::unique_ptr<editor_action> a);
 
    /**
     * Add an action at the beginning of the chain
     */
    void prepend_action(std::unique_ptr<editor_action> a);
 
    /**
     * @return true when there are no actions in the chain. Empty
     * action chains should usually be discarded as to not keep
     * "empty" actions around.
     */
    bool empty() const;
 
    /**
     * Remove the last added action and return it, transferring
     * ownership to the caller
     */
    std::unique_ptr<editor_action> pop_last_action();
 
    /**
     * Remove the first added action and return it, transferring
     * ownership to the caller
     */
    std::unique_ptr<editor_action> pop_first_action();
 
    /**
     * Perform all the actions in order and create a undo action chain
     */
    std::unique_ptr<editor_action> perform(map_context& m) const override;
 
    /**
     * Perform all the actions in order
     */
    void perform_without_undo(map_context& m) const override;
 
    const std::string& get_name() const override;
 
protected:
    /**
     * The action pointers owned by this action chain
     */
    std::deque<std::unique_ptr<editor_action>> actions_;
};
 
/**
 * Base class for actions which act on a specified location (and possibly on other locations
 * that can be derived from the staring hex)
 */
class editor_action_location : public editor_action
{
public:
    editor_action_location(map_location loc)
        : loc_(loc)
    {
    }
 
    const std::string& get_name() const override
    {
        static const std::string name("location");
        return name;
    }
 
protected:
    map_location loc_;
};
 
/** Base class for actions which in addition to acting on a hex,
 * act with one terrain type, i.e. paint-related actions.
 */
class editor_action_location_terrain : public editor_action_location
{
public:
    editor_action_location_terrain(map_location loc, const t_translation::terrain_code& t)
        : editor_action_location(loc)
        , t_(t)
    {
    }
 
    const std::string& get_name() const override
    {
        static const std::string name("location_terrain");
        return name;
    }
 
protected:
    t_translation::terrain_code t_;
};
 
/**
 * Base class for area-affecting actions
 */
class editor_action_area : public editor_action_extendable
{
public:
    editor_action_area(const std::set<map_location>& area)
        : area_(area)
    {
    }
 
    void extend(const editor_map& map, const std::set<map_location>& locs) override;
 
    const std::string& get_name() const override
    {
        static const std::string name("area");
        return name;
    }
 
protected:
    std::set<map_location> area_;
};
 
/**
 * Paste a map fragment into the map. No offset is used.
 */
class editor_action_paste : public editor_action_extendable
{
public:
    editor_action_paste(const map_fragment& paste, const map_location& offset = map_location::ZERO())
        : offset_(offset)
        , paste_(paste)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    std::unique_ptr<editor_action> perform(map_context& mc) const override;
    void perform_without_undo(map_context& mc) const override;
    void extend(const editor_map& map, const std::set<map_location>& locs) override;
    const std::string& get_name() const override;
 
protected:
    map_location offset_;
    map_fragment paste_;
};
 
/**
 * Paint the same terrain on a number of locations on the map.
 */
class editor_action_paint_area : public editor_action_area
{
public:
    editor_action_paint_area(
            const std::set<map_location>& area, const t_translation::terrain_code& t, bool one_layer = false)
        : editor_action_area(area)
        , t_(t)
        , one_layer_(one_layer)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    std::unique_ptr<editor_action> perform(map_context& mc) const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
protected:
    t_translation::terrain_code t_;
 
    bool one_layer_;
};
 
/**
 * Flood fill. Somewhat redundant with paint_area.
 */
class editor_action_fill : public editor_action_location_terrain
{
public:
    editor_action_fill(map_location loc, const t_translation::terrain_code& t, bool one_layer = false)
        : editor_action_location_terrain(loc, t)
        , one_layer_(one_layer)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    std::unique_ptr<editor_action> perform(map_context& mc) const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
protected:
    bool one_layer_;
};
 
/**
 * Set starting position action, sets location ids (both for starting locations
 * and for non-starting locations).
 */
class editor_action_starting_position : public editor_action_location
{
public:
    editor_action_starting_position(map_location loc, std::string loc_id)
        : editor_action_location(loc)
        , loc_id_(loc_id)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    std::unique_ptr<editor_action> perform(map_context& mc) const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
protected:
    std::string loc_id_;
};
 
/**
 * Resize the map. The offsets specify, indirectly, the direction of expanding/shrinking,
 * and fill=NONE enables copying of edge terrain instead of filling.
 */
class editor_action_resize_map : public editor_action
{
public:
    editor_action_resize_map(int x_size,
            int y_size,
            int x_offset,
            int y_offset,
            const t_translation::terrain_code& fill = t_translation::NONE_TERRAIN)
        : x_size_(x_size)
        , y_size_(y_size)
        , x_offset_(x_offset)
        , y_offset_(y_offset)
        , fill_(fill)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
protected:
    int x_size_;
    int y_size_;
    int x_offset_;
    int y_offset_;
 
    t_translation::terrain_code fill_;
};
 
class editor_action_apply_mask : public editor_action
{
public:
    editor_action_apply_mask(const gamemap& mask)
        : mask_(mask)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
private:
    gamemap mask_;
};
 
class editor_action_create_mask : public editor_action
{
public:
    editor_action_create_mask(const editor_map& target)
        : target_(target)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
private:
    editor_map target_;
};
 
/**
 * Randomize terrain in an area
 */
class editor_action_shuffle_area : public editor_action_area
{
public:
    editor_action_shuffle_area(const std::set<map_location>& area)
        : editor_action_area(area)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    std::unique_ptr<editor_action> perform(map_context& mc) const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
};
 
class editor_action_time_area_move_all: public editor_action
{
public:
    editor_action_time_area_move_all(int x_offset, int y_offset)
        : x_offset_(x_offset)
        , y_offset_(y_offset)
    {
    }
 
    std::unique_ptr<editor_action> clone() const override;
    std::unique_ptr<editor_action> perform(map_context& mc) const override;
    void perform_without_undo(map_context& mc) const override;
    const std::string& get_name() const override;
 
protected:
    int x_offset_, y_offset_;
};
 
} // end namespace editor