attack_type.hpp

Go to the documentation of this file.

/*
   Copyright (C) 2003 - 2018 by David White <dave@whitevine.net>
   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.
*/

#pragma once

#include "map/location.hpp"
#include "tstring.hpp"
#include "config.hpp"
#include <string>
#include <vector>
#include <cassert>

#include <boost/iterator/indirect_iterator.hpp>
#include <boost/range/iterator_range.hpp>
#include <boost/dynamic_bitset_fwd.hpp>

#include "units/ptr.hpp" // for attack_ptr

class unit_ability_list;
class unit_type;
namespace wfl {
    class map_formula_callable;
}
//the 'attack type' is the type of attack, how many times it strikes,
//and how much damage it does.
class attack_type : public std::enable_shared_from_this<attack_type>
{
public:

    explicit attack_type(const config& cfg);
    const t_string& name() const { return description_; }
    const std::string& id() const { return id_; }
    const std::string& type() const { return type_; }
    const std::string& icon() const { return icon_; }
    const std::string& range() const { return range_; }
    int min_range() const { return min_range_; }
    int max_range() const { return max_range_; }
    std::string accuracy_parry_description() const;
    int accuracy() const { return accuracy_; }
    int parry() const { return parry_; }
    int damage() const { return damage_; }
    int num_attacks() const { return num_attacks_; }
    double attack_weight() const { return attack_weight_; }
    double defense_weight() const { return defense_weight_; }
    const config &specials() const { return specials_; }

    void set_name(const t_string& value) { description_  = value; set_changed(true); }
    void set_id(const std::string& value) { id_ = value; set_changed(true); }
    void set_type(const std::string& value) { type_ = value; set_changed(true); }
    void set_icon(const std::string& value) { icon_ = value; set_changed(true); }
    void set_range(const std::string& value) { range_ = value; set_changed(true); }
    void set_accuracy(int value) { accuracy_ = value; set_changed(true); }
    void set_parry(int value) { parry_ = value; set_changed(true); }
    void set_damage(int value) { damage_ = value; set_changed(true); }
    void set_num_attacks(int value) { num_attacks_ = value; set_changed(true); }
    void set_attack_weight(double value) { attack_weight_ = value; set_changed(true); }
    void set_defense_weight(double value) { defense_weight_ = value; set_changed(true); }
    void set_specials(config value) { specials_ = value; set_changed(true); }


    // In unit_abilities.cpp:

    /**
     * @return True iff the special @a special is active.
     * @param special The special being checked.
     * @param simple_check If true, check whether the unit has the special. Else, check whether the special is currently active.
     * @param special_id If true, match @a special against the @c id of special tags.
     * @param special_tags If true, match @a special against the tag name of special tags.
     */
    bool get_special_bool(const std::string& special, bool simple_check=false, bool special_id=true, bool special_tags=true) const;
    unit_ability_list get_specials(const std::string& special) const;
    std::vector<std::pair<t_string, t_string>> special_tooltips(boost::dynamic_bitset<>* active_list = nullptr) const;
    std::string weapon_specials(bool only_active=false, bool is_backstab=false) const;

    /** Calculates the number of attacks this weapon has, considering specials. */
    void modified_attacks(bool is_backstab, unsigned & min_attacks,
                          unsigned & max_attacks) const;
    /** Returns the damage per attack of this weapon, considering specials. */
    int modified_damage(bool is_backstab) const;
    /** Returns list for weapon like abilitiesfor each ability type. */
    unit_ability_list list_ability(const std::string& ability) const;
    /** Returns list who contains list_ability and get_specials list for each ability type */
    unit_ability_list get_special_ability(const std::string& ability) const;
    /** return an boolean value for abilities like poison slow firstrike or petrifies */
    bool bool_ability(const std::string& ability) const;

    // In unit_types.cpp:

    bool matches_filter(const config& filter) const;
    bool apply_modification(const config& cfg);
    bool describe_modification(const config& cfg,std::string* description);

    int movement_used() const { return movement_used_; }
    void set_movement_used(int value) { movement_used_ = value; }

    void write(config& cfg) const;
    inline config to_config() const { config c; write(c); return c; }

    void add_formula_context(wfl::map_formula_callable&) const;
private:
    // In unit_abilities.cpp:

    // Configured as a bit field, in case that is useful.
    enum AFFECTS { AFFECT_SELF=1, AFFECT_OTHER=2, AFFECT_EITHER=3 };
    bool special_active(const config& special, AFFECTS whom, const std::string& tag_name,
                        bool include_backstab=true, const std::string& filter_self ="filter_self") const;

    static bool special_active_impl(
        const_attack_ptr self_attack,
        const_attack_ptr other_attack,
        const config& special,
        AFFECTS whom,
        const std::string& tag_name,
        bool include_backstab=true,
        const std::string& filter_self ="filter_self"
    );

    // Used via specials_context() to control which specials are
    // considered active.
    friend class specials_context_t;
    mutable map_location self_loc_, other_loc_;
    mutable unit_const_ptr self_;
    mutable unit_const_ptr other_;
    mutable bool is_attacker_;
    mutable const_attack_ptr other_attack_;
    mutable bool is_for_listing_ = false;
public:
    class specials_context_t {
        std::shared_ptr<const attack_type> parent;
        friend class attack_type;
        /** Initialize weapon specials context for listing */
        explicit specials_context_t(const attack_type& weapon, bool attacking);
        /** Initialize weapon specials context for a unit type */
        specials_context_t(const attack_type& weapon, const unit_type& self_type, const map_location& loc, bool attacking = true);
        /** Initialize weapon specials context for a single unit */
        specials_context_t(const attack_type& weapon, const_attack_ptr other_weapon,
            unit_const_ptr self, unit_const_ptr other,
            const map_location& self_loc, const map_location& other_loc,
            bool attacking);
        /** Initialize weapon specials context for a pair of units */
        specials_context_t(const attack_type& weapon, unit_const_ptr self, const map_location& loc, bool attacking);
        specials_context_t(const specials_context_t&) = delete;
        bool was_moved = false;
    public:
        // Destructor at least needs to be public for all this to work.
        ~specials_context_t();
        specials_context_t(specials_context_t&&);
    };
    // Set up a specials context.
    // Usage: auto ctx = weapon.specials_context(...);
    specials_context_t specials_context(unit_const_ptr self, unit_const_ptr other,
        const map_location& unit_loc, const map_location& other_loc,
        bool attacking, const_attack_ptr other_attack) const {
        return specials_context_t(*this, other_attack, self, other, unit_loc, other_loc, attacking);
    }
    specials_context_t specials_context(unit_const_ptr self, const map_location& loc, bool attacking = true) const {
        return specials_context_t(*this, self, loc, attacking);
    }
    specials_context_t specials_context(const unit_type& self_type, const map_location& loc, bool attacking = true) const {
        return specials_context_t(*this, self_type, loc, attacking);
    }
    specials_context_t specials_context_for_listing(bool attacking = true) const {
        return specials_context_t(*this, attacking);
    }
    void set_changed(bool value)
    {
        changed_ = value;
    }
    bool get_changed() const
    {
        return changed_;
    }
private:

    t_string description_;
    std::string id_;
    std::string type_;
    std::string icon_;
    std::string range_;
    int min_range_, max_range_;
    int damage_;
    int num_attacks_;
    double attack_weight_;
    double defense_weight_;

    int accuracy_;
    int movement_used_;
    int parry_;
    config specials_;
    bool changed_;
};

using attack_list = std::vector<attack_ptr>;
using attack_itors = boost::iterator_range<boost::indirect_iterator<attack_list::iterator>>;
using const_attack_itors = boost::iterator_range<boost::indirect_iterator<attack_list::const_iterator>>;

inline attack_itors make_attack_itors(attack_list& atks) {
    return boost::make_iterator_range(boost::make_indirect_iterator(atks.begin()), boost::make_indirect_iterator(atks.end()));
}

inline const_attack_itors make_attack_itors(const attack_list& atks) {
    return boost::make_iterator_range(boost::make_indirect_iterator(atks.begin()), boost::make_indirect_iterator(atks.end()));
}