The Battle for Wesnoth  1.19.6+dev
game_launcher.hpp
Go to the documentation of this file.
1 /*
2  Copyright (C) 2003 - 2024
3  by David White <dave@whitevine.net>
4  Part of the Battle for Wesnoth Project https://www.wesnoth.org/
5 
6  This program is free software; you can redistribute it and/or modify
7  it under the terms of the GNU General Public License as published by
8  the Free Software Foundation; either version 2 of the License, or
9  (at your option) any later version.
10  This program is distributed in the hope that it will be useful,
11  but WITHOUT ANY WARRANTY.
12 
13  See the COPYING file for more details.
14 */
15 
16 #pragma once
17 
18 #include "editor/editor_main.hpp" // for EXIT_STATUS
19 #include "events.hpp" // for event_context
20 #include "font/font_config.hpp" // for manager
21 #include "game_end_exceptions.hpp" // for LEVEL_RESULT, etc
22 #include "hotkey/hotkey_manager.hpp" // for manager
23 #include "picture.hpp" // for manager
24 #include "saved_game.hpp" // for saved_game
25 #include "savegame.hpp" // for clean_saves, etc
26 #include "sound.hpp" // for music_thinker
27 #include "utils/optional_fwd.hpp"
28 
29 #include <string> // for string
30 #include <vector> // for vector
31 
33 
35 {
36  /** Whether the game should immediately start a campaign. */
37  bool jump = false;
38 
39  /** Whether the story screen should be skipped. */
40  bool skip_story = false;
41 
42  /** The difficulty at which to launch the campaign. */
43  int difficulty = -1;
44 
45  /** The ID of the campaign to launch. */
46  std::string campaign_id = "";
47 
48  /** The ID of the scenario within the campaign to jump to. */
49  std::string scenario_id = "";
50 };
51 
53 {
54 public:
55  game_launcher(const commandline_options& cmdline_opts);
57 
58  enum class mp_mode { CONNECT, HOST, LOCAL };
60 
61  /**
62  * Status code after running a unit test, should match the run_wml_tests
63  * script and the documentation for the --unit_test command-line option.
64  */
65  enum class unit_test_result : int {
66  TEST_PASS = 0,
67  TEST_FAIL = 1,
68  // 2 is reserved for timeouts
71  //TEST_FAIL_BROKE_STRICT = 5,
79  };
80 
81  bool init_video();
82  bool init_language();
83  bool init_lua_script();
84 
85  bool play_test();
86  bool play_screenshot_mode();
88  /** Runs unit tests specified on the command line */
90 
91  bool has_load_data() const;
92  bool load_game();
93  void set_test(const std::string& id);
94 
95  /** Return the ID of the campaign to jump to (skipping the main menu). */
96  std::string jump_to_campaign_id() const;
97  bool new_campaign();
98  bool goto_campaign();
99  bool goto_multiplayer();
100  bool goto_editor();
101 
102  void select_mp_server(const std::string& server) { multiplayer_server_ = server; }
103  bool play_multiplayer(mp_mode mode);
105  bool change_language();
106 
108  void play_replay();
109 
111 
112  const commandline_options & opts() const { return cmdline_opts_; }
113 
114 private:
115  game_launcher(const game_launcher&) = delete;
117 
118  void clear_loaded_game();
119  void start_wesnothd();
120 
121  editor::EXIT_STATUS start_editor(const std::string& filename);
123 
124  /**
125  * Internal to the implementation of unit_test(). If a single instance of
126  * Wesnoth is running multiple unit tests, this gets called once per test.
127  */
129 
131  bool start_in_fullscreen_ = false;
132 
139 
140  std::vector<std::string> test_scenarios_;
141 
143 
146 
147  std::string multiplayer_server_;
150 
152  utils::optional<savegame::load_game_metadata> load_data_;
153 };
game_launcher(const commandline_options &cmdline_opts)
const events::event_context main_event_context_
game_launcher & operator=(const game_launcher &)=delete
unit_test_result single_unit_test()
Internal to the implementation of unit_test().
std::string multiplayer_server_
std::string jump_to_campaign_id() const
Return the ID of the campaign to jump to (skipping the main menu).
bool play_screenshot_mode()
jump_to_campaign_info jump_to_campaign_
std::string screenshot_filename_
void launch_game(reload_mode reload=reload_mode::RELOAD_DATA)
sound::music_thinker music_thinker_
bool goto_multiplayer()
game_launcher(const game_launcher &)=delete
bool change_language()
saved_game state_
unit_test_result pass_victory_or_defeat(level_result::type res)
bool has_load_data() const
bool play_render_image_mode()
void clear_loaded_game()
bool init_lua_script()
std::vector< std::string > test_scenarios_
unit_test_result
Status code after running a unit test, should match the run_wml_tests script and the documentation fo...
std::string screenshot_map_
const commandline_options & cmdline_opts_
font::manager font_manager_
const hotkey::manager hotkey_manager_
void select_mp_server(const std::string &server)
const image::manager image_manager_
utils::optional< savegame::load_game_metadata > load_data_
void set_test(const std::string &id)
bool play_multiplayer_commandline()
unit_test_result unit_test()
Runs unit tests specified on the command line.
sound::music_muter music_muter_
const commandline_options & opts() const
bool play_multiplayer(mp_mode mode)
editor::EXIT_STATUS start_editor()
this class is initialized once at game start put all initialization and wipe code in the methods here...
Contains the exception interfaces used to signal completion of a scenario, campaign or turn.
std::string filename
Filename.
Image cache manager.
Definition: picture.hpp:144
std::string campaign_id
The ID of the campaign to launch.
bool jump
Whether the game should immediately start a campaign.
std::string scenario_id
The ID of the scenario within the campaign to jump to.
bool skip_story
Whether the story screen should be skipped.
int difficulty
The difficulty at which to launch the campaign.