2010-02-12 23:46:53 +01:00
function ResourceGatherer ( ) { }
2010-04-09 21:02:39 +02:00
ResourceGatherer . prototype . Schema =
2010-04-23 18:09:03 +02:00
"<a:help>Lets the unit gather resources from entities that have the ResourceSupply component.</a:help>" +
"<a:example>" +
2010-07-24 22:26:25 +02:00
"<MaxDistance>2.0</MaxDistance>" +
2010-04-23 18:09:03 +02:00
"<BaseSpeed>1.0</BaseSpeed>" +
"<Rates>" +
"<food.fish>1</food.fish>" +
2010-07-21 20:51:27 +02:00
"<metal.ore>3</metal.ore>" +
"<stone.rock>3</stone.rock>" +
"<wood.tree>2</wood.tree>" +
2010-04-23 18:09:03 +02:00
"</Rates>" +
2010-11-13 20:15:29 +01:00
"<Capacities>" +
"<food>10</food>" +
"<metal>10</metal>" +
"<stone>10</stone>" +
"<wood>10</wood>" +
"</Capacities>" +
2010-04-23 18:09:03 +02:00
"</a:example>" +
2010-07-24 22:26:25 +02:00
"<element name='MaxDistance' a:help='Max resource-gathering distance'>" +
"<ref name='positiveDecimal'/>" +
"</element>" +
2010-04-23 18:09:03 +02:00
"<element name='BaseSpeed' a:help='Base resource-gathering rate (in resource units per second)'>" +
"<ref name='positiveDecimal'/>" +
"</element>" +
"<element name='Rates' a:help='Per-resource-type gather rate multipliers. If a resource type is not specified then it cannot be gathered by this unit'>" +
2010-04-09 21:02:39 +02:00
"<interleave>" +
2010-04-23 18:09:03 +02:00
"<optional><element name='food' a:help='Food gather rate (may be overridden by \"food.*\" subtypes)'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='wood' a:help='Wood gather rate'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='stone' a:help='Stone gather rate'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='metal' a:help='Metal gather rate'><ref name='positiveDecimal'/></element></optional>" +
2010-11-20 22:37:31 +01:00
"<optional><element name='treasure' a:help='Treasure gather rate (only presense on value makes sense, size is ignored)'><ref name='positiveDecimal'/></element></optional>" +
2010-04-23 18:09:03 +02:00
"<optional><element name='food.fish' a:help='Fish gather rate (overrides \"food\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='food.fruit' a:help='Fruit gather rate (overrides \"food\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='food.grain' a:help='Grain gather rate (overrides \"food\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='food.meat' a:help='Meat gather rate (overrides \"food\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='food.milk' a:help='Milk gather rate (overrides \"food\")'><ref name='positiveDecimal'/></element></optional>" +
2010-07-21 20:51:27 +02:00
"<optional><element name='wood.tree' a:help='Tree gather rate (overrides \"wood\")'><ref name='positiveDecimal'/></element></optional>" +
2010-11-12 19:58:33 +01:00
"<optional><element name='wood.ruins' a:help='Tree gather rate (overrides \"wood\")'><ref name='positiveDecimal'/></element></optional>" +
2010-07-21 20:51:27 +02:00
"<optional><element name='stone.rock' a:help='Rock gather rate (overrides \"stone\")'><ref name='positiveDecimal'/></element></optional>" +
2010-11-12 19:58:33 +01:00
"<optional><element name='stone.ruins' a:help='Rock gather rate (overrides \"stone\")'><ref name='positiveDecimal'/></element></optional>" +
2010-11-20 22:37:31 +01:00
"<optional><element name='metal.ore' a:help='Ore gather rate (overrides \"metal\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='treasure.food' a:help='Food treasure gather rate (overrides \"treasure\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='treasure.wood' a:help='Wood treasure gather rate (overrides \"treasure\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='treasure.stone' a:help='Stone treasure gather rate (overrides \"treasure\")'><ref name='positiveDecimal'/></element></optional>" +
"<optional><element name='treasure.metal' a:help='Metal treasure gather rate (overrides \"treasure\")'><ref name='positiveDecimal'/></element></optional>" +
2010-04-09 21:02:39 +02:00
"</interleave>" +
2010-11-13 20:15:29 +01:00
"</element>" +
"<element name='Capacities' a:help='Per-resource-type maximum carrying capacity'>" +
"<interleave>" +
"<element name='food' a:help='Food capacity'><ref name='positiveDecimal'/></element>" +
"<element name='wood' a:help='Wood capacity'><ref name='positiveDecimal'/></element>" +
"<element name='stone' a:help='Stone capacity'><ref name='positiveDecimal'/></element>" +
"<element name='metal' a:help='Metal capacity'><ref name='positiveDecimal'/></element>" +
"</interleave>" +
2010-04-09 21:02:39 +02:00
"</element>" ;
2010-02-12 23:46:53 +01:00
ResourceGatherer . prototype . Init = function ( )
{
2010-11-13 20:15:29 +01:00
this . carrying = { } ; // { type: integer amount currently carried }
// (Note that this component supports carrying multiple types of resources,
// each with an independent capacity, but the rest of the game currently
// ensures and assumes we'll only be carrying one type at once)
2010-11-13 22:39:39 +01:00
// The last exact type gathered, so we can render appropriate props
this . lastCarriedType = undefined ; // { generic, specific }
2010-11-13 20:15:29 +01:00
} ;
/ * *
* Returns data about what resources the unit is currently carrying ,
* in the form [ { "type" : "wood" , "amount" : 7 , "max" : 10 } ]
* /
ResourceGatherer . prototype . GetCarryingStatus = function ( )
{
var ret = [ ] ;
for ( var type in this . carrying )
{
ret . push ( {
"type" : type ,
"amount" : this . carrying [ type ] ,
"max" : + this . template . Capacities [ type ]
} ) ;
}
return ret ;
} ;
/ * *
* Returns the type of one particular resource this unit is
* currently carrying , or undefined if none .
* /
ResourceGatherer . prototype . GetMainCarryingType = function ( )
{
// Return the first key, if any
for ( var type in this . carrying )
return type ;
return undefined ;
2010-02-12 23:46:53 +01:00
} ;
2010-11-13 22:39:39 +01:00
/ * *
* Returns the exact resource type we last picked up , in the form
* { generic , specific }
* /
ResourceGatherer . prototype . GetLastCarriedType = function ( )
{
return this . lastCarriedType ;
} ;
2010-02-12 23:46:53 +01:00
ResourceGatherer . prototype . GetGatherRates = function ( )
{
var ret = { } ;
for ( var r in this . template . Rates )
ret [ r ] = this . template . Rates [ r ] * this . template . BaseSpeed ;
return ret ;
} ;
ResourceGatherer . prototype . GetRange = function ( )
{
2010-07-25 00:09:59 +02:00
return { "max" : + this . template . MaxDistance , "min" : 0 } ;
2010-02-12 23:46:53 +01:00
// maybe this should depend on the unit or target or something?
}
2010-11-20 22:37:31 +01:00
/ * *
* Try to gather treasure
* @ return 'true' if treasure is successfully gathered and 'false' in the other case
* /
ResourceGatherer . prototype . TryInstantGather = function ( target )
{
var cmpResourceSupply = Engine . QueryInterface ( target , IID _ResourceSupply ) ;
var type = cmpResourceSupply . GetType ( ) ;
if ( type . generic != "treasure" ) return false ;
var status = cmpResourceSupply . TakeResources ( cmpResourceSupply . GetCurrentAmount ( ) ) ;
var cmpPlayer = QueryOwnerInterface ( this . entity , IID _Player ) ;
cmpPlayer . AddResource ( type . specific , status . amount ) ;
var cmpStatisticsTracker = QueryOwnerInterface ( this . entity , IID _StatisticsTracker ) ;
if ( cmpStatisticsTracker )
cmpStatisticsTracker . IncreaseTreasuresCollectedCounter ( ) ;
return true ;
} ;
2010-02-12 23:46:53 +01:00
/ * *
* Gather from the target entity . This should only be called after a successful range check ,
* and if the target has a compatible ResourceSupply .
* It should be called at a rate of once per second .
* /
ResourceGatherer . prototype . PerformGather = function ( target )
{
2010-07-08 22:08:08 +02:00
var rate = this . GetTargetGatherRate ( target ) ;
if ( ! rate )
return { "exhausted" : true } ;
2010-02-12 23:46:53 +01:00
var cmpResourceSupply = Engine . QueryInterface ( target , IID _ResourceSupply ) ;
var type = cmpResourceSupply . GetType ( ) ;
2010-11-13 20:15:29 +01:00
// Initialise the carried count if necessary
if ( ! this . carrying [ type . generic ] )
this . carrying [ type . generic ] = 0 ;
2010-02-12 23:46:53 +01:00
2010-11-13 20:15:29 +01:00
// Find the maximum so we won't exceed our capacity
var maxGathered = this . template . Capacities [ type . generic ] - this . carrying [ type . generic ] ;
var status = cmpResourceSupply . TakeResources ( Math . min ( rate , maxGathered ) ) ;
this . carrying [ type . generic ] += status . amount ;
2010-11-13 22:39:39 +01:00
this . lastCarriedType = type ;
2010-11-13 20:15:29 +01:00
// Update stats of how much the player collected.
// (We have to do it here rather than at the dropsite, because we
// need to know what subtype it was)
var cmpStatisticsTracker = QueryOwnerInterface ( this . entity , IID _StatisticsTracker ) ;
if ( cmpStatisticsTracker )
cmpStatisticsTracker . IncreaseResourceGatheredCounter ( type . generic , status . amount , type . specific ) ;
2010-07-21 18:09:58 +02:00
// Tell the target we're gathering from it
Engine . PostMessage ( target , MT _ResourceGather ,
{ "entity" : target , "gatherer" : this . entity } ) ;
2010-11-13 20:15:29 +01:00
return {
"amount" : status . amount ,
"exhausted" : status . exhausted ,
"filled" : ( this . carrying [ type . generic ] >= this . template . Capacities [ type . generic ] )
} ;
2010-02-12 23:46:53 +01:00
} ;
2010-07-08 22:08:08 +02:00
/ * *
* Compute the amount of resources collected per second from the target .
* Returns 0 if resources cannot be collected ( e . g . the target doesn ' t
* exist , or is the wrong type ) .
* /
ResourceGatherer . prototype . GetTargetGatherRate = function ( target )
{
var cmpResourceSupply = Engine . QueryInterface ( target , IID _ResourceSupply ) ;
if ( ! cmpResourceSupply )
return 0 ;
var type = cmpResourceSupply . GetType ( ) ;
var rate ;
if ( type . specific && this . template . Rates [ type . generic + "." + type . specific ] )
rate = this . template . Rates [ type . generic + "." + type . specific ] ;
else
rate = this . template . Rates [ type . generic ] ;
return ( rate || 0 ) * this . template . BaseSpeed ;
}
2010-02-12 23:46:53 +01:00
2010-11-13 20:15:29 +01:00
/ * *
* Returns whether this unit can carry more of the given type of resource .
* ( This ignores whether the unit is actually able to gather that
* resource type or not . )
* /
ResourceGatherer . prototype . CanCarryMore = function ( type )
{
var amount = ( this . carrying [ type ] || 0 ) ;
return ( amount < this . template . Capacities [ type ] ) ;
} ;
/ * *
* Returns whether this unit is carrying any resources of a type that is
* not the requested type . ( This is to support cases where the unit is
* only meant to be able to carry one type at once . )
* /
ResourceGatherer . prototype . IsCarryingAnythingExcept = function ( exceptedType )
{
for ( var type in this . carrying )
if ( type != exceptedType )
return true ;
return false ;
} ;
/ * *
* Transfer our carried resources to our owner immediately .
* Only resources of the given types will be transferred .
* ( This should typically be called after reaching a dropsite ) .
* /
ResourceGatherer . prototype . CommitResources = function ( types )
{
var cmpPlayer = QueryOwnerInterface ( this . entity , IID _Player ) ;
for each ( var type in types )
{
if ( type in this . carrying )
{
cmpPlayer . AddResource ( type , this . carrying [ type ] ) ;
delete this . carrying [ type ] ;
}
}
} ;
/ * *
* Drop all currently - carried resources .
* ( Currently they just vanish after being dropped - we don ' t bother depositing
* them onto the ground . )
* /
ResourceGatherer . prototype . DropResources = function ( )
{
this . carrying = { } ;
} ;
2010-02-12 23:46:53 +01:00
Engine . RegisterComponentType ( IID _ResourceGatherer , "ResourceGatherer" , ResourceGatherer ) ;