MULTIMEDIA

DirectX 10 Game Programming : 3D Introduction - Drawing a Triangle

2/24/2013 6:51:32 PM

The order in which the vertices appear in the vertex buffer is important. When Direct3D is drawing, the order the vertices are used is based on their order within the vertex buffer. Ordering the vertices in a haphazard way can cause objects to appear to be missing sides.

The rendering of an object defined by a vertex buffer is easy. Techniques can consist of one or more passes. When drawing, you need to loop through these passes and apply the technique to each pass and then draw the vertices in the vertex buffer. This allows the vertices to be drawn based on the currently active technique. The following code shows a simple drawing call that uses an effect technique.

// Bind the vertex buffer and set the input layout before drawing
// Set the input layout
pD3DDevice->IASetInputLayout(modelObject->pVertexLayout);

// Set vertex buffer
UINT stride = sizeof(VertexPosStruct);
UINT offset = 0;
pD3DDevice->IASetVertexBuffers(0,
    1,
    &modelObject->pVertexBuffer,
    &stride,
    &offset);

// Set primitive topology
pD3DDevice->IASetPrimitiveTopology(D3D10_PRIMITIVE_TOPOLOGY_TRIANGLELIST);

// Render an object
D3D10_TECHNIQUE_DESC techniqueDescription;
pTechnique->GetDesc(&techniqueDescription);

// Loop through the technique passes
for(UINT p=0; p < techniqueDescription.Passes; ++p)
{
    pTechnique->GetPassByIndex(p)->Apply(0);
    pD3DDevice->Draw(numVertices, 0);
}

					  

Topology

At this point, Direct3D knows you have a vertex buffer and it knows you want to draw the vertices, but it is still unsure how those vertices should be drawn. Direct3D supports multiple ways of drawing the same set of vertices. Your vertices can be drawn as a series of individual triangles, as a series of lines, or as interconnected triangles with each depending on the one before it. How the vertices are drawn is referred to as primitive types or topology.

The topology determines how the vertices that make up an object are used. If you draw the vertices as a series of individual triangles, that is called a triangle list. A bunch of interconnected triangles is called a triangle strip. A triangle strip takes three vertices to create the first triangle, but only one vertex is needed to define the second and subsequent triangles. When optimizing your drawing, it is best to send as little information to be drawn as possible.

The topology is set using the IASetPrimitiveTopology function. This function takes only a single parameter and should be used before the vertices in a buffer are sent to be drawn.

// Set primitive topology
pD3DDevice->IASetPrimitiveTopology(D3D10_PRIMITIVE_TOPOLOGY_TRIANGLELIST);

Some of the acceptable values that can be sent to the IASetPrimitiveTopology function are:

  • D3D10_PRIMITIVE_TOPOLOGY_POINTLIST— the vertices are a series of unconnected points in space.

  • D3D10_PRIMITIVE_TOPOLOGY_TRIANGLELIST— a collection of unconnected triangles.

  • D3D10_PRIMITIVE_TOPOLOGY_TRIANGLESTRIP— a series of interconnected triangles.

A few more values can be found in the DirectX SDK help documents.

The Draw Function

The Draw function is the final step needed to get your object on the screen. Draw requires only two parameters.

The first parameter is the number of vertices that are to be drawn. Most of the time, this will reflect the number of vertices within your vertex buffer.

The second parameter is the starting vertex index. You don’t have to draw all the vertices within a buffer, so this value allows you to start anywhere.

pD3DDevice->Draw(numVertices, 0);
Figure 1 shows what the triangle will look like when it’s drawn.
Figure 1. The final triangle being drawn.


Collecting the Common Items

When you get to the point where you’re drawing more than one object, the number of variables needed for each object starts to get out of hand. I’ve collected the variables used for each object into a single structure type called ModelObject. All the information Direct3D needs to properly store and draw an object can be stored in ModelObject. Using ModelObject you can create a single object cleanly or even create multiple objects.

typedef struct
{
    // Shader variables
    ID3D10Effect* pEffect;
    ID3D10EffectTechnique* pTechnique;

    // Vertex information
    ID3D10Buffer* pVertexBuffer;
    UINT numVertices;
    ID3D10InputLayout* pVertexLayout;
}ModelObject;
Other  
 
Most View
Windows Small Business Server 2011 : Installing the Second Server (part 4) - Enable Updates and Feedback
Use The Same Password On More Than One Site? You’re Not Alone
Take Control Of Autoplay Settings
Alternative iOS Browsers for iPad, iPhone and iPod Touch (Part 3)
ASP.NET 4.0 : Data Source Components (part 6) - The LinqDataSource Class - The Goal of LinqDataSource , Programming Interface of the LinqDataSource Control
Moving into SAP Functional Development : Gaining Control of Change Control - Change Management Best Practices and Approaches (part 3)
Holiday Gift Guide 2013 - Interesting Stuffs
Zalman FX100-Cube Fanless Cooler
Linux vs Windows 8 (Part 5)
Haswell Ultrabooks Shootout Featherweight Battle Royale (Part 1) - Acer Aspire S7, ASUS ZENBOOK UX301
Top 10
Installing and Configuring Windows Server 2008 R2 : Performing postinstallation tasks (part 5) - Configuring disk drives - Creating a RAID 5 volume
Installing and Configuring Windows Server 2008 R2 : Performing postinstallation tasks (part 4) - Configuring disk drives - Creating a mirrored volume
Installing and Configuring Windows Server 2008 R2 : Performing postinstallation tasks (part 3) - Configuring disk drives - Basic disks versus dynamic disks, Dynamic disk volumes
Installing and Configuring Windows Server 2008 R2 : Performing postinstallation tasks (part 2) - Windows Server 2008 R2 roles
Installing and Configuring Windows Server 2008 R2 : Performing postinstallation tasks (part 1) - Configuring initial settings, Understanding roles and features
The Lamborghini Huracan : Raging Bull goes to the ballet
Porsche 911 Turbo charges into town
The Long Road To Success - Aston Martin Vanquish - Rapidely Gaining Interest - Aston Martin Rapide S (Part 3)
Extra-Curricular Activity - BMW 218d Active Tourer SE - An Engine That’s Fit For A Juke - Nissan Juke Tekna DIG-T (Part 3)
The Long Road To Success - Aston Martin Vanquish - Rapidely Gaining Interest - Aston Martin Rapide S (Part 2)