## Public API Reference

- Main Page
- Classes
- Files

- Alphabetical List
- Class List
- Class Hierarchy
- Class Members

# iCelGameFactory Struct Reference

A factory to manage game sessions. More...

`#include <physicallayer/network.h>`

List of all members.

## Public Member Functions

virtual bool | CloseGame ()=0
| The player leaves the current game or playback.
virtual bool | ConnectGame (celGameInfo *game_info, celPlayer *player)=0
| Connect the player to the game specified in game_info.
virtual bool | CreateNewGame (celNetworkGameType game_type, celGameInfo *game_info, celPlayer *player=0)=0
| Create a new game, ie at least a server, but also a client if a player is provided.
virtual iCelGame * | GetCurrentGame () const =0
| Return the current game or 0 if no game is available.
virtual csString | GetGameName () const =0
| Return the name of the game.
virtual csString | GetProtocolVersion () const =0
| Return the network protocol version used by this application.
virtual void | RegisterGameFactoryManager (celGameFactoryManager *manager)=0
| Register a manager for this game factory.
virtual void | SetGameName (csString game_name)=0
| Set the name of the game.
virtual void | SetProtocolVersion (const csString protocol_version)=0
| Set the name of the network protocol version used by this application.
virtual void | StartPlayBackGame (csString filename, csTicks start_time, csTicks stop_time)=0
| Start a game where incoming events are read from a file from start_time to stop_time.
virtual void | StartRecordingGame (csString filename)=0
| Incoming events are recorded in a file.
virtual void | StartSearchForGameList (celNetworkGameType game_type, celGameInfo *filter=0)=0
| Start to search for the list of available games with the same game name, protocol version and game type.
virtual void | StopRecordingGame ()=0
| Incoming events are no more recorded in a file.
virtual void | StopSearchForGameList ()=0
| Stop searching for the list of available games.

## Detailed Description

A factory to manage game sessions.

You can use it to:

- set and get the name of the game and of the network protocol version.
- search for available games, connect to them or create a new game.
- record the events of the game and playback them.

You must define and register a iCelGameFactoryManager which will catch the events from this factory.

There should be only one game factory in an application.

Definition at line 101 of file network.h.

## Member Function Documentation

virtual bool iCelGameFactory::CloseGame | ( |  | ) | `[pure virtual]`

The player leaves the current game or playback.

If a server was also set, it will be closed.

Returns:
  true if the game can be closed, false otherwise.

virtual bool iCelGameFactory::ConnectGame | ( | celGameInfo * | game_info,
|  | celPlayer * | player |
| ) |  |  | `[pure virtual]`

Connect the player to the game specified in game_info.

If a game is already running, it will be closed before the new game is launched. The game_info field must contain the necessary data to find the server, ie a game_id field previously returned by celGameFactoryManager::GameInfoReceived, or the ip_address and port_nb fields. If the game factory was searching for games, it will stop its search.

Parameters:

  | game_info | the informations on the game we want to connect to.
  | player | the player which is connecting to the game.

Returns:
  true if the game can be connected.

virtual bool iCelGameFactory::CreateNewGame | ( | celNetworkGameType | game_type,
|  | celGameInfo * | game_info,
|  | celPlayer * | player = `0` |
| ) |  |  | `[pure virtual]`

Create a new game, ie at least a server, but also a client if a player is provided.

Only one game can be created at a time, so if a game is already running, it will be closed before the new game is launched. If the game factory was searching for games, it will stop its search.

Parameters:

  | game_type | the type of the game. It can be CEL_NET_SINGLEPLAYER, CEL_NET_LOCAL or CEL_NET_PUBLIC.
  | game_info | the informations on the game.
  | player | the player launching the game. He can be given special access rights to modify the game. If player is different from 0, then a client will also be created.

Returns:
  true if the game can be created.

virtual iCelGame* iCelGameFactory::GetCurrentGame | ( |  | ) | const`[pure virtual]`

Return the current game or 0 if no game is available.

virtual csString iCelGameFactory::GetGameName | ( |  | ) | const`[pure virtual]`

Return the name of the game.

Client and server instances can talk together only if they have the same game name and protocol version.

virtual csString iCelGameFactory::GetProtocolVersion | ( |  | ) | const`[pure virtual]`

Return the network protocol version used by this application.

Client and server instances can talk together only if they have the same game name and protocol version.

virtual void iCelGameFactory::RegisterGameFactoryManager | ( | celGameFactoryManager * | manager | ) | `[pure virtual]`

Register a manager for this game factory.

The manager will be notified when events are thrown from the game factory. Only one manager can be registered at a time.

A manager must be registered before any operation on the factory.

virtual void iCelGameFactory::SetGameName | ( | csString | game_name | ) | `[pure virtual]`

Set the name of the game.

Client and server instances can talk together only if they have the same game name and protocol version.

A game name must be set before any operation on the factory.

Parameters:

  | game_name | an arbitrary game name, like "Crystal Core".

virtual void iCelGameFactory::SetProtocolVersion | ( | const csString | protocol_version | ) | `[pure virtual]`

Set the name of the network protocol version used by this application.

Client and server instances can talk together only if they have the same game name and protocol version.

A protocol version must be set before any operation on the factory.

The protocol version should be changed each time something has been changed in the network protocol of the game, ie in the meaning of the network events, like changes in the implementation of the network plugin, the selection of property classes of the entities, the client and server events, the network links and the baselines.

Parameters:

  | protocol_version | an arbitrary protocol version name, like "v0.3".

virtual void iCelGameFactory::StartPlayBackGame | ( | csString | filename,
|  | csTicks | start_time,
|  | csTicks | stop_time |
| ) |  |  | `[pure virtual]`

Start a game where incoming events are read from a file from start_time to stop_time.

CloseGame can be used to stop the playback. If the game factory was searching for available games or if a game was running, they will be stopped.

virtual void iCelGameFactory::StartRecordingGame | ( | csString | filename | ) | `[pure virtual]`

Incoming events are recorded in a file.

A game must previously be running.

virtual void iCelGameFactory::StartSearchForGameList | ( | celNetworkGameType | game_type,
|  | celGameInfo * | filter = `0` |
| ) |  |  | `[pure virtual]`

Start to search for the list of available games with the same game name, protocol version and game type.

The registered celGameFactoryManager will be notified through celGameFactoryManager::GameInfoReceived each time a game has been found. A celGameInfo object can be provided to filter the games.

Parameters:

  | filter | a new game info will be received only if celGameInfo::MatchFilter returns true with this filter.

virtual void iCelGameFactory::StopRecordingGame | ( |  | ) | `[pure virtual]`

Incoming events are no more recorded in a file.

virtual void iCelGameFactory::StopSearchForGameList | ( |  | ) | `[pure virtual]`

Stop searching for the list of available games.

No more celGameFactoryManager::GameInfoReceived will be raised.

The documentation for this struct was generated from the following file:

- physicallayer/network.h