Mercurial > repos > snowblizz-super-API-ideas
view api/Objects/UnitType.cs @ 46:a5855fcd75ab
Re #11 - Document classes and methods
* Document methods in UnitType and Category classes
author | IBBoard <dev@ibboard.co.uk> |
---|---|
date | Mon, 23 Mar 2009 20:57:07 +0000 |
parents | 548cfc776f54 |
children | 9561ef46c6fb |
line wrap: on
line source
// This file (UnitType.cs) is a part of the IBBoard.WarFoundry.API project and is copyright 2009 IBBoard. // // The file and the library/program it is in are licensed under the GNU LGPL license, either version 3 of the License or (at your option) any later version. Please see COPYING.LGPL for more information and the full license. using System; using System.Collections; using System.Collections.Generic; using System.Xml; using IBBoard.Logging; using IBBoard.WarFoundry.API.Requirements; namespace IBBoard.WarFoundry.API.Objects { /// <summary> /// A UnitType is a type for a <see cref=" Unit"/>, normally relating to an entry in an army list. The UnitType defines the name, cost, minimum and maximum limits of a unit, and the equipment units of the type can take. /// </summary> public class UnitType : WarFoundryObject { protected Category mainCat; protected Race race; protected int min, max, baseSize = 0; protected int minSize, maxSize; protected double baseUnitCost; protected double costPerTrooper; protected Stats stats; protected List<UnitRequirement> requirements = new List<UnitRequirement>(); protected Hashtable equipment = new Hashtable(); protected Hashtable equipmentExclusionGroups = new Hashtable(); protected ArrayList equipmentKeyOrder = new ArrayList(); public UnitType(string id, string typeName, Race parentRace) : base(id, typeName) { race = parentRace; } [Obsolete("Use three parameter constructor and setters")] public UnitType(string id, string typeName, string mainCategoryID, string[] allCategoryIDs, int minNum, int maxNum, int minimumSize, int maximumSize, double unitCost, double trooperCost, Stats unitStats, UnitRequirement[] unitRequirements, Race parentRace) : base(id, typeName) { race = parentRace; mainCat = race.GetCategory(mainCategoryID); MinNumber = minNum; MaxNumber = maxNum; MinSize = minimumSize; MaxSize = maximumSize; BaseUnitCost = unitCost; CostPerTrooper = trooperCost; UnitStats = unitStats; foreach (UnitRequirement requirement in requirements) { AddRequirement(requirement); } } /// <value> /// Gets the <see cref=" Race"/> that this unit belongs to. /// </value> public Race Race { get { return race; } } /// <value> /// Gets or sets the <see cref=" Category"/> that this unit type is a member of. /// </value> public virtual Category MainCategory { get { return mainCat; } set { mainCat = value; } } /// <value> /// Gets or sets the minimum size of each unit of this type. Note: This should be set AFTER MaxSize, otherwise an unintended default value may be set for the minimum /// </value> public int MinSize { get { return minSize; } set { minSize = (value >= 0 ? value : 0); CheckMinimumSize(); } } /// <value> /// Gets or sets the maximum size of each unit of this type. Note: This should be set BEFORE MinSize, otherwise an unintended default value may be set for the minimum /// </value> public int MaxSize { get { return maxSize; } set { maxSize = (value >= 0 ? value : WarFoundryCore.INFINITY); CheckMinimumSize(); } } /// <value> /// Gets or sets the minimum number of units of this type that must be taken in an army. Note: This should be set AFTER MaxNumber, otherwise an unintended default value may be set for the minimum /// </value> public int MinNumber { get { return min; } set { min = (value >= 0 ? value : 0); CheckMinimumNumber(); } } /// <value> /// Gets or sets the maximum number of units of this type that can be taken in an army. Note: This should be set BEFORE MinNumber, otherwise an unintended default value may be set for the minimum /// </value> public int MaxNumber { get { return max; } set { max = (value >= 0 ? value : WarFoundryCore.INFINITY); CheckMinimumNumber(); } } /// <summary> /// Makes sure that the minimum number isn't more than the maximum number, hence the warning on the properties /// </summary> private void CheckMinimumNumber() { if (MinNumber > MaxNumber && MaxNumber!=WarFoundryCore.INFINITY) { MinNumber = MaxNumber; LogNotifier.WarnFormat(GetType(), "Unit type {0} ({1}) had a minimum number greater than their maximum number.", Name, ID); } } /// <summary> /// Makes sure that the minimum unit size isn't more than the maximum unit size, hence the warning on the properties /// </summary> private void CheckMinimumSize() { if (MinSize > MaxSize && MaxSize!=WarFoundryCore.INFINITY) { MinSize = MaxSize; LogNotifier.WarnFormat(GetType(), "Unit type {0} ({1}) had a minimum size greater than their maximum size.", Name, ID); } } //// <value> /// Gets or sets the "base size" of a unit, which is the number of troopers the unit has in it for its "base cost". For a lot of units this value will be 0 as the cost is worked out based on the total number of members. /// </value> public int BaseSize { get { return baseSize; } set { baseSize = (value >= 0 ? value : 0); } } /// <value> /// The number of points that a "base unit" of <code>BaseSize</code> models costs. Additional models are charged at <code>CostPerTrooper</code> each. /// </value> public double BaseUnitCost { get { return baseUnitCost; } set { baseUnitCost = (value >= 0 ? value : 0); } } //// <value> /// The cost of an individual trooper. This value is the cost for a basic trooper without weapons, which are added on top of the cost before calculating a unit cost. /// </value> public double CostPerTrooper { get { return costPerTrooper; } set { costPerTrooper = (value >= 0 ? value : 0); } } protected override string DefaultName() { throw new InvalidOperationException("Unit type with id "+id+" did not have a name specified"); } /// <value> /// The <see cref=" Stats"/> for the unit in a format that is valid for the game system. /// </value> public Stats UnitStats { get { return stats; } set { if (value!=null) { stats = value; } } } /// <summary> /// Gets a <see cref="UnitEquipmentItem"/> for the given ID string, or <code>null</code> if nothing exists for that ID /// </summary> /// <param name="id"> /// The ID of the UnitEquipmentItem to get /// </param> /// <returns> /// The <see cref="UnitEquipmentItem"/> for the given ID string, or <code>null</code> if nothing exists for that ID /// </returns> public UnitEquipmentItem GetEquipmentItem(string id) { return (UnitEquipmentItem)equipment[id]; } /// <summary> /// Gets an array of all available <see cref="UnitEquipmentItem"/>s for this UnitType /// </summary> /// <returns> /// An array of all available <see cref="UnitEquipmentItem"/>s for this UnitType /// </returns> public UnitEquipmentItem[] GetEquipmentItems() { UnitEquipmentItem[] items = new UnitEquipmentItem[equipment.Count]; int i = 0; foreach (string itemID in equipmentKeyOrder) { items[i++] = (UnitEquipmentItem)equipment[itemID]; } return items; } public void AddRequirement(UnitRequirement requirement) { requirements.Add(requirement); } public List<FailedUnitRequirement> CanAddToArmy(Army army) { List<FailedUnitRequirement> failures = new List<FailedUnitRequirement>(); if (requirements!=null && requirements.Count > 0) { foreach (UnitRequirement requirement in requirements) { FailedUnitRequirement failure = (FailedUnitRequirement)requirement.CanAddToWarFoundryObject(army); if (failure!=null) { failures.Add(failure); } } } return failures; } public List<FailedUnitRequirement> CanRemoveFromArmy(Army army) { List<FailedUnitRequirement> failures = new List<FailedUnitRequirement>(); if (requirements!=null && requirements.Count > 0) { foreach (UnitRequirement requirement in requirements) { FailedUnitRequirement failure = (FailedUnitRequirement)requirement.CanRemoveFromWarFoundryObject(army); if (failure!=null) { failures.Add(failure); } } } return failures; } public UnitEquipmentItem[] GetEquipmentItemsByExclusionGroup(string group) { ArrayList list = (ArrayList)equipmentExclusionGroups[group]; if (list == null) { return new UnitEquipmentItem[0]; } else { return (UnitEquipmentItem[])list.ToArray(typeof(UnitEquipmentItem)); } } } }