Introduction
CustomDestroy is a method that is called once on every Screen/Entity instance when it is no longer needed. Any objects that are created in custom code (as opposed to objects added through Glue) need to be removed/destroyed in CustomDestroy.
Example Usage
Objects which are created in CustomInitialize or CustomActivity must be properly destroyed in CustomDestroy. There are two categories of objects which must be destroyed:
- Entities must have their Destroy method
- Objects added to the engine (like Sprites) must be removed from the engine
The following example shows a Sprite created in CustomInitialize, then later destroyed in CustomDestroy:
// At class scope:
Sprite mSprite;
void CustomInitialize()
{
mSprite = SpriteManager.AddSprite("redball.bmp", ContentManagerName);
}
// ...
void CustomDestroy()
{
SpriteManager.RemoveSprite(mSprite);
}