minimap.cpp

Go to the documentation of this file.

/*
   Copyright (C) 2008 - 2016 by Mark de Wever <[email protected]>
   Part of the Battle for Wesnoth Project http://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.
*/

#define GETTEXT_DOMAIN "wesnoth-lib"

#include "gui/widgets/minimap.hpp"

#include "gui/core/log.hpp"
#include "gui/core/widget_definition.hpp"
#include "gui/core/window_builder.hpp"
#include "gui/core/register_widget.hpp"
#include "gui/widgets/settings.hpp"
#include "map/map.hpp"
#include "map/exception.hpp"
#include "terrain/type_data.hpp"
#include "../../minimap.hpp" // We want the file in src/

#include "utils/functional.hpp"
#include <boost/make_shared.hpp>

#include <algorithm>

static lg::log_domain log_config("config");
#define ERR_CF LOG_STREAM_INDENT(err, log_config)

#define LOG_SCOPE_HEADER get_control_type() + " [" + id() + "] " + __func__
#define LOG_HEADER LOG_SCOPE_HEADER + ':'

// Define this to enable debug output for the minimap cache.
//#define DEBUG_MINIMAP_CACHE

namespace gui2
{

// ------------ WIDGET -----------{

REGISTER_WIDGET(minimap)

void tminimap::set_active(const bool /*active*/)
{
    /* DO NOTHING */
}

bool tminimap::get_active() const
{
    return true;
}

unsigned tminimap::get_state() const
{
    return 0;
}

/** Key type for the cache. */
struct tkey
{
    tkey(const int w, const int h, const std::string& map_data)
        : w(w), h(h), map_data(map_data)
    {
    }

    /** Width of the image. */
    const int w;

    /** Height of the image. */
    const int h;

    /** The data used to generate the image. */
    const std::string map_data;
};

static bool operator<(const tkey& lhs, const tkey& rhs)
{
    return lhs.w < rhs.w
           || (lhs.w == rhs.w
               && (lhs.h < rhs.h
                   || (lhs.h == rhs.h && lhs.map_data < rhs.map_data)));
}

/** Value type for the cache. */
struct tvalue
{
    tvalue(const surface& surf) : surf(surf), age(1)
    {
    }

    /** The cached image. */
    const surface surf;

    /**
     * The age of the image.
     *
     * Every time an image is used its age is increased by one. Once the cache
     * is full 25% of the cache is emptied. This is done by halving the age of
     * the items in the cache and then erase the 25% with the lowest age. If
     * items have the same age their order is unspecified.
     */
    unsigned age;
};

#ifdef LOW_MEM
/**
 * Maximum number of items in the cache (multiple of 4).
 *
 * As small as possible for low mem.
 */
static const size_t cache_max_size = 4;
#else
/**
 * Maximum number of items in the cache (multiple of 4).
 *
 * No testing on the optimal number is done, just seems a nice number.
 */
static const size_t cache_max_size = 100;
#endif

/**
 * The terrain used to create the cache.
 *
 * If another terrain config is used the cache needs to be cleared, this
 * normally doesn't happen a lot so the clearing of the cache is rather
 * unusual.
 */
static const ::config* terrain = nullptr;

/** The cache. */
typedef std::map<tkey, tvalue> tcache;
static tcache cache;

static bool compare(const std::pair<unsigned, tcache::iterator>& lhs,
                    const std::pair<unsigned, tcache::iterator>& rhs)
{
    return lhs.first < rhs.first;
}

static void shrink_cache()
{
#ifdef DEBUG_MINIMAP_CACHE
    std::cerr << "\nShrink cache from " << cache.size();
#else
    DBG_GUI_D << "Shrinking the minimap cache.\n";
#endif

    std::vector<std::pair<unsigned, tcache::iterator> > items;
    for(tcache::iterator itor = cache.begin(); itor != cache.end(); ++itor) {

        itor->second.age /= 2;
        items.push_back(std::make_pair(itor->second.age, itor));
    }

    std::partial_sort(items.begin(),
                      items.begin() + cache_max_size / 4,
                      items.end(),
                      compare);

    for(std::vector<std::pair<unsigned, tcache::iterator> >::iterator vitor
        = items.begin();
        vitor < items.begin() + cache_max_size / 4;
        ++vitor) {

        cache.erase(vitor->second);
    }

#ifdef DEBUG_MINIMAP_CACHE
    std::cerr << " to " << cache.size() << ".\n";
#endif
}

bool tminimap::disable_click_dismiss() const
{
    return false;
}

const surface tminimap::get_image(const int w, const int h) const
{
    if(!terrain_) {
        return nullptr;
    }

    if(terrain_ != terrain) {
#ifdef DEBUG_MINIMAP_CACHE
        std::cerr << "\nFlush cache.\n";
#else
        DBG_GUI_D << "Flushing the minimap cache.\n";
#endif
        terrain = terrain_;
        cache.clear();
    }

    const tkey key(w, h, map_data_);
    tcache::iterator itor = cache.find(key);

    if(itor != cache.end()) {
#ifdef DEBUG_MINIMAP_CACHE
        std::cerr << '+';
#endif
        itor->second.age++;
        return itor->second.surf;
    }

    if(cache.size() >= cache_max_size) {
        shrink_cache();
    }

    try
    {
        const gamemap map(boost::make_shared<terrain_type_data>(*terrain_), map_data_);
        const surface surf = image::getMinimap(w, h, map, nullptr);
        cache.insert(std::make_pair(key, tvalue(surf)));
#ifdef DEBUG_MINIMAP_CACHE
        std::cerr << '-';
#endif
        return surf;
    }
    catch(incorrect_map_format_error& e)
    {
        ERR_CF << "Error while loading the map: " << e.message << '\n';
#ifdef DEBUG_MINIMAP_CACHE
        std::cerr << 'X';
#endif
    }
    return nullptr;
}

void tminimap::impl_draw_background(surface& frame_buffer,
                                    int x_offset,
                                    int y_offset)
{
    if(!terrain_)
        return;
    assert(terrain_);

    DBG_GUI_D << LOG_HEADER << " size "
              << calculate_blitting_rectangle(x_offset, y_offset) << ".\n";

    if(map_data_.empty()) {
        return;
    }

    SDL_Rect rect = calculate_blitting_rectangle(x_offset, y_offset);
    assert(rect.w > 0 && rect.h > 0);

    const ::surface surf = get_image(rect.w, rect.h);
    if(surf) {
        sdl_blit(surf, nullptr, frame_buffer, &rect);
    }
}

const std::string& tminimap::get_control_type() const
{
    static const std::string type = "minimap";
    return type;
}

// }---------- DEFINITION ---------{

tminimap_definition::tminimap_definition(const config& cfg)
    : tcontrol_definition(cfg)
{
    DBG_GUI_P << "Parsing minimap " << id << '\n';

    load_resolutions<tresolution>(cfg);
}

/*WIKI
 * @page = GUIWidgetDefinitionWML
 * @order = 1_minimap
 *
 * == Minimap ==
 *
 * @macro = minimap_description
 *
 * The following states exist:
 * * state_enabled, the minimap is enabled.
 * @begin{parent}{name="gui/"}
 * @begin{tag}{name="minimap_definition"}{min=0}{max=-1}{super="generic/widget_definition"}
 * @begin{tag}{name="resolution"}{min=0}{max=-1}{super="generic/widget_definition/resolution"}
 * @begin{tag}{name="state_enabled"}{min=0}{max=1}{super="generic/state"}
 * @end{tag}{name="state_enabled"}
 * @end{tag}{name="resolution"}
 * @end{tag}{name="minimap_definition"}
 * @end{parent}{name="gui/"}
 */
tminimap_definition::tresolution::tresolution(const config& cfg)
    : tresolution_definition_(cfg)
{
    // Note the order should be the same as the enum tstate in minimap.hpp.
    state.push_back(tstate_definition(cfg.child("state_enabled")));
}

// }---------- BUILDER -----------{

/*WIKI_MACRO
 * @begin{macro}{minimap_description}
 *
 *        A minimap to show the gamemap, this only shows the map and has no
 *        interaction options. This version is used for map previews, there
 *        will be a another version which allows interaction.
 * @end{macro}
 */

/*WIKI
 * @page = GUIWidgetInstanceWML
 * @order = 2_minimap
 *
 * == Minimap ==
 *
 * @macro = minimap_description
 *
 * A minimap has no extra fields.
 * @begin{parent}{name="gui/window/resolution/grid/row/column/"}
 * @begin{tag}{name="minimap"}{min=0}{max=-1}{super="generic/widget_instance"}
 * @end{tag}{name="minimap"}
 * @end{parent}{name="gui/window/resolution/grid/row/column/"}
 */

namespace implementation
{

tbuilder_minimap::tbuilder_minimap(const config& cfg) : tbuilder_control(cfg)
{
}

twidget* tbuilder_minimap::build() const
{
    tminimap* widget = new tminimap();

    init_control(widget);

    DBG_GUI_G << "Window builder: placed minimap '" << id
              << "' with definition '" << definition << "'.\n";

    return widget;
}

} // namespace implementation

// }------------ END --------------

} // namespace gui2