Microsoft DirectX 8.1 (Visual Basic)

D3DXSprite.Begin

Prepares a device for drawing sprites.

object.Begin()

Parts

object
Object expression that resolves to a D3DXSprite object.

Error Codes

If the method fails, an error is raised and Err.Number can be set to one of the following values.

D3DERR_INVALIDCALL
D3DXERR_INVALIDDATA

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

Calling Begin is optional. If called outside of a Begin/End sequence, the draw functions internally call Begin and End. To avoid extra overhead, this method should be used if more than one draw function is called successively.

This method must be called from inside a Direct3DDevice8.BeginScene and Direct3DDevice8.EndScene sequence.

D3DXSprite.Begin cannot be used as a substitute for either Direct3DDevice8.BeginScene or D3DXRenderToSurface.BeginScene.

See Also

D3DXSprite.End