16 #define GETTEXT_DOMAIN "wesnoth-help"
41 #define WRN_HP LOG_STREAM(warn, log_help)
42 #define DBG_HP LOG_STREAM(debug, log_help)
63 std::string lang_policy = (best ?
_(
"Best of") :
_(
"Worst of"));
64 std::string color_policy = (best ?
"green":
"red");
70 std::stringstream str_unformatted;
71 const bool cannot = cost < max_cost;
78 if (cannot && max_cost > cost + 5) {
81 str_unformatted <<
"(" << max_cost <<
")";
83 str_unformatted << max_cost;
86 const int hexes_per_turn = cost / max_cost;
87 str_unformatted <<
" ";
88 for(
int i = 0;
i < hexes_per_turn; ++
i) {
90 str_unformatted <<
"\u2b23\u200b";
97 typedef t_translation::ter_list::const_iterator
ter_iter;
102 if (
start == end)
return "";
105 utils::optional<ter_iter> last_change_pos;
107 bool best = begin_best;
115 std::stringstream ss;
117 if (!last_change_pos) {
118 std::vector<std::string>
names;
122 names.push_back(
_(
"base terrain"));
130 if (
names.empty())
return "";
134 if (!first_level) ss <<
"( ";
137 for (std::size_t
i = 1;
i <
names.size();
i++) {
138 ss <<
", " <<
names.at(
i);
141 if (!first_level) ss <<
" )";
143 std::vector<std::string>
names;
144 for (
ter_iter i = *last_change_pos+1;
i != end; ++
i) {
155 if (!first_level) ss <<
"( ";
158 for (
const std::string &
s :
names) {
161 if (!first_level) ss <<
" )";
167 std::stringstream ss;
171 <<
"images/buttons/icon-base-32.png~RC(magenta>" <<
type_.
id()
188 WRN_HP <<
"When building terrain help topics, we couldn't acquire any terrain types data";
194 std::vector<std::string> special_notes;
197 special_notes.push_back(
_(
"Villages allow any unit stationed therein to heal, or to be cured of poison."));
202 auto message =
VNGETTEXT(
"This terrain allows units to be cured of poison, or to heal a single hitpoint.",
203 "This terrain allows units to heal $amount hitpoints, or to be cured of poison, as if stationed in a village.",
205 special_notes.push_back(std::move(message));
209 special_notes.push_back(
_(
"This terrain is a castle — units can be recruited onto it from a connected keep."));
213 special_notes.push_back(
_(
"This terrain is a keep — a leader can recruit from this hex onto connected castle hexes."));
216 special_notes.push_back(
_(
"This unusual keep allows a leader to recruit while standing on it, but does not allow a leader on a connected keep to recruit onto this hex."));
219 if(!special_notes.empty()) {
220 ss <<
"\n\n" <<
markup::tag(
"header",
_(
"Special Notes")) <<
"\n\n";
221 for(
const auto& note : special_notes) {
229 std::vector<t_string> underlying;
231 const terrain_type& base = tdata->get_terrain_info(underlying_terrain);
241 ss <<
"\n" <<
VNGETTEXT(
"Basic terrain type: $types",
"Basic terrain types: $types", underlying.size(), symbols);
253 ss <<
"\n" <<
VGETTEXT(
"Typical base terrain: $type", symbols);
259 ss <<
"\n" <<
_(
"Movement properties: ");
263 ss <<
"\n" <<
_(
"Defense properties: ");
270 ss <<
"ID: " <<
type_.
id() <<
"\n";
275 ss <<
"Keep: " << (
type_.
is_keep() ?
"Yes" :
"No") <<
"\n";
282 ss <<
"Terrain string: " <<
type_.
number() <<
"\n";
292 ss <<
"\nEditor Image: Empty\n";
298 ss <<
"\nDebug Mvt Description String:";
304 ss <<
"\nDebug Def Description String:";
325 for(
i++;
i < l.size();
i++) {
334 std::stringstream ss;
344 const std::string &male_portrait = male_type.
small_profile().empty() ?
346 const std::string &female_portrait = female_type.
small_profile().empty() ?
349 const bool has_male_portrait = !male_portrait.empty() && male_portrait != male_type.
image() && male_portrait !=
"unit_image";
350 const bool has_female_portrait = !female_portrait.empty() && female_portrait != male_portrait && female_portrait != female_type.
image() && female_portrait !=
"unit_image";
353 if (has_male_portrait) {
354 ss <<
markup::img(male_portrait +
"~FL(horiz)",
"right",
true);
357 if (has_female_portrait) {
358 ss <<
markup::img(female_portrait +
"~FL(horiz)",
"right",
true);
363 << male_type.
image() <<
"~RC(" << male_type.
flag_rgb() <<
">red)"
364 << (
screen_width >= 1200 ?
"~SCALE_SHARP(200%,200%)" :
""));
366 if (female_type.
image() != male_type.
image()) {
368 << female_type.
image() <<
"~RC(" << female_type.
flag_rgb() <<
">red)"
369 << (
screen_width >= 1200 ?
"~SCALE_SHARP(200%,200%)" :
""));
376 const bool first_reverse_value =
true;
377 bool reverse = first_reverse_value;
380 std::vector<std::string> adv_units =
384 for (
const std::string &adv : adv_units) {
392 ss <<
_(
"Advances from: ");
394 ss <<
_(
"Advances to: ");
401 std::string lang_unit =
type->type_name();
404 const std::string section_prefix =
type->show_variations_in_help() ?
".." :
"";
417 }
while(
reverse != first_reverse_value);
428 ss <<
_(
"Base units: ");
438 for (
const std::string &var_id : parent->
variations()) {
441 if(
type.hide_help()) {
446 ss <<
_(
"Variations: ");
454 std::string var_name =
type.variation_name();
468 if (race_name.empty()) {
469 race_name =
_ (
"race^Miscellaneous");
478 std::vector<trait_data> must_have_traits;
479 std::vector<trait_data> random_traits;
480 int must_have_nameless_traits = 0;
482 for(
const config& trait : traits) {
483 const std::string& male_name = trait[
"male_name"].str();
484 const std::string& female_name = trait[
"female_name"].str();
485 std::string trait_name;
487 trait_name = male_name;
489 trait_name = female_name;
490 else if (! trait[
"name"].str().empty())
491 trait_name = trait[
"name"].str();
496 if (lang_trait_name.empty() && trait[
"availability"].str() ==
"musthave") {
497 ++must_have_nameless_traits;
500 const std::string ref_id =
"traits_"+trait[
"id"].str();
501 ((trait[
"availability"].str() ==
"musthave") ? must_have_traits : random_traits).emplace_back(lang_trait_name, ref_id);
504 bool line1 = !must_have_traits.empty();
505 bool line2 = !random_traits.empty() &&
type_.
num_traits() > must_have_traits.size();
508 std::string traits_label =
_(
"Traits");
511 std::stringstream must_have_count;
512 must_have_count <<
"\n (" << must_have_traits.size() <<
") : ";
513 std::stringstream random_count;
514 random_count <<
" (" << (
type_.
num_traits() - must_have_traits.size() - must_have_nameless_traits) <<
") : ";
515 ss << must_have_count.str();
517 ss <<
"\n" << random_count.str();
526 ss <<
_(
"Traits") <<
" (" << (
type_.
num_traits() - must_have_nameless_traits) <<
") : ";
536 ss <<
_(
"Abilities: ");
541 const std::string ref_id =
ability_prefix + iter->id + iter->name.base_str();
543 if(iter->name.empty()) {
562 ss <<
_(
"Ability Upgrades: ");
567 const std::string ref_id =
ability_prefix + iter->id + iter->name.base_str();
569 if(iter->name.empty()) {
627 ss <<
"\n" << detailed_description;
630 ss <<
"\n" <<
markup::tag(
"header",
_(
"Special Notes")) <<
"\n";
631 for(
const auto& note : notes) {
636 std::stringstream table_ss;
655 std::stringstream attack_ss;
657 std::string lang_weapon = attack.name();
658 std::string lang_type =
string_table[
"type_" + attack.type()];
669 " ", attack.accuracy_parry_description());
672 const std::string range_icon =
"icons/profiles/" + attack.range() +
"_attack.png~SCALE_INTO(16,16)";
673 if (attack.min_range() > 1 || attack.max_range() > 1) {
676 attack.min_range(),
"-", attack.max_range(),
' ',
685 const std::string type_icon =
"icons/profiles/" + attack.type() +
".png~SCALE_INTO(16,16)";
689 std::vector<std::pair<t_string, t_string>> specials = attack.special_tooltips();
690 if (!specials.empty()) {
691 std::stringstream specials_ss;
692 std::string lang_special =
"";
693 const std::size_t specials_size = specials.size();
694 for (std::size_t
i = 0;
i != specials_size; ++
i) {
695 const std::string ref_id = std::string(
"weaponspecial_")
696 + specials[
i].first.base_str();
697 lang_special = (specials[
i].first);
699 if (
i+1 != specials_size) {
703 attack_ss <<
markup::tag(
"col", specials_ss.str());
720 for (
const config &
t : traits) {
721 if (
t[
"availability"].str() ==
"musthave") {
722 for (
const config & effect :
t.child_range(
"effect")) {
723 if (!effect.has_child(
"filter")
725 movement_type.
merge(effect, effect[
"replace"].to_bool());
741 std::stringstream().swap(table_ss);
747 for(std::pair<std::string, std::string> dam_it : dam_tab) {
748 int resistance = 100;
751 }
catch(std::invalid_argument&) {}
752 std::string resist = std::to_string(resistance) +
'%';
753 const std::size_t pos = resist.find(
'-');
754 if (pos != std::string::npos) {
758 const std::string lang_type =
string_table[
"type_" + dam_it.first];
759 const std::string type_icon =
"icons/profiles/" + dam_it.first +
".png~SCALE_INTO(16,16)";
769 std::stringstream().swap(table_ss);
772 ss <<
"\n" <<
markup::tag(
"header",
_(
"Terrain Modifiers"));
775 std::stringstream row_ss;
785 std::set<terrain_movement_info> terrain_moves;
793 if (cannot_move &&
info.hide_if_impassable()) {
797 if (
info.is_indivisible() &&
info.is_nonnull()) {
809 terrain_moves.insert(movement_info);
816 std::stringstream().swap(row_ss);
817 bool high_res =
false;
818 const std::string tc_base = high_res ?
"images/buttons/icon-base-32.png" :
"images/buttons/icon-base-16.png";
819 const std::string terrain_image =
"icons/terrain/terrain_type_" + m.id + (high_res ?
"_30.png" :
".png");
820 const std::string final_image = tc_base +
"~RC(magenta>" + m.id +
")~BLIT(" + terrain_image +
")";
833 if (has_terrain_defense_caps) {
859 WRN_HP <<
"When building unit help topics, we couldn't get the terrain info we need.";
std::vector< std::string > names
A config object defines a single node in a WML file, with access to child nodes.
boost::iterator_range< const_child_iterator > const_child_itors
const terrain_type & type_
virtual std::string operator()() const
virtual std::string operator()() const
const std::string variation_
bool capped(const t_translation::terrain_code &terrain) const
Returns whether there is a defense cap associated to this terrain.
The basic "size" of the unit - flying, small land, large land, etc.
static const std::set< std::string > effects
The set of applicable effects for movement types.
void merge(const config &new_cfg, bool overwrite=true)
Merges the given config over the existing data, the config should have zero or more children named "m...
bool has_vision_data() const
Returns whether or not there are any vision-specific costs.
bool has_jamming_data() const
Returns whether or not there are any jamming-specific costs.
bool has_terrain_defense_caps(const std::set< t_translation::terrain_code > &ts) const
Returns whether or not there are any terrain caps with respect to a set of terrains.
int defense_modifier(const t_translation::terrain_code &terrain) const
Returns the defensive value of the indicated terrain.
int jamming_cost(const t_translation::terrain_code &terrain, bool slowed=false) const
Returns the cost to "jam" through the indicated terrain.
int vision_cost(const t_translation::terrain_code &terrain, bool slowed=false) const
Returns the cost to see through the indicated terrain.
int movement_cost(const t_translation::terrain_code &terrain, bool slowed=false) const
Returns the cost to move through the indicated terrain.
utils::string_map_res damage_table() const
Returns a map from damage types to resistances.
terrain_defense & get_defense()
const std::string & str() const
const std::string & editor_group() const
bool has_default_base() const
const std::string & icon_image() const
const t_string & income_description() const
bool is_combined() const
True for instances created by the terrain_code(base, overlay) constructor.
const std::string & editor_image() const
bool is_nonnull() const
True if this object represents some sentinel values.
const std::string & id() const
const t_string & help_topic_text() const
const t_translation::ter_list & def_type() const
const t_translation::ter_list & mvt_type() const
The underlying type of the terrain.
int light_bonus(int base) const
Returns the light (lawful) bonus for this terrain when the time of day gives a base bonus.
const t_translation::ter_list & union_type() const
static bool is_indivisible(t_translation::terrain_code id, const t_translation::ter_list &underlying)
Returns true if a terrain has no underlying types other than itself, in respect of either union,...
const t_string & editor_name() const
int gives_healing() const
t_translation::terrain_code default_base() const
Overlay terrains defined by a [terrain_type] can declare a fallback base terrain, for use when the ov...
bool hide_in_editor() const
t_translation::terrain_code number() const
const t_string & plural_name() const
const unit_type * find(const std::string &key, unit_type::BUILD_STATUS status=unit_type::FULL) const
Finds a unit_type by its id() and makes sure it is built to the specified level.
void build_unit_type(const unit_type &ut, unit_type::BUILD_STATUS status) const
Makes sure the provided unit_type is built to the specified level.
A single unit type that the player may recruit.
const std::vector< std::string > advances_from() const
A vector of unit_type ids that can advance to this unit_type.
std::string race_id() const
Returns the ID of this type's race without the need to build the type.
static std::string alignment_description(unit_alignments::type align, unit_race::GENDER gender=unit_race::MALE)
Implementation detail of unit_type::alignment_description.
const unit_type & get_gender_unit_type(const std::string &gender) const
Returns a gendered variant of this unit_type.
const std::string & image() const
const std::string & id() const
The id for this unit_type.
const std::vector< ability_metadata > & adv_abilities_metadata() const
Some extra abilities that may be gained through AMLA advancements.
const movetype & movement_type() const
bool show_variations_in_help() const
Whether the unit type has at least one help-visible variation.
const unit_race * race() const
Never returns nullptr, but may point to the null race.
const unit_type & get_variation(const std::string &id) const
const_attack_itors attacks() const
const std::vector< std::string > & advances_to() const
A vector of unit_type ids that this unit_type can advance to.
bool has_gender_variation(const unit_race::GENDER gender) const
t_string unit_description() const
const std::vector< unit_race::GENDER > & genders() const
The returned vector will not be empty, provided this has been built to the HELP_INDEXED status.
std::vector< std::string > variations() const
const std::string & flag_rgb() const
std::vector< t_string > special_notes() const
Returns all notes that should be displayed in the help page for this type, including those found in a...
config::const_child_itors modification_advancements() const
Returns two iterators pointing to a range of AMLA configs.
int experience_needed(bool with_acceleration=true) const
const std::string & big_profile() const
const t_string & type_name() const
The name of the unit in the current language setting.
config::const_child_itors possible_traits() const
unit_alignments::type alignment() const
const std::string & small_profile() const
const std::vector< ability_metadata > & abilities_metadata() const
const config & get_cfg() const
unsigned int num_traits() const
static std::string _(const char *str)
static lg::log_domain log_help("help")
symbol_table string_table
Standard logging facilities (interface).
EXIT_STATUS start(bool clear_id, const std::string &filename, bool take_screenshot, const std::string &screenshot_filename)
Main interface for launching the editor from the title screen.
const std::string unicode_bullet
const std::string unicode_figure_dash
const std::string weapon_numbers_sep
const std::string unicode_minus
color_t red_to_green(double val, bool for_text)
Return a color corresponding to the value val red for val=0.0 to green for val=100....
unsigned screen_width
The screen resolution and pixel pitch should be available for all widgets since their drawing method ...
t_translation::ter_list::const_iterator ter_iter
const std::string unit_prefix
const std::string variation_prefix
UNIT_DESCRIPTION_TYPE description_type(const unit_type &type)
Return the type of description that should be shown for a unit of the given kind.
const std::string ability_prefix
static std::string print_behavior_description(const ter_iter &start, const ter_iter &end, const std::shared_ptr< terrain_type_data > &tdata, bool first_level=true, bool begin_best=true)
std::pair< std::string, std::string > trait_data
const std::string terrain_prefix
const std::string unknown_unit_topic
std::shared_ptr< terrain_type_data > load_terrain_types_data()
Load the appropriate terrain types data to use.
static std::string format_mp_entry(const int cost, const int max_cost)
static std::string best_str(bool best)
static void print_trait_list(std::stringstream &ss, const std::vector< trait_data > &l)
std::string italic(Args &&... data)
static const std::string br
std::string make_link(const std::string &text, const std::string &dst)
std::string img(const std::string &src, const std::string &align, const bool floating)
std::string tag(const std::string &tag_name, Args &&... contents)
std::string bold(Args &&... data)
std::string span_color(const color_t &color, Args &&... data)
const terrain_code VOID_TERRAIN
VOID_TERRAIN is used for shrouded hexes.
bool terrain_matches(const terrain_code &src, const terrain_code &dest)
Tests whether a specific terrain matches an expression, for matching rules see above.
std::vector< terrain_code > ter_list
const ter_match ALL_OFF_MAP
const terrain_code FOGGED
static std::string gettext(const char *str)
int icompare(const std::string &s1, const std::string &s2)
Case-insensitive lexicographical comparison.
std::string resistance_color(const int resistance)
Maps resistance <= -60 (resistance value <= -60%) to intense red.
int stoi(std::string_view str)
Same interface as std::stoi and meant as a drop in replacement, except:
std::map< std::string, t_string, res_compare > string_map_res
std::string format_conjunct_list(const t_string &empty, const std::vector< t_string > &elems)
Format a conjunctive list.
std::map< std::string, t_string > string_map
std::vector< std::string > split(const config_attribute_value &val)
point game_canvas_size()
The size of the game canvas, in drawing coordinates / game pixels.
The basic class for representing 8-bit RGB or RGBA colour values.
bool operator<(const terrain_movement_info &other) const
A terrain string which is converted to a terrain is a string with 1 or 2 layers the layers are separa...
static map_location::direction s
unit_type_data unit_types