![]() |
![]() |
![]() |
Sprite.Draw Method |
Language: |
Adds a sprite to the list of batched sprites.
Visual Basic .NET Public Sub Draw( _
ByVal srcTexture As Texture, _
ByVal srcRectangle As Rectangle, _
ByVal center As Vector3, _
ByVal position As Vector3, _
ByVal color As Integer _
)C# public void Draw(
Texture srcTexture,
Rectangle srcRectangle,
Vector3 center,
Vector3 position,
int color
);Managed C++ public: void Draw(
Texture *srcTexture,
Rectangle srcRectangle,
Vector3 center,
Vector3 position,
int color
);JScript .NET public function Draw(
srcTexture : Texture,
srcRectangle : Rectangle,
center : Vector3,
position : Vector3,
color : int
);
srcTexture Microsoft.DirectX.Direct3D.Texture. A Texture object that represents the sprite texture. srcRectangle System.Drawing.Rectangle. A Rectangle object that indicates the portion of the source texture to use for the sprite. Specify Rectangle.Empty
to use the entire source image for the sprite.
center Microsoft.DirectX.Vector3. A Vector3 structure that identifies the center of the sprite. A value of (0,0,0) indicates the upper-left corner. position Microsoft.DirectX.Vector3. A Vector3 structure that identifies the position of the sprite. A value of (0,0,0) indicates the upper-left corner. color System.Int32. Color value represented as an integer. The color and alpha channels are modulated by this value. A value of 16777215 maintains the original source color and alpha data.
Exceptions
InvalidCallException The method call is invalid. For example, a method's parameter might contain an invalid value. InvalidDataException The data is invalid.
Draw A Sprite
This example demonstrates how to draw a sprite.
To draw a sprite:
- Call Sprite.Begin to prepare the device for drawing sprites.
- Call Sprite.Draw2D to render the sprite.
- 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();
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center