1 /***************************************************************************
4 begin : Tue Jan 22 2002
5 copyright : (C) 2002 by Michael Andreen
7 ***************************************************************************/
9 /***************************************************************************
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
16 ***************************************************************************/
22 #include <ext/hash_map>
27 template<typename T> class MyComp { public: bool operator()(T,T) { return false; } };
28 typedef std::map<std::string, std::vector<int> > FleetList;
29 typedef std::map<std::string, UnitType> UnitList;
30 typedef std::map<std::string, std::vector<int> > RaceList;
31 typedef std::map<std::string, std::vector<int> > ResourceList;
32 typedef std::map<std::string, int> ArmorList;
33 //! An abstraction of a fleet and the engine for the battle simulation.
34 /**This class and it's derivates is the engine for the whole battlesystem.
35 * One of the few parts that I plan make fully portable.
36 *\todo LOTS (I think ;)
37 *@author Michael Andreen
45 /**Sets the name that represents this fleet. Might be different a name
46 * like foobar or some coordinates like 1:1:1. The name doesn't have to be
47 * unique, since it's up to the rest of the program to handle that part.
50 void setName(std::string sName);
52 /**Returns the name of this fleet.
55 std::string name() const;
57 /**The race string decides what type of ships this fleet can have.
58 * The values must be feeded into this class.
59 * \param sRace This is just the name of the race. It's case-sensitive.
60 * \return If the race is available this function returns true, if not false
61 * is returned. The race is set in both cases though.
64 bool setRace(std::string sRace);
66 /**Just returns what race this fleet belongs to..
67 * \return The race, represented as a string.
70 std::string race() const;
72 /**Returns the ship races allowed for this fleet.. This is not a hard limit
73 * it's more a indication to the interface what should be shown or not, the
74 * class can still handle all the different shiptypes.
75 * \return a vector of ints that can be used to compare with Unittype::race()
76 * \see Unittype::race()
78 std::vector<int> RacesAllowed() const;
80 /**Returns the total number of ships in this fleet
82 int numberOfShips() const;
84 /**Sets the estimated time of arrival. The time as a single integer,
85 * in relation to the current time. For example if the current time is
86 * 10, and the arrival is at 12, then the eta is 2.
90 /**Return the estimated time of arrival. It's counted from the current time (tick).
95 /**Returns the score. This value is the total resources spent on this fleet
97 * \param tick tells the function what tick you want the score from. 0 is
98 * initial score before the fleet has landed.
100 unsigned score(int tick = 0) const;
102 /**This function is used to set the number of units for a specific tic.
103 * \param untitype the unittype's name, as a std string
104 * \param number the number of ships
105 * \param tick what tick to set for. Tick 0 (before battle) is standard, no
106 * other is hardly used other than inside the engine.
108 void setFleet(std::string unittype, int number, int tick = 0);
110 void addFleet(std::string unittype, int number, int tick = 0);
112 void addFleet(std::map<std::string, int> units, int tick = 0);
114 /**Returns the numbers of units fo a specific type at a specific tick.
115 * \param unittype The shipname, as a std string
116 * \param tick The tick you want to look at, tick 0 (before battle) is default
117 * \return returns the number of units that params specifies.
119 int fleet(std::string unittype, int tick = 0);
121 /**Returns the number of free ships, that is: ships that aren't dead and not
123 * \param unittype The shipname, as a std string
124 * \param tick The tick you want to look at, tick 0 (before battle) is default
125 * \return returns the number of units that params specifies.
127 int freeFleet(std:: string unittype, int tick = 0);
129 /** This function is used to see how many ships of a specific type got
130 * blocked at a specific tick.
131 * \param unittype the name of the unittype
132 * \param tick what tick you want to look at
133 * \return the number of ships that got blocked at the specified tick.
135 int blockedFleet(std::string unittype, int tick = 0);
137 void setBlockedFleet(std::string unittype, int number, int tick = 0);
139 /** This function takes the vector with fleets and adds all their units of the
140 * specific tick to the current fleet's first tick. Main usage is for battle
142 * \param fleets a vector with fleet pointers
143 * \param tick an int to specify what tick to use. tick 0 (before battle)
145 * \todo add another tick parameter to specify what tick to use in the
148 void addToThis(std::vector<Fleet*> fleets, int tick = 0);
150 /** This function takes a vector with fleets and distribute all ship losses
151 * between tick 0 and 1 in the current fleet and adds that to the specified
152 * tick in each fleet.
153 * \param fleets a vector with fleet pointers that holds the fleets that's
154 * going to share the losses.
155 * \param tick the tick to add the losses to for the fleets in the vector.
156 * \todo add another tick parameter to specify what tick to use in the
159 void distributeLossesGains(std::vector<Fleet*> fleets, int tick = 0);
161 /** This functions takes the captured roids between tick 0 and 1 in the
162 * current fleet and divides them between the fleets given as param.
163 * \param fleets a vector with Fleet pointers, points to the fleets that
164 * should get parts of the roids.
165 * \param tick the tick to use in the fleets given as argument, when the
166 * roids are handed out.
167 * \todo add another tick parameter to specify what tick to use in the
170 void distributeCappedRoids(std::vector<Fleet*> fleets, int tick = 0);
172 /** Checks through the vector with fleets to see who's in time for the
173 * specified tick and staying long enough so they're not too early.
174 * \param fleets a vector with Fleet pointers to use for the calculations
175 * \param stays the number of ticks the fleets stays, will be obsolee when
177 * \param tick What the current tick is to use for the calculations
178 * \return returns a vector with the fleet that are in time for the battle
179 * and are staying long enough.
180 * \todo add the stays part as a integrated part of each fleet.
182 std::vector<Fleet*> calculateSide(std::vector<Fleet*> fleets, int stays = 0, int tick = 0);
184 /** Kill some ships of the specified type in the current fleet.
185 * \param unittype the name of the unit to kill
186 * \param number how many ships to kill
187 * \param tick what tick they where killed.
189 void killFleet(std::string unittype, int number, int tick = 0);
191 /**Block some ships of the specified type in the current fleet.
192 * \param unittype the name of the unit to block
193 * \param number how many ships to block
194 * \param tick what tick they where blocked.
196 void blockFleet(std::string unittype, int number, int tick = 0);
198 /** Set the resources of the specified type for the tick.
200 * \param type The name of the resource (in pa: metal,
201 * crystal and eonium (+ uninit for roids).
202 * \param number just simply the number of the specified resource.
203 * \param tick what tick to set
206 void setResource(std::string type, int number, int tick = 0);
208 /** Adds a number ot the specified resource type.
209 * \param type The name of the resource (in pa: metal,
210 * crystal and eonium (+ uninit for roids).
211 * \param number just simply the number of the specified resource.
212 * \param tick what tick to set
215 void addResource(std::string type, int number, int tick = 0);
217 /** Looks up the how much of a specific resource type the current fleet has.
219 * Resources is a kinda vague word, in general it's used as roid capping
220 * for hostile fleet and as salvage for friendly.
221 * \param type The name of the resource (in pa: metal,
222 * crystal and eonium (+ uninit for roids).
223 * \param tick what tick to set
224 * \returns simply returns the number of the specific resource this fleet
227 int resource(std::string type, int tick = 0)const;
229 void resetResources();
231 /** This function tells how many ticks the fleet stays at it's target.
232 * \returns the number of ticks as an int.
235 void setStays(int ticks);
237 /** This is a little more advanced function. It makes a a number of units
238 * of a specific unittype shoot at the current fleet and calculates the
241 * Atm all calculations are done for tick 0/1
242 * \param unittype The name of the unit that shots at the current fleet.
243 * \param number The number of the specific unittype that shoot.
244 * \param hitunits a map to count the number of killed units, just if the
245 * rest of the program needs it.
246 * \todo add a parameter to specify what tick to calc for and move out as
247 * much of the code as possible because it's kinda crowded atm and lots of
248 * very similar stuff in both the take* functions.
251 void takeShoot(std::string unittype, int number, std::map<std::string, int>& hitunits);
253 /**This is a little more advanced function. It makes a a number of units
254 * of a specific unittype shoot at the current fleet and calculates how
257 * Atm all calculations are done for tick 0/1
258 * \param unittype The name of the unit that shots at the current fleet.
259 * \param number The number of the specific unittype that shoot.
260 * \todo add a parameter to specify what tick to calc for and move out as
261 * much of the code as possible because it's kinda crowded atm and lots of
262 * very similar stuff in both the take* functions.
265 void takeEMP(std::string unittype, int number);
267 void calculateLostStealships(std::string unittype, std::map<std::string, int> stolen, int tick = 1);
269 /** This function prints out all the ships in the fleet to stderr,
270 * mainly used for debugging.
276 /** This function is used to set the different races used.
277 * \param races a Simple RaceList which holds all the info
279 static void setRaces(RaceList& races);
281 /** This function is used to set all the units used in the game.
282 * \param units This is a simple UnitList holding all info needed.
284 static void setUnits(UnitList& units);
286 /** This function is used to get the list of races used.
287 * \returns it returns a simple RaceList just like the one that set it.
289 static const RaceList& Races();
291 /** This function is used to get the list of all the units in the game
292 * \returns a simple UnitList holding everything.
294 static const UnitList& Units();
304 FleetList m_BlockedFleet;
305 ResourceList m_Resources;
311 static UnitList s_Units;
312 static RaceList s_Races;