1

#ifndef ENGINE_HH

     2

#define ENGINE_HH

     3

     4

// forward-declare

     5

class Engine;

     6

     7

#include "GameState.hh"

     8

#include "Configuration.hh"

     9

#include "Logger.hh"

    10

    11

// forward-declare component pointer types

    12

// XXX: move to some kind of Components.hh file?

    13

namespace graphics { class Graphics; class GameView; }

    14

class NetworkServer;

    15

class NetworkClientConnect;

    16

class NetworkClient;

    17

class NetworkClientController;

    18

    19

/**

    20

 * This is the core class that glues all the other components together and runs the main loop

    21

 */

    22

class Engine {

    23

    private:

    24

        /** The game's terrain */

    25

        Terrain *terrain;

    26

    27

        /** The game's state */

    28

        GameState *game_state;

    29

    30

        /** The graphics+input component */

    31

        graphics::Graphics *graphics;

    32

    33

        /** Network server */

    34

        NetworkServer *net_server;

    35

    36

        /** Network client connector */

    37

        NetworkClientConnect *net_client_connect;

    38

    39

        /** Network client, currently unused */

    40

        NetworkClient *net_client;

    41

    42

        /** The GameView, if open */

    43

        graphics::GameView *game_view;

    44

    45

        /** Is the mainloop still running? */

    46

        bool is_running;

    47

    48

        /** Used to load ClanLib resources */

    49

        CL_ResourceManager resources;

    50

    51

        /** *Global* log level */

    52

        static LogLevel log_level;

    53

    54

    public:    

    55

        // default constructor

    56

        Engine (const EngineConfig &config);

    57

    58

        /**

    59

         * Setup game world using the given terrain, returning the new GameState

    60

         */

    61

        void setupGame (Terrain *terrain);

    62

    63

        /**

    64

         * Setup game world using given terrain configuration

    65

         */

    66

        void setupGame (const TerrainConfig &config);

    67

    68

        /**

    69

         * Enable graphics. 

    70

         *

    71

         * Requires: GRAPHICS_ENABLED

    72

         */

    73

        void setupGraphics (const DisplayConfig &config);

    74

    75

        /**

    76

         * Setup server, must call setupGame first

    77

         *

    78

         * Requires: NETWORK_ENABLED

    79

         */

    80

        void setupNetworkServer (const std::string &listen_port);

    81

    82

        /**

    83

         * Setup client, do *not* call setupGame, configuration comes from the server

    84

         *

    85

         * Requires: NETWORK_ENABLED

    86

         */

    87

        void setupNetworkClient (const std::string &connect_host, const std::string &connect_port);

    88

    89

        /**

    90

         * Setup singleplayer, must call setupGame first

    91

         */

    94

    95

        /**

    96

         * Run the game main loop. This will not return until the game aborts due to an error, or someone calls stop().

    97

         */

    98

        void run (void);

    99

   100

        /**

   101

         * Terminate the main loop, causing run() to return once this loop iteration is finished

   102

         */

   103

        void stop (void);

   104

   105

    private:

   106

        /**

   107

         * Puts graphics into GameView mode, using our GameState and the given player

   108

         */

   109

        void startGameView (LocalPlayer *player);

   110

   111

    protected:

   112

        friend class NetworkClientConnect;

   113

        friend class NetworkClientController;

   114

   115

        /**

   116

         * Interface for NetworkClient to use once it has connected

   117

         */

   118

        GameState& onNetworkClientConnected (Terrain *terrain);

   119

   120

        /**

   121

         * Interface for NetworkClient to use once it has set up the player

   122

         */

   123

        void onNetworkClientPlayer (LocalPlayer *player);

   124

   125

    public:

   126

        /**

   127

         * Get a pointer to our resource manager, please don't break it.

   128

         *

   129

         * Guaranteed to never be NULL

   130

         */

   131

        CL_ResourceManager* getResourceManager (void) { return &resources; }

   132

   133

        /**

   134

         * Log output, see Logger for more info

   135

         *

   136

         * @see Logger

   137

         */

   138

        static inline Logger log (LogLevel level, const char *type) {

   139

            return Logger(level <= WARN ? std::cerr : std::cout, level, type, log_level);

   140

        }

   141

   142

};

   143

   144

#endif /* ENGINE_HH */