project_files/frontlib/model/team.h
author Mrowqa
Tue, 04 Dec 2012 09:24:10 +0100
changeset 8260 83d85e32c713
parent 7497 7e1d72fc03c7
child 8262 f01702bfb764
permissions -rw-r--r--
GCI2012: Corrected headers for generate documentation (doxygen)

/*
 * Hedgewars, a free turn based strategy game
 * Copyright (C) 2012 Simeon Maxein <smaxein@googlemail.com>
 *
 * 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; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 */

/**
 * This file defines a data structure for a hedgewars team.
 *
 * Teams are used in several different contexts in Hedgewars, and some of these require
 * extra information about teams. For example, the weaponset is important
 * to the engine, but not for ini reading/writing, and with the team statistics it is the
 * other way around. To keep things simple, the data structure can hold all information
 * used in any context. On the downside, that means we can't use static typing to ensure
 * that team information is "complete" for a particular purpose.
 */
#ifndef TEAM_H_
#define TEAM_H_


#include "weapon.h"
#include "../hwconsts.h"

#include <stdbool.h>
#include <stdint.h>

#define TEAM_DEFAULT_HEALTH 100

/**
 * Struct representing a single keybinding.
 */
typedef struct {
	char *action;
	char *binding;
} flib_binding;

typedef struct {
	char *name;
	char *hat;			//! e.g. hair_yellow; References a .png file in Data/Graphics/Hats

	//! Statistics. They are irrelevant for the engine or server,
	//! but provided for ini reading/writing by the frontend.
	int rounds;
	int kills;
	int deaths;
	int suicides;

	int difficulty;		//! 0 = human, 1 = most difficult bot ... 5 = least difficult bot (somewhat counterintuitive)

	//! Transient setting used in game setup
	int initialHealth;
	flib_weaponset *weaponset;
} flib_hog;

typedef struct {
	flib_hog hogs[HEDGEHOGS_PER_TEAM];
	char *name;
	char *grave;		//! e.g. "Bone"; References a .png file in Data/Graphics/Graves
	char *fort;			//! e.g. "Castle"; References a series of files in Data/Forts
	char *voicepack;	//! e.g. "Classic"; References a directory in Data/Sounds/voices
	char *flag;			//! e.g. "hedgewars"; References a .png file in Data/Graphics/Flags

	flib_binding *bindings;
	int bindingCount;

	//! Statistics. They are irrelevant for the engine or server,
	//! but provided for ini reading/writing by the frontend.
	int rounds;
	int wins;
	int campaignProgress;

	//! Transient settings used in game setup
	int colorIndex;		//! Index into a color table
	int hogsInGame;		//! The number of hogs that will actually play
	bool remoteDriven;	//! true for non-local teams in a network game
	char *ownerName;	//! Username of the owner of a team in a network game
} flib_team;

/**
 * Free all memory associated with the team
 */
void flib_team_destroy(flib_team *team);

/**
 * Loads a team, returns NULL on error. Destroy this team using flib_team_destroy.
 * This will not fill in the fields marked as "transient" in the structs above.
 */
flib_team *flib_team_from_ini(const char *filename);

/**
 * Write the team to an ini file. Attempts to retain extra ini settings
 * that were already present. Note that not all fields of a team struct
 * are stored in the ini, some are only used intermittently to store
 * information about a team in the context of a game.
 *
 * The flib_team can handle "difficulty" on a per-hog basis, but it
 * is only written per-team in the team file. The difficulty of the
 * first hog is used for the entire team when writing.
 */
int flib_team_to_ini(const char *filename, const flib_team *team);

/**
 * Set the same weaponset for every hog in the team
 */
int flib_team_set_weaponset(flib_team *team, const flib_weaponset *set);

/**
 * Set the same initial health for every hog.
 */
void flib_team_set_health(flib_team *team, int health);

/**
 * Create a deep copy of a team. Returns NULL on failure.
 */
flib_team *flib_team_copy(const flib_team *team);

#endif /* TEAM_H_ */