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:

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:

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