Graphic Stream : Maths 3D

Smart Terrain Rendering with Xna using Billod algorithm

valentin — Tue, 30 Sep 2008 12:13:00 GMT

Version Française ici.

If you're a game developer you've already worked on terrain rendering. It is, in my opinion the critical point of a game. Not because conceptually speaking it is the most important visible thing on the screen but because it is the main factor playing on the performance and quality of your application. It is therefore important to use techniques designed to minimize the burden borne by your game to view the ground while preserving its quality display. This article shows a way that attempts to answer this question in XNA.

Conducting a study of game engine designed to help game developers in the Imagine Cup competition, I naturally preferred this important aspect in seeking a way to display a 3D world unlimited real size with an acceptable level of detail.

There are many techniques for displaying world explained by interesting articles. These are often based on a compromise uncomfortable wearing a choice between the size of land or quality level. In addition, they are often prohibitive algorithms.

This article does not appear as the only possible response to the display ground XNA but would just provide an effective solution running for this technology knowing that most of the examples existing on the Web are made in DirectX and OpenGL.

We will split our study in several phases:

· First we describe the problems posed by the display of land and explain the need for optimization.

· We then describe the method used to cut our land into a QuadTree.

· We will explain how we reduce the retail field at distance while keeping up its appearance nearby.

· We will describe a more technical implementation of this technique

· Finally we will see possible optimizations offered to the reader.

The problem

Let's say we wanted to model a land about 10 km by 10km with a degree of detail about 1 meter (1 kilometer = 1000 meters). So we have (without optimization) a grid of 100000 * 100000 to show. We have to specify that that each vertex of the grid has a memory size equal to approximately 40 bytes. It reaches about 4 gigabytes of data to display. The hardware of a lambda PC cannot handle such loads memory. Another problem, such a field modeled in a grid rendering static demand of 200 million triangles per frame. This is a disaster. From the moment the size of the field becomes important and where we add the ground ingredients of usual games, as 3D models, an user interface, animations, performance of a game can no longer follow. This is here, that we have to manage a smart rendering.

It is therefore important that the CPU and / or GPU taken by the display field is as low as possible to keep processing time for other needs of the game. The virtual world offered by most modern games are huge and cannot be done with a simple static grid

The need for optimization is therefore evident. I invite readers to visit http://ww.vterrain.org to discover some presentations techniques other than that presented here.

If we had a specification to comply, we would have:

· Keep the appearance of the ground up by reducing as much as possible the burden with its display.

· Make the management of land by the code clean and accessible.

· Using a technique efficient, simple and fast.

· Respecting a QuadTree to optimize performance and meet the needs of treatment games.

Keep appearance with 100 times less resources, is a beautiful goal!.

The QuadTree

The first step is to manage our future terrain through a QuadTree.

A QuadTree is a data type tree in which each node can have up to four children. The Quadtrees are most often used to split a two-dimensional (3D abscissa and depth) by recursively subdivided into four knots. Each node has 4 children and so on. The route of such a tree is simple and takes on average the same time : for each level, there is a maximum of 4 tests to be "allowed" to navigate into lower level. This is important given the task before us here: "Show ground with maximum details using minimal resources.". The goal is to minimize the course of such a tree through its hubs in making these tests smart and simple.

Principle

The QuadTree (often used for rendering the field) provides an intelligent answer to the problem of optimization. First it loads the data only when needed. Then, the burden caused by the representation of a node on the screen depends on the depth of the node in the tree. Therefore, the sooner it is estimated that a node not be displayed in the course of a tree, the greater the optimization of display is realized (we limit the same time the number of triangles to display ). We will explain it all over this article.

More on sinking into the tree, more precision displayed with refined detail.

The real question to be asked to optimize the display of our tree is "what tests should be performed to determine the appropriateness of displaying a node on the screen”. We will see this as soon as possible. For now let us concentrate on how we manage the tree in our code.

Display the tree

Initially our terrain is only rendered by a single node (see picture above). The node size will be equals to the size of the terrain. A node on the screen corresponds to a surface composed of 9 square vertices:

1. Nord North

2. Nord Est North East

3. Est East

4. Sud Est South East

5. Sud South

6. Sud Ouest South West

7. Ouest West

8. Nord Ouest North West

9. Centre Center

A node is composed of 9 vertices

The QuadTree will be based on a heightfield (a two-dimensional array containing all the heights of each vertex Y on the screen). Each vertex of each node in the QuadTree has a height whose value is drawn from the heightfield.

Initially, only the corner of a node are visible, namely: North East, South East, North West, South West. Its rendering is similar to the following picture:

The shaded vertices are visible vertices

These four vertices displayed allow us to draw two triangles form the surface of square knot. For each update of the terrain, for each node currently visible, we calculate the visibility of each of the vertices. Each update of a node is accompanied by a redrawing of triangles that make it up. he following picture explicit some possible configurations for a node:

The algorithm for this part would be:

/ / For each of the vertices North, East, South, West

If ( !Vertex.Visible && VertexTest())

Vertex.Visible = true ;

Else if (Vertex.Visible && !VertexTest())

Vertex.Visible = false;

The test of this algorithm takes into account the distance of the vertex from the camera and the growing need for detail as the camera approached it. We will see the nature of this test later.

In a second step it is necessary to calculate the visibility of children of current node. A node consists of four children as the next picture shows:

Here we have shown the North East of child root node, then the child South East of it, then the child of the South East last child finally North West of it.

The more one penetrates deep into the QuadTree over the mesh tightens and will display a more detailed terrain.

The algorithm for this part at this stage of our study would be:

// For each of the four children North West, North East, South West, South East

If ( !Child.Visible && ChildTest())

Child.Visible = true ;

Else if (Child.Visible && ! ChildTest())

Child.Visible = false;

Once again, the test of this algorithm takes into account the distance to which the child and the growing need for detail as the camera approached it. We will see the nature of this test later.

When a child is exposed, its vertices and his own children are subject to two algorithms that we have just seen. We are therefore in a principle of recursion.

We compute the triangles that’s makes a node by not taking into account the parts overshadowed by children:

We note here that the vertices North and East of the parent shared with the vertices North West and South West of the child. We will see that later.

The basic principle of the Billod algorithm is relatively simple. Vertices et enfants à afficher sont soumis à chaque mise à jour du terrain à un ensemble de tests qui déterminent leur visibilité. Vertices and children are subjected, at each updated of the terrain, to a set of tests that determine their visibility. The display of a node node is a recursive set of instructions that goes through the QuadTree along the root node to each leaf node of each branch.

Improvements

We talked previously shared vertices between a child and a parent. The previous image illustrates this point. This may cause an unpleasant graphic bug illustrated by the image below:

Or, with wireframe:

This problem is due to the non-activation of a vertex in the neighboring node. The nodes affected by this bug are:

So in reality:

The West vertex of the child red is activated but not the vertex of the yellow child. There is therefore a delta between the two sides of the two children. To resolve this bug simply validate the vertex of the child is yellow:

Finally we get a perfect continuity:

Now imagine that the southern vertex of the yellow child becomes visible. The parent node has only two children north west and north east. Activating this vertex pose the same problem as before graph:

Unfortunately, unlike the previous case, there are no children in the South West. It is therefore necessary to create a child to this position (although the "ChildTest” of our algorithm for that child returns false) and to activate its North vertex:

The addition of southern vertex of the white child led to the creation of the Child South West and the activation of southern vertex parent node. The vertex South may itself cause the modification of neighboring nodes. There are, here, some cascading effects that are not really controllable but, fortunately, limited. The following image shows the impact of activation of several children deep into the QuadTree at the bottom right of the terrain.

We note that the nodes located at the opposite are impacted.

Managing nodes in the QuadTree

Some years ago I read an excellent article by a person named Stan Melax author of an ingenious technique for calculating a dynamic aspect of a 3D model at different levels of resolution. The articles on progressive meshes are subject to the same laws as those on land: either the reduction algorithm is too complicated or it is inappropriate. Stan Melax found a clever way to solve this problem. He studies the cost the disappearance of each vertex by studying their impact on the overall shape. He is then able to gradually reduce the resolution of the 3D model by removing vertices in a logical order with the less impact. Its strength lies in the calculation of the cost of a vertex which proves to be a simple and effective. We will proceed the same way.

The curve : Element to remember

To explain simply : We measure a terrain to its forms. We measure a form to its curves. The question is then: how to define a curve ?. Answering this question would determine the locations of the terrain where we must keep an important retail level and those that can be degraded.

There are many techniques to transform a curve into a mathematical function. We return in this case to the beginning problem: Do not overload the processor too much. We have seen, it is necessary to execute the formula found at all vertices and all children nodes. A formula that generates a lot of instructions will deteriorate application performance.

The solution is simple. We have said that our land is splitted into a set of nodes belonging to a tree. Each curve of the land therefore consists of nodes that are actually surfaces square whose size varies

The terrain is a set of curves visible on the screen. Each curve is an assembly of square knots coast to coast glued.

The normal, order of magnitude of a curve

Plus la courbe est importante, plus les nœuds qui la composent forment un angle important. The greater the curve is, the greater the angles made by its nodes are important. Take for example a curve :

It shows all nodes glued side by side. At the place where the curve is really important we find nodes that form an angle. In contrast to where there is no curve, but a simple slope, nodes coast to coast appear to belong to the same plane. We noticed even more if we show each normals nodes:

We are now close to finding the formula! All the students know that the mathematical function that measures the angle between two vectors is the dot product.

The inner product of two vectors represented by non-zero vectors A and B is the actual number ABcos (θ) if the angle θ is the angle formed between the two lines whose direction are represented by the two vectors.

The maximum angle that can be found in a curve of land as we conceive it tends to 90 degrees (90 degrees value cannot be achieved because nodes can’t overlap). Cos 90 equal 0 so we can infer that when the curve formed by the vectors is important, their dot product approach 0 (A * B * Cos (90) = A * B * 0 = 0). On the contrary if the value of inner product increases, is that the curve formed by the two nodes tend toward the "right" (A * B * Cos (0) = A * B * 1 = AB). See this picture:

The inner product between the normal parent and child will return here a value far away from 0 : we are on a surface, certainly inclined, but plane. Needless to cut the node.

Consider now a pronounced curve :

The angle between the three normals is more pronounced. The original node (symbolized by the black dotted line) should be divided into sub-nodes. We can found in this process a certain logic: a flat surface is easily modeled with few polygons. A curved surface ask for much. Here to complete the wireframe curve:

Where the curve is more pronounced, our technique uses more primitives

Activation

Child Test method should compare the normal of the children to test with the normal of the parent node to which it belongs. If the angle between the two normal exceeds a threshold when the method returns true.

Disabling

Disabling a child occurs when a series of factors are met:

· The child has no longer visible vertices

· The child has more sub-children

· The test method returns false.

Enable/Disable switch node in the vertex

Interpolated to real

La gestion de la visibilité des vertices ne suit pas la même logique que celle décrite précédemment. The management of the vertices visibility does not follow the same logic as that described above. Here there is no curves but delta. Only vertices on the sides of a node are to be tested. So the North, East, South, West vertices. When a node is created, this vertices are not visible. But they are located between two vertices on node edge and so, we can deduce their height easily. Here is an example of node viewed from the side:

It shows the vertices North West and South West enabled (visible)) and West vertex disabled.

The West vertex seems to be on the right along the two summits. In real, it may not. For now we have interpolated (deducted) its position (If South West is at a height of 10 and North West at a height of 20, it is reasonable to assume that the West vertex will be at a height of 15). Yet in reality, it is may be at another height:

There is a distance between the delta position of vertex West interpolated its actual position. This difference in height measures the degree of reality of the node currently displayed with a more detailed version.

View node with only the 4 vertices summits displayed therefore does not adequately reflect the reality on the ground displayed by the node.

Way of activation

The activation method is very simple, we only need to determine the Delta value (a simple difference of heights) and determine if it exceeds a threshold too.

Test of disabling

Disabling a vertex is only when a series of factors are met:

· The vertex is used by a child node

· The test method returns false.

Progressive Details

It was one of the prerequisites for our technology, we must optimize the display according to the camera position. At this point, our two functions tests (for vertices and children nodes) do not take into account the camera position and the position of the element to test.

We have seen in the two algorithms dedicated to the vertices and nodes, that test is performed to determine if a vertex or child should be displayed or not. The land must be displayed according to the camera position for the comfort of the player. The more an area of land is close to the camera the more it have to be detailed. It also aims to preserve up to the appearance of the terrain away with a minimum of vertices and gradually detail when the camera comes.

Detail for progressive QuadTree

For the time the testing method is based on the angle made between the normal of a child with its parent. This procedure is not necessarily relevant distance.

If a few degrees angle is visible when you are close to the nodes that make up this angle is not necessarily detectable at a distance It is not necessary to activate the child.

Here is the implementation of this test method:

private bool ChildTest(Vector3 childNormal, BoundingBox boundingBox, Vector3 cameraPosition)

{

//by default, the four childs of the root node are visible.

if (this.Depth < 1)

return true;

//get the closest point to the camera and check the distance

float distanceCameraToPoint = Vector3.Distance(GetBoundingBoxClosestPointToPoint(boundingBox, cameraPosition), cameraPosition);

//compute the dot product between parent normal and child normal

float dotprod = 1 - Vector3.Dot(childNormal, this.CenterVertex.Value.Normal);

//check with the threshold

return (distanceCameraToPoint / this.ParentTree.QuadTreeDetail) < (dotprod);

}

By default nodes at the top of the tree are made visible. We then determine the distance between the camera position and the nearest point of it in the BoundingBox encompassing child. The dot product is then calculated. We test the division of this distance by an adjustable threshold is below the dot product.

Note that this method of testing may well be adapted to submit the QuadTree to another technique optimization.

Progressive detail for the vertex

Again, the testing method for vertices does not take into account the distance to the camera. We must determine if the distance between the actual position of the vertex and its position interpolated exceeds a threshold configurable.

Here is the testing method:

public bool VertexTest(Vector3 vertexPosition, Sides side, Vector3 cameraPosition)

{

//get the distance between interpolated height position and real height position

float lengthToTest = this._realToInterpolatedVertexHeight[(int)side];

//get the distance from the camera position to the vertex position

float distanceCameraToPoint = Vector3.Distance(vertexPosition, cameraPosition);

//check with the threshold

return lengthToTest * this.ParentTree.VertexDetail > distanceCameraToPoint;

}

The delta between the two vertices (interpolated and real) is stored in memory. We then determine the distance between the vertex and the camera. A test is then conducted to determine if the Delta exceeds the threshold distance to the camera. Like earlier this test method may well be adapted to submit the vertices of each node to another technique optimization.

A field at different level of detail, from left to right: 7500, 3000, 1500, 300 150 vertices

Improvements

Our algorithm at this stage works perfectly: it displays the details where they are relevant, frees up resources and uses a quadtree.

Remember that time, the relevance of viewing a node is measured using the dot product of its normal with normal direct its parent. This is rather good, but we can improve. The following pictures illustrate a graphic unpleasant bug that modifies the appearance of ground within walking distance:

In front of us: a slight bump on the ground

The hump has been truncated

Note that the bump on the first visible image is greatly reduced by the mere fact of having moved slightly camera. But our algorithm has worked here perfectly. We simply validated a threshold requiring a node to be cut. So we need to reduce the implementation of our algorithm close to the camera. We will therefore introduce a second threshold that will represent what we mean by "proximity".

The new test function is thus as follows:

private bool ChildTest(Vector3 childNormal, BoundingBox childBoundingBox, Vector3 cameraPosition)

{

//by default, the four childs of the root node are visible.

if (this.Depth < this.ParentTree.MinimalDepth)

return true;

//get the closest point to the camera and check the distance

float distanceCameraToPoint = Vector3.Distance(GetBoundingBoxClosestPointToPoint(childBoundingBox, cameraPosition), cameraPosition);

//compute the dot product between parent normal and child normal

float dotprod = 1 - Vector3.Dot(childNormal, this.CenterVertex.Value.Normal);

//check with the threshold

return ((distanceCameraToPoint - this.ParentTree.QuadTreeDetailAtFront ) / this.ParentTree.QuadTreeDetailAtFar) < (dotprod);

}

We now have two thresholds, a threshold of visibility for “near displays” to maximize the details close to the camera and a threshold of “far display” that manages the details beyond the previous threshold according to a affine function as we did until now.

The advantage is undeniable. For proof, just take a look at the picture below:

I went to the center of the terrain, I stopped the implementation of the algorithm (similar to a pause in the Update of the QuadTree) and take some the altitude. We notice that the details seem to diminish when away from the center. This is indeed the case:

At the center of the screen near the crater, the details are at maximum. If we were on the ground, we do not see any ground near bump be changed by moving the camera. On the contrary, the far away details keeps the overall look of the land.

It's not all, we are now able to generate a climate and geographical well known: a mountain line (sorry I do not know the English term for “ligne bleue”). Look at this picture:

It is the blue line Vosges clearly visible from the north of “Franche-Comte” in France. Plus on regarde. The more one looks far more mist arises in a bluish tint. By applying our algorithm and a modified fog we are able to generate a skyline purified up to cut a new notch resources taken by the displayed terrain. Return on our field, but this time by being near the ground:

We've added a blue fog to simulate this. The remote mountains are visible thanks to the difference in color the fog gives them. Now the same view but with a threshold of visibility at distance greatly reduced:

We get a display similar but with 1300 primitives less!

Code and optimization

The code given with this article is deliberately sketchy for the sake of understanding. Son but est de tester la technique Billod Its purpose is to test the Billod technique described here with no optimization.

Description of the "business" classes

Four classes are really business:

· The terrain is naturally managed by a class called Terrain. We will return later on its possible usefulness. Terrain is a container for Quadtrees. It represents the whole ground.

· The tree is represented by an instance of QuadTree class. QuadTree represents a part of Terrain. It is a container of QuadNodes.

· The nodes of the tree are created using the QuadNode class. It is a container of TerrainVertex. QuadNode represents a node.

· Finally the 9 vertices of a node are TerrainVertex.

Most treatment is within the class QuadNode. This has two important methods: Initialize and Update. The Initialize method handles load the node with all information related to its position in the QuadTree. It makes visible its four edges, it determines the neighboring nodes (for sharing vertices). It also calculates the deltas, normals, BoundingBox. It is called once every creation of a node.

The Update method performs tests on the four vertices "sides" (North, East, South, West) and four children on the potential (North West, North East, South West, South East) to each update of the tree .

This is the class QuadTree which initializes the first node and start treatment on the tree. Every x seconds (adjustable) it launches an asynchronous update on all the nodes instantiated to update the tree depending on the position of the camera.

The instantiation of a QuadTree is achieved by specifying the size of it, its depth and its location:

QuadTree tree = new QuadTree(treeDepth, rootNodeSize, location);

The structure TerrainVertex contains the vertex to display. A vertex can be shared on multiple nodes.

The code of this four major classes has been simplified in the extreme and widely commented. If there are still black spots do not hesitate to contact me.

Update Thread

A quick and easy (dirty ?) solution has been implemented to update the field. A BackgroundWorker is launched when you start the application and handle the updating of the field asynchronously.

This procedure avoids any slowdown of the game during the update. The data displays (VertexBuffer and IndexBuffer) are stored in a stack and used in the Render method. In the example provided with this article, we do an update that every 4 seconds.

Optimizations

Apart from improvements to the code, here are some ideas to increase the quality of reporting and the power of technology Billodes.

· We do two courses of the shaft each Update (one to update the tree, the other to extract the list to display triangles). There 'may be a point to improve here.

· The updated every X seconds is not necessarily the best solution. There are several other possible avenues to update, for example when the camera is moved or predicting the movement of the player and update accordingly. Finally, it should be noted that the final status of a tree is not achieved in a single Update It may be preferable in some cases to await the final version of the tree by calling the Update method as many times as necessary. You shlould prefer update the tree by little part each frame.

· Some thresholds for activation or deactivation of a child or a vertex are very low. We can consider that they will never be activated.

· When a node is cut or merged, or when a vertex changes state (visible / hidden), the transition is visible.It may be useful to cut this transition more gradual steps to soften the visual changes.

· Relying on the Terrain class. In this sample we render only a single tree. The Terrain class field can be a serious springboard to try to manage several trees that will be linked one to another.

· We load the entire Heightfield from the start by analyzing a black and white. It is an effective way to proceed to achieve an example but not to make a game. It might be wise to store the array of heights in a file and read what the QuadTree needs at each Update.

· The source code has not been optimized for readability.

The example program

This program is just one example of a rapid implementation of the land Billodes. The business classes are quickly adaptable to individual needs. The project is XNA 3.0. Il est toutefois adaptable au 2.0. However, it is adaptable to 2.0.

Commands to interact with the world are:

· Mouse: Click to turn the camera.

· Arrow keys: moving the camera in the current direction.

· Key W: Wireframe Mode On / Off.

· Page Up / Page Down: Change the Far Threshold Test.

· Key left Shift + Page Up / Page Down: Near Threshold Test.

· Left Key Shift + arrow keys: fast move.

· Left Key Alt + arrow keys: moving slow.

To test the Billod algorithm, simply move on the ground and studying the evolution of the field.

Note that it is possible to modify some parameters affecting the display using the configuration file of the application.

You can reuse the source code as you want. I just ask to refer me in your "credits".

References / Credits

The Web site of Stan Melax: http://www.melax.com . A very pragmatic man at the root of a technical Progressive Mesh very smart on which I based my algorithm. I take this article to thank him for his kindness and his exchange at the time or I was working on progressive meshes in XNA.

"Continuous LOD Terrain Meshing Using Adaptive Quadtrees" by Thatcher Ulrich. A method quite similar to mine but more research-oriented to deltas. This is one of the few methods available on the web that can be used for a game. My algorithm has a QuadTree quite similar to his "Adaptive QuadTree" but his management heightfield is much more intelligent than mine. His details management is, in my opinion less good than mine.

The page Hugues Hoppe: http://research.microsoft.com/ ~ hoppe. One of the masters of the terrain rendering. Everything is so great but illegible for novices and not necessarily adapted to the world of video gaming.

Virtual Terrain Project: http://www.vterrain.org/ . Website with a great set of publications around the management of terrain.

And on a more personal way Mathieu Laussel, a French friend 3D modeler (engineering) with whom I realize an editor of the world and who kindly wait as I write this article. And Boris Driss student that like game development and with who, talking is very interresting.

Downloads

You can downalod the C# project here.

Annexe : Progressive Mesh en Xna

valentin — Thu, 05 Apr 2007 14:00:00 GMT

Retourner au sommaire des cours

Avant toutes choses je tiens à remercier Stan Melax qui m'a gentiment aidé à passer son algorithme en DirectX et Xna et m'a laissé la possibilité d'utiliser pour ce cours quelque schémas qu'il avait réalisé.

L'utilisation de MRM est une véritable merveille pour accroître de manière significative les performances de ses applications. Le principe est simple : transformer un model 3D détaillé et formé de très nombreux polygones en une version allégée utilisant moins de faces mais aillant un aspect aussi similaire que possible.

Cette technique est la plupart du temps couplée avec la camera pour réduire proportionnellement la qualité du modèle 3D en fonction de la distance à laquelle il se trouve de la camera.

Au final, nous pouvons ainsi grappiller des FPS et libérer le GPU en lui évitant d’afficher des modèles détaillés au loin, là ou une version grandement allégée donne le même résultat à l’écran.

L'image suivante explicite cela :

On y voir l'affichage d'une voiture sous différentes résolutions (le poucentage indiqué au dessus de chaque modèle correspond au nombre de vertices utilisé par rapport à l'original). Le modèle à 10% reste tout à fait acceptable et similaire à l'original. Il est donc tout à fait imaginable de l'utiliser à grande distance à la place d'un modèle plus "complet" et plus lourd à manipuler.

Les MRM (multi resolution mesh) occupent une place prépondérante dans les moteurs 3D : Utilisés pricipalement pour libérer du traitement GPU sur l’affichage des objets lointains il est aussi employé dans l'occlusion culling (l'occlusion consiste à supprimer de l'affichage les objets qui sont cachés par d'autres objets nous y reviendrons dans un autre post). Nous allons donc dans ce cours chercher un moyen pour créer et utiliser des MRM dans nos applications. Ce moyen, c'est bien evidemment un algorithme qui va etre en mesure de calculer la réduction du nombre de vertices dans une forme 3D en sauvegardant au maximum son aspect général lors de cette transformation. L'algorithme

Une complexité qui rebute

Si on se tourne vers les moteurs de recherche sur le net (live.com, google.fr) à l'aide des mots clés "MRM algorithme" on trouve un grand nombre de travaux de chercheurs et de passionnés sur ce sujet. Pourtant la plupart des algorithmes qu'on y trouve sont inexploitables : soit ils sont trop gourmants en calculs et donc inexploitable en temps réel, soit le resultat change l'aspect de la forme 3D ou bien encore la complexité est telle qu'il est tout bonnement incompréhensible. Quelques pasionnés ont toutefois trouvé un moyen de réaliser des réductions de résolutions relativement simplement. Nous retiendrons ainsi la méthode utilisé par Stan Melax parce qu'à priori la meilleure et, cerise sur le gâteau, l'une des plus simples.

Réduction par Fusion de Meshs

Melax se base lui-même sur les travaux de H.Hoppes, un développer de MSR (Microsoft Research) dont est issue vraisemblablement l'algorithme se trouvant derrière la classe ProgressiveMesh de Direct3D. Cet algorithme vise a réduire la complexité d'un model 3D par l'intermédiaire de fusions de vertices. Le principe est trivial : à chaque réduction de résolution on fusionne deux vertices (que nous nommerons ici u et v).S'ensuit :

La suppression des triangles qui possèdent à la fois les vertices u et v.
La mise à jour des triangles qui utilisaient u sur l'un de leurs trois points afin qu'ils utilisent v à la place.
La suppression du vertex u.

Le schéma ci-dessus explicite tout cela. La figure A montre l'état du modèle avant la baisse de résolution. La figure B montre le même modèle après la fusion de deux de ces vertices. Le modèle garde son aspect mais en utilisant un vertex et deux faces en moins.

Ce processus est répété jusqu'à atteindre le nombre de vertices ou de faces voulu.

Choix de u et v

Cette méthode est relativement simple sur le papier et réduit effectivement sans grandes difficultés un model 3D. Il ne faut pourtant pas crier victoire trop vite : comme dit précédemment, il est primodial que le model "réduit" garde une apparence similaire au model complexe originel. Il convient donc de choisir avec intelligence les sommets u et v à fusionner afin de provoquer la plus fine modification visuelle à l'écran. L'image suivante illustre celà :

Le choix du sommet à supprimer est important pour garder une apparence aussi similaire que possible à l'original (image extraite de l'article de Stan Melax avec l'aimable autorisation de l'auteur).

C'est là ou le bat blesse : la plupart des algorithmes propose pour ce choix des calculs lourds et inutilisables en temps réel. Sur ce point, Stan Melax a montré son savoir faire. Il part d'un principe élémentaire : les surfaces coplanaires ne demandent pas autant de vertices pour être rendue à l'écran que les surfaces avec un relief prononcé (comme les courbes). Il est plus facile de réduire la complexité des premières, que celle des secondes. Le coût pour la disparition d'un sommet pourrait se traduire ainsi : c'est le résultat de la multiplication de la taille du sommet par l'importance dans la courbe sur laquelle il se trouve.

Pour la fusion uv, visant à déplacer u vers v nous avons l'algorithme :

Calculer la taille du sommet (distance u à v).
Déterminer l'ensemble des triangles qui possède à la fois u et v.
Pour chacun des triangles connectés à u :

Calculer le produit orthonormé de la normal du triangle courant avec chacun des triangles qui possèdent à la fois u et v. En extraire le plus petit produit.

Calculer le plus gros des plus petits produits : C'est la coùt de la fusion.

La formule mathématique pour calculer ce cout est la suivante est la suivante :

où Tu est l'ensemble des triangles qui possèdent u and Tuv l'ensemble des triangles qui contiennent à la fois u et v (image extraite de l'article de Stan Melax avec l'aimable autorisation de l'auteur).

Le principe peut se résumer ainsi : on parcourt tous les triangles connectés à u. Il est nécessaire, pour chacun de ces triangles, d'analyser le cout de la fusion avec v. On calcul celà en analysant l'impacte de la transformation des triangles afin de déterminer l'ampleur de la modification. Il y'a deux types de modifications : Soit les triangles sont connectés uniquement à u, et, dans ce cas ils sont modifiés pour être reliés à v, soit les triangles sont liés à u et v à la fois et doivent etre supprimés du modèle. La figure A et B au début de cette annexe illustre celà parfaitement.

Passons aux choses sérieuses

Pour l'heure la classe ProgressiveMesh que vous pouvez reprendre est industrialisable mais est encore améliorable :

Il reste à associer un poid à chaque vertex pour la transformation.
A réaliser un tris sur la liste de vertices pour classer par ordre de coût de transformation.
A réaliser des méthodes d'optimisation comme dans la classe Mesh de Direct3DX (fusionner les vertices qui sont assez proches pour ne faire qu'un).

Passons maintenant au code.

Celui-ci se trouve à l'intérieur d'une DLL nommée ArcaneEngine.Objects. Deux types de données nous interesse :

ProgressiveMesh<T>
Resolution

La création d'un mesh progressif et son affichage se fait en trois étapes.

Tout d'abord la création de l'objet (étape pouvant être asynchrone) en passant au constructeur la liste des vertices qui composent le mesh, la liste des indices pour relier les vertices et enfin les poids associés aux vertices (un tableau de booléens pour l'heure) :

ProgressiveMesh<VertexPositionNormalTexture> mesh = new ProgressiveMesh<VertexPositionNormalTexture>(vertices, ints, null);

Puis le chargement des buffers 3D lorsque le device a été créé

mesh.Load(this._device);

Enfin l'affichage du mesh

this.mesh.Render();

La gestion des MRM est beaucoup plus simple qu'avec la classe de Direct3DX.

Revenons sur la généricité de la classe. Le développeur doit indiquer un argument de spécificité a la classe générique ProgressiveMesh (ici VertexPositionNormalTexture). Il s'agit en fait de la classe utilisée pour le type de vertices.

A partir de cet argument, la classe pourra extraire les positions de chaque vertices et, avec les indices, calculer les différentes résolutions. Elle pourra en outre extraire le format des vertices pour l'affichage, elle pourra aussi renvoyer à l'utilisateur pour chaque resolution les buffers et array de vertices actuellement affichés.

Pour changer la résolution deux choix. Soit vous utilisez la propriété NumberOfVertices pour indiquer directement le nombre de vertices a afficher. Soit vous utilisez la property Resolution en donnant un membre de l'énumération :

    public enum Resolution
    {
        /// <summary>
        /// <para>No resolution : no mesh rendered.</para>
        /// </summary>
        None = 0,
        /// <summary>
        /// <para>No resolution : no mesh rendered.</para>
        /// </summary>
        Dynamic = -1,
        /// <summary>
        /// <para>Ten percents of the mesh's vertices used to render it.</para>
        /// </summary>
        Lowest = 10,
        /// <summary>
        /// <para>Twenty five percents of the mesh's vertices used to render it.</para>
        /// </summary>
        Low = 25,
        /// <summary>
        /// <para>Fivety percents of the mesh's vertices used to render it.</para>
        /// </summary>
        Medium = 50,
        /// <summary>
        /// <para>Seventy five percents of the mesh's vertices used to render it.</para>
        /// </summary>
        High = 75,
        /// <summary>
        /// <para>One hundred percents of the mesh's vertices used to render it.</para>
        /// <remarks>Full vertices are used.</remarks>
        /// </summary>
        Full = 100

}

Le changement de la résolutiond'un mesh demande un leger temps de calcul à priori invisible à l'écran.

Nous n'analyserons pas ici le code qui reste assez simple. A l'intérieur de la classe ProgressiveMesh se trouve la region "Multi resolution computing" qui contient les méthodes liées au calcul de la resolution. La méthode ComputeEdgeCostAtVertex détermine le cout de la fusion d'un vertex, la méthode Collapse réalise cette fusion et MinimumCostEdge permet de trouver le vertex ayant le coût le plus bas pour une fusion. A noter que la classe ProgressiveMesh possède deux types internes : Vertex et Triangle qui permettent d'opérer sur les vertices et les faces plus facilement.

Une analyse du code par vos propres moyens devrait eclaircir tous les points encore obscurs à vos yeux. N'hesitez pas a poster des commentaires pour toutes questions.

A l'intérieur de la classe Game1 se trouve le code qui montre comment utiliser notre classe ProgressiveMesh. L'application principale contient en outre un ensemble de classes statiques qui contiennent des ensembles de vertices et d'indices permettant de charger un MRM. Elles héritent toutes de l'interface IData qui permet une utilisation générique de ces dernières.

Les liens

Evidemment en première place le site de Stan Melax

http://www.melax.com/polychop/

Ensuite le site de Hugues Hoppes

http://research.microsoft.com/~hoppe/

(déprimant parcequ'on voit qu'il fait des trucs super, mais on comprend rien)

Sample

Vous pouvez télécharger les trois samples ici.

Conclusion

L'application au final se présente ainsi :

L'interface graphique est rudimentaire mais nous l'améliorerons avec l'arrivée de l'annexe portant sur l'UI. Les touches Page Haut et Page Bas permettent de passer d'une résolution à une autre. Les touches + et - permettent de modifier la resolution plus finnement en changeant le nombre de vertices affichés. La souris permet de déplacer la camera autour du mesh affiché. Enfin la touche espace permet de changer de modèle. L'application affiche 6 modèles :

Beethoven
Fourmi
Un terrain
Porsche
Vache
Lapin

A noter que le modèle terrain sert à voir l'utilité du tableau de poids passé au constructeur. Sans ce poid, la portion de terrain "s'arrondit" au fil de la réduction de résolution en perdant ainsi tout son aspect. Notez de même que le modèle fourmi montre les limites de notre système sur les formes 3D disposant de peu de vertices ...

A bientôt sur ce Blog !

Valentin Billotte

N'hesitez surtout pas à me faire part de vos incomprehensions afin de pemettre d'améliorer ce cours pour le rendre plus accessible aux autres (trèèèès important)!

Vous pouvez télécharger les trois samples ici.

Retourner au sommaire des cours

Annexe : Billboard en Xna

valentin — Fri, 09 Mar 2007 15:17:00 GMT

Retourner au sommaire des cours

Le billboard est un élément essentiel pour décharger le GPU de l'affichages de formes complexes.

Un billboard (en français "panneau") est un plan simulant un objet 3D. Le principe des billboards est de toujours faire face à la caméra : ainsi quelque soit l'endroit d'où on les regarde, ils donneront toujours l'illusion que l'image qui les texture est une forme 3D.

L'avantage est de réduire énormément la complexité de la scène, puisque l'on va pouvoir remplacer des objets potentiellement complexes par deux simples triangles texturés formant le carré (ou plan). La texture bien entendu doit être de qualité et si possible faire partie d'une animation.

Les billboards sont utilisés pour la végétation, les explosions, les effets météorologique (nuages, ...), ou encore des objets très lointains pour lesquels on ne pourra que très difficilement déceler le trucage.

Jusqu'à présent avec DirectX pour créer un billboard on devait travailler sur la matrice de vue ou créer de toute pièce une matrice de transformation à partir de la position de la caméra. En Xna tout est plus simple, il nous suffit d'appeller une méthode statique de la classe Matrix nommée CreateBillboard.

Nous verrons trois samples pour mettre en évidence l'utilité de cette technique.Un sample de présentation qui va montrer de manière explicite le billboard en action, un sample qui mettra en évidence l'effet réaliste que produit le billboarding (nous repredrons un sample du SDK Direct) et enfin un sample identique au précédent mais avec des animations.

Vous devez avoir lu les tutoriaux Xna jusqu'au chapitre 8 pour comprendre ce cours.

Les billboards utilisés ici exploitent la méthode CreateBillboard de la classe Matrix et n'utilisent en rien les fichiers effets.

Premier sample

Dans ce premier sample nous allons afficher deux objets : un cube tout d'abord dont la taille sera augmentée de telle sorte que la camera se trouvera à l'intérieur. Ses parois serviront alors de référence lorsque nous déplacerons la caméra à l'aide de la souris. Ensuite un objet billboard. Il s'agira tout simplement d'une face carrée composée de deux triangles. En "marche" normale, ce billboard sera desactivé et tournera de manière solidaire avec le cube lorsque la caméra sera déplacée. Mais lorsqu'on appuyera sur la touche "Espace", le billboard présentera toujours sa face texturée à la caméra, et ceci, quelque soit la position de cette dernière.

La classe Billboard

Sur le plan technique 3D notre classe sera relativement simple. Elle n'aura pour tâche que d'afficher un simple plan 3D composé de deux triangles isocèles rectangles. Le plan sera texturé et de couleur paramétrable. La classe disposera d'une méthode Update permettant au billboard de se repositionner par rapport à la position de la caméra, par rapport au point vers lequel la caméra regarde et enfin par rapport à la normale de la caméra. Enfin une propriété sera ajoutée -pour les besoins de l'exemple- permettant d'activer ou de desactiver le billboard. Terminons en ajoutant qu'elle hérite de la classe mère TransformBase qui a été présentée ici.

Analysons son code :

/// <summary>
/// <para>Defines a billboard object.</para>
/// </summary>
/// <remarks>A billboard object always present its face in front of the camera.</remarks>
public class Billboard : TransformBase
{
    private GraphicsDevice _device;
    private VertexBuffer _vertexBuffer = null;
    private Color _color = Color.TransparentWhite;
    private Texture2D _texture;
    private BasicEffect _effect;
    private bool _activated;    private Matrix _billboardMatrix = Matrix.Identity;      /// <summary>    /// <para>Gets or sets a value indicating if the biilboard is activated.</para>    /// </summary>    public bool Activated    {        get        {            return this._activated;        }        set        {            this._activated = value;        }    }     /// <summary>    /// <para>Gets or sets the cube's texture.</para>    /// </summary>    public Texture2D Texture    {        get        {            return this._texture;        }        set        {            this._texture = value;            this._effect.Texture = value;        }    }      /// <summary>    /// <para>Gets the cube's effect.</para>    /// </summary>    public BasicEffect Effect    {        get        {            return this._effect;        }    }     /// <summary>    /// <para>Gets or sets the Cube's color.</para>    /// </summary>    public Color Color    {        get        {            return this._color;        }        set        {            this._color = value;        }    }     public void Load(GraphicsDevice device)    {        this._device = device;        this.InitializeVertices();        this.InitializeEffect();    }     private void InitializeEffect()    {        this._effect = new BasicEffect(this._device, null);        this._effect.VertexColorEnabled = true;        this._effect.TextureEnabled = true;    }     private void InitializeVertices()    {        VertexPositionColorTexture[] vertices = new VertexPositionColorTexture[4];         vertices[0].Position = new Vector3(-100.5f, 100.5f, 0);        vertices[0].Color = this.Color;        vertices[0].TextureCoordinate = new Vector2(0, 0);         vertices[1].Position = new Vector3(100.5f, 100.5f, 0);        vertices[1].Color = this.Color;        vertices[1].TextureCoordinate = new Vector2(1, 0);         vertices[2].Position = new Vector3(100.5f, -100.5f, 0);        vertices[2].Color = this.Color;        vertices[2].TextureCoordinate = new Vector2(1, 1);         vertices[3].Position = new Vector3(-100.5f, -100.5f, 0);        vertices[3].Color = this.Color;        vertices[3].TextureCoordinate = new Vector2(0, 1);         this._vertexBuffer = new VertexBuffer(        this._device,        typeof(VertexPositionColorTexture),        4,        ResourceUsage.WriteOnly,        ResourceManagementMode.Automatic);         this._vertexBuffer.SetData(vertices);    }     /// <summary>    /// <para>Render the cube on the device.</para>    /// </summary>    public void Render()    {        this._device.RenderState.CullMode = CullMode.None;        this._effect.Begin();        this._effect.World = (this._activated ? this._billboardMatrix : Matrix.Identity)*this.Transform;          foreach (EffectPass pass in this._effect.CurrentTechnique.Passes)        {            pass.Begin();             this._device.Textures[0] = this.Texture;            this._device.Vertices[0].SetSource(this._vertexBuffer, 0, VertexPositionColorTexture.SizeInBytes);            this._device.VertexDeclaration = new VertexDeclaration(this._device, VertexPositionColorTexture.VertexElements);            this._device.DrawPrimitives(PrimitiveType.TriangleFan, 0, 2);              pass.End();        }         this._effect.End();        this._device.RenderState.CullMode = CullMode.CullClockwiseFace;    }      public void Update(GameTime gameTime, Vector3 cameraPosition, Vector3 cameraLookAt, Vector3 cameraUpVector)            _billboardMatrix = Matrix.CreateBillboard(Vector3.Zero, this.Position - cameraPosition, cameraUpVector, cameraLookAt);
      }
}

Aucune réelle difficulté pour comprendre ce code. Seules deux instructions seront portées à notre attention. La première se trouve dans la méthode Update :

_billboardMatrix = Matrix.CreateBillboard(Vector3.Zero, this.Position-cameraPosition, cameraUpVector, cameraLookAt);

Elle charge dans la variable _billboardMatrix une matrice de billboard renvoyée par la méthode Matrix.CreateBillboard. Comment savoir vers où diriger la face du billboard ? En y reflechissant bien, nous n'avons besoin de connaître que quatre propriétés :

La position de l'objet.
La position de la caméra.
Le point vers lequel regarde la caméra
La normale de la caméra.

C'est justement ce que demande cette méthode. Pour l'heure (10/03/07) elle semble être bugguée. Normalement on lui passe la position de l'objet courant en premier paramètre, la position de la caméra en second paramètre, la normale de la caméra en avant dernier paramètre et enfin le point vers lequel la caméra regarde. Faire cela ne fonctionne que si votre objet se trouve en (0, 0, 0). Pas terrible... Si l'objet se trouve ailleur vous vous retrouvez avec un décallage équivalent à deux fois la distance de l'objet à l'origine. L'astuce est de donner la valeur Vector3.Zero en première paramètre et la soustraction de la poistion de l'objet par la position de la caméra (this.Position-cameraPosition) en second.

Si ce bug a été corrigé à l'heure où vous lisez ces lignes, ou bien si c'est moi qui suis bugué (pas trop le temps de vérifier en ce moment :) ) merci de me l'indiquer.

La seconde instruction se trouve dans la méthode Render :

this._effect.World = (this._activated ? this._billboardMatrix : Matrix.Identity)*this.Transform;

Ici, si le billboarding est activé nous affectons à la matrice World le résultat de la multplication de la matrice de _billboardMatrix par la matrice de transformation (position de l'objet, taille, rotation). Sinon World prend pour valeur le contenu de Transform.

Le reste du code est assez simple pour être assimilé et compris sans être présenté ici. Si vous exécutez l'application vous verrez apparaitre les parois de notre cube et le billboard au centre de celui-ci. En déplaçant la souris sans appuyer sur Enter un affichage similaire à l'animation suivante se produit :

On remarque que le billboard au centre du cube tourne de manière solidaire avec le cube et se présente donc sous une infinité d'angles à la caméra. Si vous appuyez sur Espace, l'affichage change comme ceci :

Cette fois, le billboard reste face à la caméra quelque soit la position de cette dernière.

Si cet exemple illustre parfaitement le principe des billboards, il ne met pas en evidence de manière flagrante leur avantage. Ce sera l'objet de notre second Sample.

Second sample

Un exemple bien plus ludique nous attend. Une foret va être affichée sur un territoire valonné. Chaque arbre sera en fait un billboard et donnera l'illusion d'être un modèle 3D complexe. Aucune action utilisateur ici, le développeur admirera juste le rendu (ce qui est déjà très bien ...).

Le code

Il faut, pour bien comprendre les effets de transparences utilisés ici, avoir lu le chapitre 8 jusqu'au point portant sur les effets spéciaux et blending (inclu).

Ici, seules deux classes ont été modifiées en profondeur, la classe Game1 et la classe Region. La première va avoir pour tâche d'afficher X billboards texturés avec une image d'arbre. Elle leur donnera une position, une taille et une couleur différente. La classe Region va simplement afficher un relief en utilisant des fonctions trigonométriques pour valonner le paysage.

Le relief

Le relief visible dans l'image ci-dessous se réalise par l'intermédiaire d'une méthode retournant une altitude en fonction d'une abscisse X et d'une ordonnée Y fournies. Le calcul se base sur les fonctions trigonométriques Cosinus et Sinus :

/// <summary>/// Simple function to define "hilliness" for terrain/// </summary>public static float HeightField(float x, float y){ return 30 * ((float)Math.Cos(x / 40 + 0.2f) * (float)Math.Cos(y / 35 - 0.2f) + 1.0f);

}

Désormais, au lieu de passer la valeur 0 en profondeur Z pour chaque vertex nous donnons le résultat de cette méthode.

Les arbres

Pour les arbres/billboards, tout se passe dans la classe Game1. Une liste générique est déclarée avec une constante indiquant le nombre d'arbres affichés.

private const int numberOfTrees = 400;
private List<Billboard> trees;

Vient ensuite l'initialisation de chaque arbre dans la liste.

Random rand = new Random();for (int i = 0; i < numberOfTrees; i++){ Billboard tree = new Billboard(); float size = 4 + 8 * (float)rand.NextDouble(); tree.Resize(size, size, size); do { int x = rand.Next(0, 512); int y = rand.Next(0, 512); tree.Position = new Vector3(x, y, Region.HeightField(x, y) + size); } while (!IsTreePositionValid(tree.Position)); tree.Activated = true; int r = (255 - 190) + (int)(190 * (float)(rand.NextDouble())); int g = (255 - 190) + (int)(190 * (float)(rand.NextDouble())); int b = 255; tree.Color = new Color((byte)r, (byte)g, (byte)b, 255); tree.Load(this.graphics.GraphicsDevice); trees.Add(tree);

Ici une taille aléatoire, une position aléatoire et une couleur aléatoire sont données à chaque arbre. La méthode IsTreePositionValid vérifie simplement que les arbres sont assez espacés. A chaque mise à jour, la métrice view est rafraichie et la méthode Update de chaque arbre est appelée avec la position de la caméra, le nouveau point vers lequel elle regarde et sa normale :

for (int i = 0; i < numberOfTrees; i++){ trees.Effect.View = viewMatrix; trees.Update(gameTime, vEyePt, vLookatPt, new Vector3(0, 0, 1f));

}

Notons enfin que la liste d'arbres est re-ordonnée à chaque Update afin d'afficher les arbres dans l'ordre de leur apparition.

Le rendu final nous offre un monde possédant des arbres et de la végétation qui semble être en 3D :

Dernier Sample

Les billboards ont aussi une autre utilisation très utile : les effets graphiques et les animations. Nous allons ici modifier notre classe billboard de façon à permettre l'affichage d'un plan animé comme celui-ci:

Le code

La classe Billboard se présente maintenant ainsi :

public class Billboard : TransformBase{ #region Private members private GraphicsDevice _device; private Color _color = Color.TransparentWhite; private Texture2D _texture; private BasicEffect _effect; private bool _activated; private Matrix _billboardMatrix = Matrix.Identity; private int _animationRows; private int _animationColumns; private long _animationFrequency; private AnimateType _animateType; private List<VertexBuffer> _animations; private VertexBuffer _currentAnimation; private int _animationIndex; private Blend _sourceBlend; private Blend _destinationBlend; private double _lastUpdate; #endregion #region Properties /// <summary> /// <para>Occurs when the animation is over.</para> /// </summary> public event EventHandler AnimationEnded; /// <summary> /// <para>Gets or sets a value indicating if the biilboard is activated.</para> /// </summary> public bool Activated { get { return this._activated; } set { this._activated = value; } } /// <summary> /// <para>Gets or sets the number of animations on a colum for the associated texture.</para> /// </summary> public int AnimationColumns { get { return this._animationColumns; } set { if ((value < 0) || (value > 16)) { throw new ArgumentOutOfRangeException("AnimationColumns", "AnimationColumns must be filled with a value between 1 and 16"); } this._animationColumns = value; } } /// <summary> /// <para>Gets or sets the animation frequency/para> /// </summary> public long AnimationFrequency { get { return this._animationFrequency; } set { this._animationFrequency = value; } } /// <summary> /// <para>Gets or sets the number of animations on a row for the associated texture.</para> /// </summary> public int AnimationRows { get { return this._animationRows; } set { if ((value < 0) || (value > 16)) { throw new ArgumentOutOfRangeException("AnimationRows", "AnimationRows must be filled with a value between 1 and 16"); } this._animationRows = value; } } /// <summary> /// <para>Gets or sets a value indicating the type of the animation.</para> /// </summary> public AnimateType AnimateType { get { return this._animateType; } set { this._animateType = value; } } /// <summary> /// <para>Gets or sets the Cube's color.</para> /// </summary> public Color Color { get { return this._color; } set { this._color = value; } } /// <summary> /// <para>Gets or sets the destination blend.</para> /// </summary> public Blend DestinationBlend { get { return this._destinationBlend; } set { this._destinationBlend = value; } } /// <summary> /// <para>Gets the cube's effect.</para> /// </summary> public BasicEffect Effect { get { return this._effect; } } /// <summary> /// <para>Gets or sets the source blend.</para> /// </summary> public Blend SourceBlend { get { return this._sourceBlend; } set { this._sourceBlend = value; } } /// <summary> /// <para>Gets or sets the cube's texture.</para> /// </summary> public Texture2D Texture { get { return this._texture; } set { this._texture = value; this._effect.Texture = value; } } #endregion #region Constructors /// <summary> /// <para>Empty constructors (no animations).</para> /// </summary> public Billboard() { this._animationIndex = 0; this._animationRows = 1; this._animationColumns = 1; this._animateType = AnimateType.None; this._animations = new List<VertexBuffer>(); } /// <summary> /// <para>Instanciate a new Billboard with an animation.</para> /// </summary> /// <param name="animationRows"></param> /// <param name="animationColumns"></param> /// <param name="animationFrequency"></param> public Billboard(int animationRows, int animationColumns, long animationFrequency) : this() { this._animateType = AnimateType.Loop; this._animationColumns = animationColumns; this._animationFrequency = animationFrequency; this._animationRows = animationRows; } #endregion #region Initialization public void Load(GraphicsDevice device) { this._device = device; this.InitializeVertices(); this.InitializeEffect(); } private void InitializeEffect() { this._effect = new BasicEffect(this._device, null); this._effect.VertexColorEnabled = true; this._effect.TextureEnabled = true; } private void InitializeVertices() { this._animations.Clear(); float animationSizeU = (1f / this.AnimationColumns); float animationSizeV = (1f / this.AnimationRows); for (int column = 0; column < this.AnimationColumns; column++) { for (int row = 0; row < this.AnimationRows; row++) { VertexBuffer vertexBuffer = null; VertexPositionColorTexture[] vertices = new VertexPositionColorTexture[4]; float tu = 0 + animationSizeU * column; float tv = 0 + animationSizeV * row; vertices[0].Position = new Vector3(-1f, 1f, 0); vertices[0].Color = this.Color; vertices[0].TextureCoordinate = new Vector2(tu, tv); vertices[1].Position = new Vector3(1f, 1f, 0); vertices[1].Color = this.Color; vertices[1].TextureCoordinate = new Vector2(tu + animationSizeU, tv); vertices[2].Position = new Vector3(1f, -1f, 0); vertices[2].Color = this.Color; vertices[2].TextureCoordinate = new Vector2(tu + animationSizeU, tv + animationSizeV); vertices[3].Position = new Vector3(-1f, -1f, 0); vertices[3].Color = this.Color; vertices[3].TextureCoordinate = new Vector2(tu, tv + animationSizeV); vertexBuffer = new VertexBuffer( this._device, typeof(VertexPositionColorTexture), 4, ResourceUsage.WriteOnly, ResourceManagementMode.Automatic); vertexBuffer.SetData(vertices); this._animations.Add(vertexBuffer); } } this._currentAnimation = this._animations[0]; } #endregion #region Render /// <summary> /// <para>Render the cube on the device.</para> /// </summary> public void Render() { this._effect.Begin(); this._effect.World = (this._activated ? this._billboardMatrix : Matrix.Identity) * this.Transform; foreach (EffectPass pass in this._effect.CurrentTechnique.Passes) { pass.Begin(); this._device.RenderState.AlphaBlendEnable = true; this._device.RenderState.SourceBlend = this.SourceBlend; this._device.RenderState.DestinationBlend = this.DestinationBlend; if (this._device.GraphicsDeviceCapabilities.AlphaCompareCapabilities.SupportsGreaterEqual) { this._device.RenderState.AlphaTestEnable = true; this._device.RenderState.ReferenceAlpha = 0x08; this._device.RenderState.AlphaFunction = CompareFunction.Greater; } this._device.Textures[0] = this.Texture; this._device.Vertices[0].SetSource(this._currentAnimation, 0, VertexPositionColorTexture.SizeInBytes); this._device.VertexDeclaration = new VertexDeclaration(this._device, VertexPositionColorTexture.VertexElements); this._device.DrawPrimitives(PrimitiveType.TriangleFan, 0, 2); this._device.RenderState.AlphaBlendEnable = false; this._device.RenderState.AlphaTestEnable = false; pass.End(); } this._effect.End(); } #endregion #region Public methods public void Update(GameTime gameTime, Vector3 cameraPosition, Vector3 cameraLookAt, Vector3 cameraUpVector) { this._billboardMatrix = Matrix.CreateBillboard(Vector3.Zero, this.Position - cameraPosition, cameraUpVector, cameraLookAt); if (this.AnimateType != AnimateType.None) { this.Animate(gameTime); } } private void Animate(GameTime gameTime) { _lastUpdate += gameTime.ElapsedGameTime.TotalMilliseconds; if (_lastUpdate > this.AnimationFrequency) { _lastUpdate = 0; this.IncrementAnimation(); this._currentAnimation = this._animations[this._animationIndex++]; } } private void IncrementAnimation() { this._animationIndex++; if (this._animationIndex > (this._animationColumns * this._animationRows - 1)) { if (this.AnimationEnded != null) this.AnimationEnded(this, EventArgs.Empty); this._animationIndex = 0; } } #endregion

}

Etudions là point par point. Le premier ajout concerne l'arrivée de nouveaux membres permettant d'exploiter l'animation :

private int _animationRows; private int _animationColumns; private long _animationFrequency; private AnimateType _animateType; private List<VertexBuffer> _animations; private VertexBuffer _currentAnimation; private int _animationIndex; private Blend _sourceBlend; private Blend _destinationBlend; private double _lastUpdate;

On trouve ici dans l'ordre : le nombre d'animation en haut et largeur, la vitesse de l'animation (en millisecondes), le type d'animation (non utilisé ici), la liste de vertexbuffer (nous reviendrons sur ce membre plus loin), le vertexbuffer correspondant à l'animation courante, l'index de l'animation dans la liste de vertexbuffer, le blend source et de destination (afin de pouvoir spécifier à la création du billboard de type de blend que l'ont désire) et enfin le temps écoulé depuis le dernier update du billboard.

Deux constructeurs font leur apparition :

/// <summary> /// <para>Empty constructors (no animations).</para> /// </summary> public Billboard() { this._animationIndex = 0; this._animationRows = 1; this._animationColumns = 1; this._animateType = AnimateType.None; this._animations = new List<VertexBuffer>(); } /// <summary> /// <para>Instanciate a new Billboard with an animation.</para> /// </summary> /// <param name="animationRows"></param> /// <param name="animationColumns"></param> /// <param name="animationFrequency"></param> public Billboard(int animationRows, int animationColumns, long animationFrequency) : this() { this._animateType = AnimateType.Loop; this._animationColumns = animationColumns; this._animationFrequency = animationFrequency; this._animationRows = animationRows; }

Le premier existait déjà mais initialise les membres de classe en prennant en compte qu'il n'y a aucun animation à jouer (c'est le cas pour les billboard affichant les arbres et l'herbe). Le second prend en paramètre les animations en hauteur et largeur ainsique la fréquence. Il initialize les membres pour l'animation spécifiée.

La plus grosse modification vient de la méthode d'initialisation des vertices :

private void InitializeVertices() { this._animations.Clear(); float animationSizeU = (1f / this.AnimationColumns); float animationSizeV = (1f / this.AnimationRows); for (int column = 0; column < this.AnimationColumns; column++) { for (int row = 0; row < this.AnimationRows; row++) { VertexBuffer vertexBuffer = null; VertexPositionColorTexture[] vertices = new VertexPositionColorTexture[4]; float tu = 0 + animationSizeU * column; float tv = 0 + animationSizeV * row; vertices[0].Position = new Vector3(-1f, 1f, 0); vertices[0].Color = this.Color; vertices[0].TextureCoordinate = new Vector2(tu, tv); vertices[1].Position = new Vector3(1f, 1f, 0); vertices[1].Color = this.Color; vertices[1].TextureCoordinate = new Vector2(tu + animationSizeU, tv); vertices[2].Position = new Vector3(1f, -1f, 0); vertices[2].Color = this.Color; vertices[2].TextureCoordinate = new Vector2(tu + animationSizeU, tv + animationSizeV); vertices[3].Position = new Vector3(-1f, -1f, 0); vertices[3].Color = this.Color; vertices[3].TextureCoordinate = new Vector2(tu, tv + animationSizeV); vertexBuffer = new VertexBuffer( this._device, typeof(VertexPositionColorTexture), 4, ResourceUsage.WriteOnly, ResourceManagementMode.Automatic); vertexBuffer.SetData(vertices); this._animations.Add(vertexBuffer); } } this._currentAnimation = this._animations[0]; }

Cette méthode a un but simple, connaissant le nombre d'animation sur la texture à afficher, elle va créer autant de vertexbuffer que nécessaire : tous auront le même position et la même couleur, mais il auront une coordonnée de texture lié à l'emplacement de la frame sur l'image. La première instruction vide la liste de vertexbuffer. Les deux suivantes calculent le % en largeur et hauteur d'une frame sur la texture :

float animationSizeU = (1f / this.AnimationColumns);
float animationSizeV = (1f / this.AnimationRows);

(ou 1 == 100%). A partir de là on parcours chaque colonne et chaque ligne pour créer un vertex buffer adapté à la frame voulue. On ajoute le dis vertexbuffer à la liste. La dernière instruction fait pointer l'animation courante sur la première animation. C'est celle-ci (qui est en fait un vertexbuffer) qui sera utilisé pour l'affichage (méthode Draw)

Viennent enfin les méthodes de mise à jour du billboard :

public void Update(GameTime gameTime, Vector3 cameraPosition, Vector3 cameraLookAt, Vector3 cameraUpVector) { this._billboardMatrix = Matrix.CreateBillboard(Vector3.Zero, this.Position - cameraPosition, cameraUpVector, cameraLookAt); if (this.AnimateType != AnimateType.None) { this.Animate(gameTime); } } private void Animate(GameTime gameTime) { _lastUpdate += gameTime.ElapsedGameTime.TotalMilliseconds; if (_lastUpdate > this.AnimationFrequency) { _lastUpdate = 0; this.IncrementAnimation(); this._currentAnimation = this._animations[this._animationIndex++]; } } private void IncrementAnimation() { this._animationIndex++; if (this._animationIndex > (this._animationColumns * this._animationRows - 1)) { if (this.AnimationEnded != null) this.AnimationEnded(this, EventArgs.Empty); this._animationIndex = 0; } }

Ces méthodes se contentent juste de pointer sur l'animation suivante si le temps écouté depuis le dernier update est suffisant.

L'utilisation d'un billboard animé reste similaire à ce que nous avons fait précédemment (classe Game1). Elle passe par 4 étapes :

La création et l'initialisation :

Billboard smoke = new Billboard(8,8,50);float size = 5;smoke.Resize(size, size, size);do{ int x = rand.Next(0, 512); int y = rand.Next(0, 512); smoke.Position = new Vector3(x, y, Region.HeightField(x, y) + size);}while (!IsTreePositionValid(smoke.Position)); smoke.SourceBlend = Blend.SourceColor;smoke.DestinationBlend = Blend.One;

smoke.Activated = true;

smoke.Color = new Color(255, 255, 255, 255);

smoke.Load(this.graphics.GraphicsDevice);

L'affection d'une texture contenant un ensemble de frame :

for (int i = 0; i < numberOfSmokes; i++)
smokes.Texture = textures[5];

La mise à jour de la matrice de vue et l'appel à la méthode Update :

            for (int i = 0; i < numberOfSmokes; i++)
            {
                smokes.Effect.View = viewMatrix;
                smokes.Update(gameTime, vEyePt, vLookatPt, new Vector3(0, 0, 1f));
            }

et enfin, bien entendu, l'affichage :

smokes.Render();

Au final à l'affichage, on voit apparaitre des halo de fumées dans le décors :

Bonus stage

Je me suis amusé à créer un sample dérivé du dernier pour afficher un effet de météorite s'écrasant sur terre. Admirez ce qu'il est possible de faire en une petite heure à peine avec des billboards :

Le code de la classe météore qui s'occupe de gérer un météore (en fait un ensemble de billboard) n'est pas terrible et optimisé mais je n'avais qu'une heure pour le faire, il donne néanmoins une idée de ce qu'on peut faire avec du temps, et de belles images...

Le code se trouve avec les samples de ce cours.

Conclusion

Tous les jeux font appels aux bilboards. Et pour cause : ils permettent un affichage réaliste, 3D à moindre cout pour les effets spéciaux. Des sociétés comme Blizzard en sont friands (World Of Warcraft en regorge à chaque écran). Sachant que leur utilisation dans un programme est maintenant simple grâce à notre classe clé en main, pourquoi s'en priver ?

A bientôt sur ce Blog !

Valentin Billotte

N'hesitez surtout pas à me faire part de vos incomprehensions afin de pemettre d'améliorer ce cours pour le rendre plus accessible aux autres (trèèèès important)!

Vous pouvez télécharger les trois samples ici.

Retourner au sommaire des cours