/*
 *  File:       describe.h
 *  Summary:    Functions used to print information about various game objects.
 *  Written by: Linley Henzell
 *
 *  Modified for Crawl Reference by $Author$ on $Date$
 */

#ifndef DESCRIBE_H
#define DESCRIBE_H

#include <string>
#include "externs.h"
#include "enum.h"

// If you add any more description types, remember to also
// change item_description in externs.h
enum item_description_type
{
    IDESC_WANDS = 0,
    IDESC_POTIONS,
    IDESC_SCROLLS,                      // special field (like the others)
    IDESC_RINGS,
    IDESC_SCROLLS_II,
    IDESC_STAVES,
    NUM_IDESC
};

void append_spells(std::string &desc, const item_def &item);

// last updated 12may2000 {dlb}
/* ***********************************************************************
 * called from: chardump - spells4
 * *********************************************************************** */
bool is_dumpable_artefact( const item_def &item, bool verbose );

// last updated 12may2000 {dlb}
/* ***********************************************************************
 * called from: chardump - describe
 * *********************************************************************** */
std::string get_item_description( const item_def &item, bool verbose,
                                  bool dump = false, bool noquote = false );

// last updated 12 Jun 2008 {jpeg}
/* ***********************************************************************
 * called from: acr - religion
 * *********************************************************************** */
void describe_god( god_type which_god, bool give_title );

// last updated 12 Jun 2008 {jpeg}
/* ***********************************************************************
 * called from: directn
 * *********************************************************************** */
void describe_feature_wide(int x, int y);

// last updated 24 Dec 2008 {mpc}
/* ***********************************************************************
 * called from: luadgn
 * *********************************************************************** */
void set_feature_desc_long(const std::string &raw_name,
                           const std::string &desc);

/* ***********************************************************************
 * called from: item_use - shopping
 * *********************************************************************** */
void describe_item( item_def &item, bool allow_inscribe = false );
void inscribe_item( item_def &item, bool proper_prompt );

/* ***********************************************************************
 * called from: command
 * *********************************************************************** */
void append_weapon_stats(std::string &description, const item_def &item);
void append_armour_stats(std::string &description, const item_def &item);
void append_missile_info(std::string &description);

// last updated 12 Jun 2008 {jpeg}
/* ***********************************************************************
 * called from: command - direct
 * *********************************************************************** */
void describe_monsters(const monsters &mons);

// last updated 12 Jun 2008 {jpeg}
/* ***********************************************************************
 * called from: item_use - spl-cast
 * *********************************************************************** */
void describe_spell(spell_type spelled);

// last updated 13oct2003 {darshan}
/* ***********************************************************************
 * called from: Kills - monstuff
 * *********************************************************************** */
std::string get_ghost_description(const monsters &mons, bool concise = false);

std::string get_skill_description(int skill, bool need_title = false);

void describe_skill(int skill);

void print_description(const std::string &d, const std::string title = "",
                       const std::string suffix = "",
                       const std::string prefix = "",
                       const std::string footer = "",
                       const std::string quote  = "");

std::string randart_auto_inscription( const item_def& item );
void add_autoinscription( item_def &item, std::string ainscrip);

const char *trap_name(trap_type trap);
int str_to_trap(const std::string &s);

extern const char* god_gain_power_messages[NUM_GODS][MAX_GOD_ABILITIES];

#endif