editor/palette/editor_palettes.hpp

Go to the documentation of this file.

/* $Id: editor_palettes.hpp 53695 2012-03-30 15:42:21Z fendrin $ */
/*
   Copyright (C) 2003 - 2012 by David White <dave@whitevine.net>
   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.
*/

#ifndef EDITOR_PALETTES_H_INCLUDED
#define EDITOR_PALETTES_H_INCLUDED

#include "../editor_display.hpp"
#include "palette_layout.hpp"
#include "common_palette.hpp"

namespace editor {

template<class Item>
class editor_palette : public common_palette {

public:

    editor_palette(editor_display &gui, const size_specs &sizes, const config& /*cfg*/
            , size_t item_size, size_t item_width, mouse_action** active_mouse_action)
        : groups_()
        , gui_(gui)
        , size_specs_(sizes)
        , item_size_(item_size)
        , item_width_(item_width)
        , item_space_(item_size + 3)
        , palette_y_(sizes.palette_y)
        , palette_x_(sizes.palette_x)
        , group_map_()
        , item_map_()
        , nitems_(0)
        , nmax_items_(0)
        , items_start_(0)
        , non_core_items_()
        , active_group_()
        , selected_fg_item_()
        , selected_bg_item_()
        , active_mouse_action_(active_mouse_action)
    {
    };

    void set_start_item(size_t index) { items_start_ = index; };

    size_t start_num(void) { return items_start_; };

    /** Menu expanding for palette group list */
    void expand_palette_groups_menu(std::vector<std::string>& items);

    void set_group(size_t index);

    const std::vector<item_group>& get_groups() const { return groups_; };

    virtual void draw(bool);

    bool left_mouse_click(const int, const int);
    bool right_mouse_click(const int, const int);

    void next_group() {
        set_group( (active_group_index() +1) % (groups_.size() -1) );
    };
    void prev_group() {
        set_group( (active_group_index() -1) % (groups_.size() -1) );
    };

    /**
     * Update the size of this widget.
     *
     * Use if the size_specs have changed.
     */
    void adjust_size(const size_specs& size);

    virtual bool scroll_up();
    virtual bool scroll_down();

    virtual const config active_group_report();

    void swap();

    /** Return the currently selected foreground/background item. */
    const Item& selected_fg_item() const { return item_map_.find(selected_fg_item_)->second; };
    const Item& selected_bg_item() const { return item_map_.find(selected_bg_item_)->second; };

private:

    /** Return the number of the tile that is at coordinates (x, y) in the panel. */
    int tile_selected(const int x, const int y) const;

    /** TODO */
    size_t active_group_index();

    /** Scroll the editor-palette to the top. */
    void scroll_top();

    /** Scroll the editor-palette to the bottom. */
    void scroll_bottom();

    virtual void draw_item(SDL_Rect& dstrect, const Item& item, std::stringstream& tooltip) = 0;

    virtual const std::string& get_id(const Item& item) = 0;

    /** Setup the internal data structure. */
    virtual void setup(const config& cfg) = 0;

    virtual const std::string& active_group_id() {return active_group_;};

    /** Return the number of items in the palette. */
    size_t num_items();

    void draw_old(bool);

protected:
    /**
     * Sets a group active id
     *
     * This can result in no visible
     * selected items.
     */
    virtual void set_group(const std::string& id);
    const std::vector<std::string>& active_group() { return group_map_[active_group_]; };

    /** Select a foreground item. */
    virtual void select_fg_item(std::string item_id);
    virtual void select_bg_item(std::string item_id);

    /**
     * The editor_groups as defined in editor-groups.cfg.
     *
     * Note the user must make sure the id's here are the same as the
     * editor_group in terrain.cfg.
     */
    std::vector<item_group> groups_;

    editor_display &gui_;
    const size_specs &size_specs_;

    int item_size_;
    int item_width_;
    int item_space_;

private:
    unsigned int palette_y_;
    unsigned int palette_x_;

protected:
    std::map<std::string, std::vector<std::string> > group_map_;

    std::map<std::string, Item> item_map_;
    size_t nitems_, nmax_items_, items_start_;
    std::set<std::string> non_core_items_;

private:
    std::string active_group_;
    std::string selected_fg_item_;
    std::string selected_bg_item_;

    mouse_action** active_mouse_action_;
};


} //end namespace editor
#endif // EDITOR_PALETTES_H_INCLUDED