Difference between revisions of "CreatePool"
BryanDerksen (Talk | contribs) |
BryanDerksen (Talk | contribs) (trying out the dafunction formatting) |
||
Line 1: | Line 1: | ||
− | + | Reserves a block of memory for a fixed number of a particular type of creature | |
+ | |||
+ | <div style="background:#DDDDDD;"> | ||
+ | [[int]] CreatePool ( | ||
+ | :: [[resource]] rTemplate, | ||
+ | :: [[int]] nPoolSize | ||
+ | :) | ||
+ | </div> | ||
+ | |||
+ | <dl> | ||
+ | <dt>Parameters: | ||
+ | <dd> | ||
+ | <dl> | ||
+ | <dt>rTemplate<dd>The template to use | ||
+ | <dt>nPoolSize<dd>Number of creatures of this type to create | ||
+ | </dl> | ||
+ | <dt>Returns: | ||
+ | <dd>TRUE if successful | ||
+ | <dt>Source: | ||
+ | <dd>[[scripts.ldf]] | ||
+ | </dl> | ||
+ | |||
+ | == Description == | ||
+ | |||
+ | Creatures of this type that are spawned with the CreateObject function in this area will use this block of memory, and when creatures of this type die or are set inactive their memory space will automatically be returned to the pool. | ||
The purpose of this function is to allow for endlessly respawning monsters, or similar situations. | The purpose of this function is to allow for endlessly respawning monsters, or similar situations. | ||
− | It should be used under EVENT_TYPE_AREALOAD_PRELOADEXIT. When creatures die or are set inactive they will automatically return to the pool. | + | It should be used under [[EVENT_TYPE_AREALOAD_PRELOADEXIT]]. When creatures die or are set inactive they will automatically return to the pool. |
Note that pool creatures should have "no permanent death" enabled, otherwise certain effects (such as decapitation) will remain on them when they respawn. | Note that pool creatures should have "no permanent death" enabled, otherwise certain effects (such as decapitation) will remain on them when they respawn. | ||
Line 9: | Line 33: | ||
Pool size should be at least twice the number of enemies from that will ever be active simultaneously. | Pool size should be at least twice the number of enemies from that will ever be active simultaneously. | ||
− | < | + | <!-- == Examples == --> |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | <!-- == Known bugs == --> | |
− | + | <!-- == See also == --> | |
[[Category:Scripts]] | [[Category:Scripts]] |
Revision as of 20:42, 21 July 2009
Reserves a block of memory for a fixed number of a particular type of creature
- Parameters:
-
- rTemplate
- The template to use
- nPoolSize
- Number of creatures of this type to create
- Returns:
- TRUE if successful
- Source:
- scripts.ldf
Description
Creatures of this type that are spawned with the CreateObject function in this area will use this block of memory, and when creatures of this type die or are set inactive their memory space will automatically be returned to the pool.
The purpose of this function is to allow for endlessly respawning monsters, or similar situations.
It should be used under EVENT_TYPE_AREALOAD_PRELOADEXIT. When creatures die or are set inactive they will automatically return to the pool.
Note that pool creatures should have "no permanent death" enabled, otherwise certain effects (such as decapitation) will remain on them when they respawn.
Pool size should be at least twice the number of enemies from that will ever be active simultaneously.