The Battle for Wesnoth  1.15.0-dev
lobby_info.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2009 - 2018 by Tomasz Sniatowski <kailoran@gmail.com>
3  Part of the Battle for Wesnoth Project http://www.wesnoth.org/
4 
5  This program is free software; you can redistribute it and/or modify
6  it under the terms of the GNU General Public License as published by
7  the Free Software Foundation; either version 2 of the License, or
8  (at your option) any later version.
9  This program is distributed in the hope that it will be useful,
10  but WITHOUT ANY WARRANTY.
11 
12  See the COPYING file for more details.
13 */
14 
15 #pragma once
16 
17 #include "config.hpp"
19 
20 #include <boost/dynamic_bitset.hpp>
21 
22 #include <memory>
23 
24 namespace mp
25 {
26 /**
27  * This class represents the collective information the client has
28  * about the players and games on the server
29  */
31 {
32 public:
33  explicit lobby_info(const config& game_config, const std::vector<std::string>& installed_addons);
34 
35  typedef std::map<int, game_info> game_info_map;
36 
37  /** Process a full game list. Current info is discarded. */
38  void process_gamelist(const config& data);
39 
40  /**
41  * Process a gamelist diff.
42  *
43  * @param data Raw game list data, usually received from the MP server.
44  *
45  * @returns True on success, false on failure (e.g. when the diff did
46  * not apply correctly).
47  */
48  bool process_gamelist_diff(const config& data);
49 
51 
52  /**
53  * Generates a new vector of game pointers from the ID/game map.
54  * The games will be referenced in ascending order by ID.
55  */
56  void make_games_vector();
57 
58  /** Returns the raw game list config data. */
59  const config& gamelist() const
60  {
61  return gamelist_;
62  }
63 
64  using game_filter_func = std::function<bool(const game_info&)>;
65 
66  /** Adds a new filter function to be considered when @ref apply_game_filter is called. */
68  {
69  game_filters_.push_back(func);
70  }
71 
72  /** Clears all game filter functions. */
74  {
75  game_filters_.clear();
76  }
77 
78  /** Sets whether the result of each game filter should be inverted. */
79  void set_game_filter_invert(bool value)
80  {
81  game_filter_invert_ = value;
82  }
83 
84  /** Generates a new list of games that match the current filter functions and inversion setting. */
85  void apply_game_filter();
86 
87  /** Returns info on a game with the given game ID. */
88  game_info* get_game_by_id(int id);
89 
90  /** Const overload of @ref get_game_by_id. */
91  const game_info* get_game_by_id(int id) const;
92 
93  /** Open a new chat room with the given name. */
94  void open_room(const std::string& name);
95 
96  /** Close the chat room with the given name. */
97  void close_room(const std::string& name);
98 
99  /** Returns whether a room with the given name has been opened. */
100  bool has_room(const std::string& name) const;
101 
102  /** Returns info on room with the given name, or nullptr if it doesn't exist. */
103  room_info* get_room(const std::string& name);
104 
105  /** Const overload of @ref get_room. */
106  const room_info* get_room(const std::string& name) const;
107 
108  /** Returns info on the user with the given name, or nullptr if they don't eixst. */
109  user_info* get_user(const std::string& name);
110 
111  chat_session& get_whisper_log(const std::string& name)
112  {
113  return whispers_[name];
114  }
115 
116  void update_user_statuses(int game_id, const room_info* room);
117 
118  const std::vector<room_info>& rooms() const
119  {
120  return rooms_;
121  }
122 
123  const std::vector<game_info*>& games() const
124  {
125  return games_;
126  }
127 
128  const boost::dynamic_bitset<>& games_visibility() const
129  {
130  return games_visibility_;
131  }
132 
133  const std::vector<user_info>& users() const
134  {
135  return users_;
136  }
137 
138  std::vector<user_info>& users()
139  {
140  return users_;
141  }
142 
143 private:
144  void process_userlist();
145 
147 
148  const std::vector<std::string>& installed_addons_;
149 
151 
153 
154  std::vector<room_info> rooms_;
155 
156  game_info_map games_by_id_;
157 
158  std::vector<game_info*> games_;
159 
160  std::vector<user_info> users_;
161 
162  std::map<std::string, chat_session> whispers_;
163 
164  std::vector<game_filter_func> game_filters_;
165 
167 
168  boost::dynamic_bitset<> games_visibility_;
169 };
170 
183 };
184 
185 void do_notify(notify_mode mode, const std::string& sender = "", const std::string& message = "");
186 }
const config & gamelist() const
Returns the raw game list config data.
Definition: lobby_info.hpp:59
const std::vector< room_info > & rooms() const
Definition: lobby_info.hpp:118
user_info * get_user(const std::string &name)
Returns info on the user with the given name, or nullptr if they don&#39;t eixst.
Definition: lobby_info.cpp:296
std::map< std::string, chat_session > whispers_
Definition: lobby_info.hpp:162
This class represents the info a client has about a game on the server.
Definition: lobby_data.hpp:138
std::map< int, game_info > game_info_map
Definition: lobby_info.hpp:35
void update_user_statuses(int game_id, const room_info *room)
Definition: lobby_info.cpp:363
std::vector< room_info > rooms_
Definition: lobby_info.hpp:154
This class represents the collective information the client has about the players and games on the se...
Definition: lobby_info.hpp:30
void add_game_filter(game_filter_func func)
Adds a new filter function to be considered when apply_game_filter is called.
Definition: lobby_info.hpp:67
std::vector< game_filter_func > game_filters_
Definition: lobby_info.hpp:164
Definitions for the interface to Wesnoth Markup Language (WML).
this class memorizes a chat session.
Definition: lobby_data.hpp:42
void process_gamelist(const config &data)
Process a full game list.
Definition: lobby_info.cpp:109
void apply_game_filter()
Generates a new list of games that match the current filter functions and inversion setting...
Definition: lobby_info.cpp:338
room_info * get_room(const std::string &name)
Returns info on room with the given name, or nullptr if it doesn&#39;t exist.
Definition: lobby_info.cpp:269
bool has_room(const std::string &name) const
Returns whether a room with the given name has been opened.
Definition: lobby_info.cpp:291
game_info * get_game_by_id(int id)
Returns info on a game with the given game ID.
Definition: lobby_info.cpp:257
void make_games_vector()
Generates a new vector of game pointers from the ID/game map.
Definition: lobby_info.cpp:323
Pubic entry points for the MP workflow.
Definition: lobby_data.cpp:47
void do_notify(notify_mode mode, const std::string &sender, const std::string &message)
Definition: lobby_info.cpp:54
const std::vector< std::string > & installed_addons_
Definition: lobby_info.hpp:148
boost::dynamic_bitset games_visibility_
Definition: lobby_info.hpp:168
void sync_games_display_status()
Definition: lobby_info.cpp:236
std::vector< std::string > installed_addons()
Retrieves the names of all installed add-ons.
Definition: manager.cpp:147
void set_game_filter_invert(bool value)
Sets whether the result of each game filter should be inverted.
Definition: lobby_info.hpp:79
game_info_map games_by_id_
Definition: lobby_info.hpp:156
bool gamelist_initialized_
Definition: lobby_info.hpp:152
const boost::dynamic_bitset & games_visibility() const
Definition: lobby_info.hpp:128
std::vector< user_info > & users()
Definition: lobby_info.hpp:138
const std::vector< game_info * > & games() const
Definition: lobby_info.hpp:123
Game configuration data as global variables.
Definition: build_info.cpp:46
std::function< bool(const game_info &)> game_filter_func
Definition: lobby_info.hpp:64
This class represents the information a client has about a room.
Definition: lobby_data.hpp:67
bool game_filter_invert_
Definition: lobby_info.hpp:166
void clear_game_filter()
Clears all game filter functions.
Definition: lobby_info.hpp:73
bool process_gamelist_diff(const config &data)
Process a gamelist diff.
Definition: lobby_info.cpp:129
void process_userlist()
Definition: lobby_info.cpp:201
This class represents the information a client has about another player.
Definition: lobby_data.hpp:104
lobby_info(const config &game_config, const std::vector< std::string > &installed_addons)
Definition: lobby_info.cpp:38
void close_room(const std::string &name)
Close the chat room with the given name.
Definition: lobby_info.cpp:314
chat_session & get_whisper_log(const std::string &name)
Definition: lobby_info.hpp:111
notify_mode
Definition: lobby_info.hpp:171
const config & game_config_
Definition: lobby_info.hpp:146
const std::vector< user_info > & users() const
Definition: lobby_info.hpp:133
void open_room(const std::string &name)
Open a new chat room with the given name.
Definition: lobby_info.cpp:307
A config object defines a single node in a WML file, with access to child nodes.
Definition: config.hpp:68
std::vector< user_info > users_
Definition: lobby_info.hpp:160
std::vector< game_info * > games_
Definition: lobby_info.hpp:158