Dynamically Updating Vertex Data

Describes techniques for dynamically updating vertex data in an XNA Framework game.

Geometry in a 3D game is defined by vertex data. Sometimes, a game needs to modify vertex data or even generate new vertex data dynamically (at run time). Here are some solutions for dynamically updating vertex data.

Updating a Set of Primitives Dynamically

The Primitives Sample demonstrates a dynamic vertex buffer that is generated during each rendering frame. The sample renders primitives by first calling Begin, adding the necessary vertices, using the Add method, and then calling End. This forces the buffer to be drawn to the current device. The Flush method calls DrawUserPrimitives method when End is called or when the buffer has no room for new vertices. If there is no room, the buffer is written to the device, it is reset, and the pending vertices are added.

Dynamically Rendering a Persistent Set of Primitives

The Particle 3D Sample, implements a dynamic vertex buffer that contains custom vertices with a limited lifespan. The application adds and removes particles into a fixed length buffer. The custom shader of the sample renders the active subset of vertices dynamically. Because particles have a limited lifespan, the ParticleSystem class handles all adding, updating, and deleting of the vertex buffer in real time.

Generating Geometry Programmatically

Sometimes, your game needs to generate geometry because the geometry is not known at design-time or it changes at run time. For this scenario, create a dynamic vertex and index buffer, and use VertexBuffer.SetData and IndexBuffer.SetData to set or change the data at run time.

Remarks

Create a dynamic vertex or index buffer using DynamicVertexBuffer and DynamicIndexBuffer ; create a static vertex or index buffer using VertexBuffer and IndexBuffer. Use a dynamic buffer for vertex data that is updated every render frame, otherwise, use a static buffer.

The samples are located on the App Hub Web site. For a more advanced solution for dynamic vertex updating, download the Generated Geometry Sample. This sample uses the MeshBuilder helper class and a custom processor to generate a terrain map from a bitmap loaded by the content manager. Specifically, examine the Process method, located in TerrainProcessor.cs, which programmatically creates the terrain geometry based on input from the specified bitmap.