Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > bad97183153701b09df5fae1052b1c30 > files > 1125

crystalspace-doc-1.2.1-5mdv2010.0.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Crystal Space 1.2.1: csTriangleMeshLOD Class Reference (Crystal Space 1.2.1 Public API Reference)</title>
<link href="tabs.css" rel="stylesheet" type="text/css">
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head><body>
<table border="0" cellpadding="0" cellspacing="0" width="100%" class="head">
 <tr height="59">
  <td class="head" width="202" valign="bottom" style="padding-left:0;"><a href="http://www.crystalspace3d.org/"><img src="csblur.png" width="236" height="59" alt="CrystalSpace" border="0"></a></td>
  <td class="head"><h2>Public API Reference</h2></td>
 </tr>
 <tr height="11">
  <td colspan="2" class="headshadow" valign="top" style="padding-left:0;"><img src="csblurb.png" width="236" height="11" alt="" border="0"></td>
 </tr>
</table>
<div class="content">
<!-- Generated by Doxygen 1.5.3 -->
<div class="tabs">
  <ul>
    <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
    <li><a href="modules.html"><span>Modules</span></a></li>
    <li><a href="namespaces.html"><span>Namespaces</span></a></li>
    <li class="current"><a href="classes.html"><span>Classes</span></a></li>
    <li><a href="files.html"><span>Files</span></a></li>
    <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
  </ul>
</div>
<div class="tabs">
  <ul>
    <li><a href="classes.html"><span>Alphabetical&nbsp;List</span></a></li>
    <li><a href="annotated.html"><span>Class&nbsp;List</span></a></li>
    <li><a href="hierarchy.html"><span>Class&nbsp;Hierarchy</span></a></li>
    <li><a href="functions.html"><span>Class&nbsp;Members</span></a></li>
  </ul>
</div>
<h1>csTriangleMeshLOD Class Reference<br>
<small>
[<a class="el" href="group__geom__utils.html">Geometry utilities</a>]</small>
</h1><!-- doxytag: class="csTriangleMeshLOD" -->A static class which performs the calculation of the best order to do the collapsing of a triangle mesh.  
<a href="#_details">More...</a>
<p>
<code>#include &lt;<a class="el" href="trimeshlod_8h-source.html">csgeom/trimeshlod.h</a>&gt;</code>
<p>

<p>
<a href="classcsTriangleMeshLOD-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="structcsTriangle.html">csTriangle</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classcsTriangleMeshLOD.html#181759de48e08504a764cb49287b5a9e">CalculateLOD</a> (<a class="el" href="classcsTriangleMesh.html">csTriangleMesh</a> *mesh, <a class="el" href="classcsTriangleVerticesCost.html">csTriangleVerticesCost</a> *verts, float max_cost, int &amp;num_triangles, <a class="el" href="classcsTriangleLODAlgo.html">csTriangleLODAlgo</a> *lodalgo)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Calculate a simplified set of triangles so that all vertices with cost lower then the maximum cost are removed.  <a href="#181759de48e08504a764cb49287b5a9e"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classcsTriangleMeshLOD.html#df5813dac2ebb24ba4c40defc858900d">CalculateLOD</a> (<a class="el" href="classcsTriangleMesh.html">csTriangleMesh</a> *mesh, <a class="el" href="classcsTriangleVerticesCost.html">csTriangleVerticesCost</a> *verts, int *translate, int *emerge_from, <a class="el" href="classcsTriangleLODAlgo.html">csTriangleLODAlgo</a> *lodalgo)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">For the given mesh and a set of vertices calculate the best order in which to perform LOD reduction.  <a href="#df5813dac2ebb24ba4c40defc858900d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static <a class="el" href="structcsTriangle.html">csTriangle</a> *&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="classcsTriangleMeshLOD.html#171f583c48bfcb4a00d5fdf4722ed12d">CalculateLODFast</a> (<a class="el" href="classcsTriangleMesh.html">csTriangleMesh</a> *mesh, <a class="el" href="classcsTriangleVerticesCost.html">csTriangleVerticesCost</a> *verts, float max_cost, int &amp;num_triangles, <a class="el" href="classcsTriangleLODAlgo.html">csTriangleLODAlgo</a> *lodalgo)</td></tr>

<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">This is a faster version of <a class="el" href="classcsTriangleMeshLOD.html#df5813dac2ebb24ba4c40defc858900d" title="For the given mesh and a set of vertices calculate the best order in which to perform...">CalculateLOD()</a> which doesn't recalculate the cost of a vertex after edge collapse.  <a href="#171f583c48bfcb4a00d5fdf4722ed12d"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
A static class which performs the calculation of the best order to do the collapsing of a triangle mesh. 
<p>Definition at line <a class="el" href="trimeshlod_8h-source.html#l00180">180</a> of file <a class="el" href="trimeshlod_8h-source.html">trimeshlod.h</a>.</p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="181759de48e08504a764cb49287b5a9e"></a><!-- doxytag: member="csTriangleMeshLOD::CalculateLOD" ref="181759de48e08504a764cb49287b5a9e" args="(csTriangleMesh *mesh, csTriangleVerticesCost *verts, float max_cost, int &amp;num_triangles, csTriangleLODAlgo *lodalgo)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="el" href="structcsTriangle.html">csTriangle</a>* csTriangleMeshLOD::CalculateLOD           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="classcsTriangleMesh.html">csTriangleMesh</a> *&nbsp;</td>
          <td class="paramname"> <em>mesh</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="classcsTriangleVerticesCost.html">csTriangleVerticesCost</a> *&nbsp;</td>
          <td class="paramname"> <em>verts</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">float&nbsp;</td>
          <td class="paramname"> <em>max_cost</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int &amp;&nbsp;</td>
          <td class="paramname"> <em>num_triangles</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="classcsTriangleLODAlgo.html">csTriangleLODAlgo</a> *&nbsp;</td>
          <td class="paramname"> <em>lodalgo</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
Calculate a simplified set of triangles so that all vertices with cost lower then the maximum cost are removed. 
<p>
The resulting simplified triangle mesh is returned (and number of triangles is set to num_triangles). You must delete[] the returned list of triangles if you don't want to use it anymore. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>mesh</em>&nbsp;</td><td>the source triangle mesh. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>verts</em>&nbsp;</td><td>the vertex costs. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>max_cost</em>&nbsp;</td><td>the cost which sets the limit for the simplification. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>num_triangles</em>&nbsp;</td><td>receives the number of triangles in the simplified set. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lodalgo</em>&nbsp;</td><td>is the Lod algorithm. </td></tr>
  </table>
</dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Note: The given 'mesh' and 'verts' objects are no longer valid after calling this function. Don't expect any useful information here. </dd></dl>

</div>
</div><p>
<a class="anchor" name="df5813dac2ebb24ba4c40defc858900d"></a><!-- doxytag: member="csTriangleMeshLOD::CalculateLOD" ref="df5813dac2ebb24ba4c40defc858900d" args="(csTriangleMesh *mesh, csTriangleVerticesCost *verts, int *translate, int *emerge_from, csTriangleLODAlgo *lodalgo)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static void csTriangleMeshLOD::CalculateLOD           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="classcsTriangleMesh.html">csTriangleMesh</a> *&nbsp;</td>
          <td class="paramname"> <em>mesh</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="classcsTriangleVerticesCost.html">csTriangleVerticesCost</a> *&nbsp;</td>
          <td class="paramname"> <em>verts</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&nbsp;</td>
          <td class="paramname"> <em>translate</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int *&nbsp;</td>
          <td class="paramname"> <em>emerge_from</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="classcsTriangleLODAlgo.html">csTriangleLODAlgo</a> *&nbsp;</td>
          <td class="paramname"> <em>lodalgo</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
For the given mesh and a set of vertices calculate the best order in which to perform LOD reduction. 
<p>
This fills two arrays (which should have the same size as the number of vertices in 'verts'). 'translate' contains a mapping from the old order of vertices to the new one. The new ordering of vertices is done in a way so that the first vertex is the one which is always present in the model and with increasing detail; vertices are added in ascending vertex order. 'emerge_from' indicates (for a given index in the new order) from which each vertex arises (or seen the other way around: to what this vertex had collapsed). <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>mesh</em>&nbsp;</td><td>the source triangle mesh. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>verts</em>&nbsp;</td><td>the vertex costs. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>translate</em>&nbsp;</td><td>contains a mapping from the old order of vertices to the new one. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>emerge_from</em>&nbsp;</td><td>indicates from which each vertex arises. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lodalgo</em>&nbsp;</td><td>is the lod algorithm. </td></tr>
  </table>
</dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Note: The given 'mesh' and 'verts' objects are no longer valid after calling this function. Don't expect any useful information here. </dd></dl>

</div>
</div><p>
<a class="anchor" name="171f583c48bfcb4a00d5fdf4722ed12d"></a><!-- doxytag: member="csTriangleMeshLOD::CalculateLODFast" ref="171f583c48bfcb4a00d5fdf4722ed12d" args="(csTriangleMesh *mesh, csTriangleVerticesCost *verts, float max_cost, int &amp;num_triangles, csTriangleLODAlgo *lodalgo)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">static <a class="el" href="structcsTriangle.html">csTriangle</a>* csTriangleMeshLOD::CalculateLODFast           </td>
          <td>(</td>
          <td class="paramtype"><a class="el" href="classcsTriangleMesh.html">csTriangleMesh</a> *&nbsp;</td>
          <td class="paramname"> <em>mesh</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="classcsTriangleVerticesCost.html">csTriangleVerticesCost</a> *&nbsp;</td>
          <td class="paramname"> <em>verts</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">float&nbsp;</td>
          <td class="paramname"> <em>max_cost</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">int &amp;&nbsp;</td>
          <td class="paramname"> <em>num_triangles</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype"><a class="el" href="classcsTriangleLODAlgo.html">csTriangleLODAlgo</a> *&nbsp;</td>
          <td class="paramname"> <em>lodalgo</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td width="100%"><code> [static]</code></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>
This is a faster version of <a class="el" href="classcsTriangleMeshLOD.html#df5813dac2ebb24ba4c40defc858900d" title="For the given mesh and a set of vertices calculate the best order in which to perform...">CalculateLOD()</a> which doesn't recalculate the cost of a vertex after edge collapse. 
<p>
It is less accurate in cases where the cost of a vertex can change after edge collapse but it calculates a LOT faster. You must delete[] the returned list of triangles if you don't want to use it anymore. <dl compact><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>mesh</em>&nbsp;</td><td>the source triangle mesh. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>verts</em>&nbsp;</td><td>the vertex costs. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>max_cost</em>&nbsp;</td><td>the cost which sets the limit for the simplification. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>num_triangles</em>&nbsp;</td><td>receives the number of triangles in the simplified set. </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>lodalgo</em>&nbsp;</td><td>is the lod algorithm. </td></tr>
  </table>
</dl>
<dl class="remark" compact><dt><b>Remarks:</b></dt><dd>Note: The given 'mesh' and 'verts' objects are no longer valid after calling this function. Don't expect any useful information here. </dd></dl>

</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li>csgeom/<a class="el" href="trimeshlod_8h-source.html">trimeshlod.h</a></ul>
<hr size="1"><address><small>Generated for Crystal Space 1.2.1 by 
<a href="http://www.doxygen.org/index.html">doxygen</a> 1.5.3 
</small></address> </div></body> </html>