SpriteManager

Introduction

The SpriteManager is a static class which handles Sprite addition, removal, and common behavior. The SpriteManager manages behavior for Sprites and SpriteFrames.

Sprites

The SpriteManager provides numerous methods for for working with Sprites. The following sections provide code samples for working with Sprite-related methods.

Sprite Addition

Most AddSprite methods both instantiate a new Sprite as well as add it to SpriteManager for management.

The following methods instantiate and add a Sprite to the SpriteManager:

Sprite sprite = SpriteManager.AddSprite("redball.bmp"); // "Global" content manager

Sprite sprite = SpriteManager.AddSprite("redball.bmp", "Content Manager Name");

Texture2D texture = FlatRedBallServices.Load<Texture2D>("redball.bmp"); // "Global" content manager
Sprite sprite = SpriteManager.AddSprite(texture);

For information on content managers, see the FlatRedBall Content Manager wiki entry.

Adding Sprites and Layers

Sprites can also be added to Layers.

Layer layer = SpriteManager.AddLayer();

Texture2D texture = FlatRedBallServices.Load<Texture2D>("redball.bmp");

Sprite sprite = SpriteManager.AddSprite(texture, layer);

Sprites which have already been created can be moved to layers. This is commonly performed when loading Scenes.

// Assume sprite is a valid Sprite and layer is a valid Layer
SpriteManager.AddToLayer(sprite, layer);

The Sprite will no longer be an un-layered Sprite. Similarly entire lists can be added:

// Assume scene is a valid Scene that contains Sprites in its Sprites property
// and that layer is a valid Layer.
SpriteManager.AddToLayer(scene.Sprites, layer);

For more information, see the Layer wiki entry.

Sprite Removal

The RemoveSprite methods remove Sprites from the engine as well as any two-way AttachableLists (such as SpriteLists) that the Sprites belong to.

// Assuming sprite is a valid Sprite which has been added to the SpriteManager
SpriteManager.RemoveSprite(sprite);

RemoveSprite can also remove entire lists:

 SpriteList spriteList = new SpriteList();
 // populate SpriteList by adding Sprites to it.

 // This will remove all Sprites contained in spriteList and also
 // clear spriteList if spriteList is a two-way list.
 SpriteManager.RemoveSprite(spriteList);

For more information see AttachableLists.

Managing PositionedObjects

See the PositionedObject wiki entry.

Read Only Lists

The SpriteManager provides read only access to its internal lists for debugging. It is not recommended to directly work with objects through these lists. The following lists the read only lists available:

• AutomaticallyUpdatedSprites
• DrawableBatches
• SpriteFrames
• ManagedPositionedObjects

These are static so you simply access them through the SpriteManager:

for(int i = 0; i < AutomaticallyUpdatedSprites.Count; i++)
{
   // do whatever
}

These lists are used by the ScreenManager to verify that all objects have been destroyed.