ConvertToManuallyUpdated
Introduction
The ConvertToManuallyUpdated method allows for the conversion of an automatically updated object to a manually updated object. Objects can be made manually updated so that they are still rendered by the engine, but automatic updates won't be performed. This can be done to improve performance. At the time of this writing, the following types can be converted to manually updated objects:
FlatRedBall.PositionedObject (this includes Entities in Glue)
What does converting to manually updated do?
Converting a Sprite or PositionedObject to a manually updated disables the application of:
Velocity
Acceleration
Drag
RotationZVelocity
RelativeVelocity
Attachments
Instructions
Animations
Furthermore, the engine assumes that manually updated Sprites will not change very often. Therefore, it pre-calculates the vertices needed for rendering and caches them. If a Sprite does actually get updated, then it will need to have these vertices re-calculated. This can be performed through the ManualUpdate method.
Moving Manually-Updated Sprites
If a Sprite is moving and it is manually updated, then it will not visually reflect the movement unless:
ManualUpdate is called
The Sprite is converted back to being an automatically updated Sprite using ConvertToAutomaticallyUpdated
When to convert
In short, an object should be manually updated if it does not need automatic updates. This can improve performance. For more information, see the manually updated objects tutorial.
Last updated