Microsoft DirectX 9.0 SDK Update (October 2004)

Sprite.End Method

Language:

Note: This documentation is preliminary and is subject to change.
How Do I...?

Restores the device to the state it was in before Sprite.Begin was called.

Definition

Visual Basic .NET Public Sub End()
C# public void End();
Managed C++ public: void End();
JScript .NET public function End();

Remarks

Sprite.End cannot be used as a substitute for either Device.EndScene or RenderToSurface.EndScene.

Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value.

How Do I...?

Draw A Sprite

This example demonstrates how to draw a sprite.

To draw a sprite:

  1. Call Sprite.Begin to prepare the device for drawing sprites.
  2. Call Sprite.Draw2D to render the sprite.
  3. Call Sprite.End to signal the end of this batch of sprites.

In the following C# code example, device is assumed to be the rendering Device. The texture variable is a loaded Texture object.

              [C#]
              
sprite.Begin(SpriteFlags.None); sprite.Draw2D(texture, Rectangle.Empty, Rectangle.Empty, new Point(5.0f, 5.0f), Color.White); sprite.End();

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center