1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<title>FreeMat: vtkSmoothPolyDataFilter</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">FreeMat
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.1.1 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li class="current"><a href="pages.html"><span>Related Pages</span></a></li>
</ul>
</div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('vtkgraphics_vtksmoothpolydatafilter.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">vtkSmoothPolyDataFilter </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Section: <a class="el" href="sec_vtkgraphics.html">Visualization Toolkit Graphics Classes</a> </p>
<h1><a class="anchor" id="Usage"></a>
Usage</h1>
<p>vtkSmoothPolyDataFilter is a filter that adjusts point coordinates using Laplacian smoothing. The effect is to "relax" the mesh, making the cells better shaped and the vertices more evenly distributed. Note that this filter operates on the lines, polygons, and triangle strips composing an instance of vtkPolyData. Vertex or poly-vertex cells are never modified.</p>
<p>The algorithm proceeds as follows. For each vertex v, a topological and geometric analysis is performed to determine which vertices are connected to v, and which cells are connected to v. Then, a connectivity array is constructed for each vertex. (The connectivity array is a list of lists of vertices that directly attach to each vertex.) Next, an iteration phase begins over all vertices. For each vertex v, the coordinates of v are modified according to an average of the connected vertices. (A relaxation factor is available to control the amount of displacement of v). The process repeats for each vertex. This pass over the list of vertices is a single iteration. Many iterations (generally around 20 or so) are repeated until the desired result is obtained.</p>
<p>There are some special instance variables used to control the execution of this filter. (These ivars basically control what vertices can be smoothed, and the creation of the connectivity array.) The BoundarySmoothing ivar enables/disables the smoothing operation on vertices that are on the "boundary" of the mesh. A boundary vertex is one that is surrounded by a semi-cycle of polygons (or used by a single line).</p>
<p>Another important ivar is FeatureEdgeSmoothing. If this ivar is enabled, then interior vertices are classified as either "simple", "interior edge", or "fixed", and smoothed differently. (Interior vertices are manifold vertices surrounded by a cycle of polygons; or used by two line cells.) The classification is based on the number of feature edges attached to v. A feature edge occurs when the angle between the two surface normals of a polygon sharing an edge is greater than the FeatureAngle ivar. Then, vertices used by no feature edges are classified "simple", vertices used by exactly two feature edges are classified "interior edge", and all others are "fixed" vertices.</p>
<p>Once the classification is known, the vertices are smoothed differently. Corner (i.e., fixed) vertices are not smoothed at all. Simple vertices are smoothed as before (i.e., average of connected vertex coordinates). Interior edge vertices are smoothed only along their two connected edges, and only if the angle between the edges is less than the EdgeAngle ivar.</p>
<p>The total smoothing can be controlled by using two ivars. The NumberOfIterations is a cap on the maximum number of smoothing passes. The Convergence ivar is a limit on the maximum point motion. If the maximum motion during an iteration is less than Convergence, then the smoothing process terminates. (Convergence is expressed as a fraction of the diagonal of the bounding box.)</p>
<p>There are two instance variables that control the generation of error data. If the ivar GenerateErrorScalars is on, then a scalar value indicating the distance of each vertex from its original position is computed. If the ivar GenerateErrorVectors is on, then a vector representing change in position is computed.</p>
<p>Optionally you can further control the smoothing process by defining a second input: the Source. If defined, the input mesh is constrained to lie on the surface defined by the Source ivar.</p>
<p>To create an instance of class vtkSmoothPolyDataFilter, simply invoke its constructor as follows </p>
<pre class="fragment"> obj = vtkSmoothPolyDataFilter
</pre> <h1><a class="anchor" id="Methods"></a>
Methods</h1>
<p>The class vtkSmoothPolyDataFilter has several methods that can be used. They are listed below. Note that the documentation is translated automatically from the VTK sources, and may not be completely intelligible. When in doubt, consult the VTK website. In the methods listed below, <code>obj</code> is an instance of the vtkSmoothPolyDataFilter class. </p>
<ul>
<li>
<code>string = obj.GetClassName ()</code> </li>
<li>
<code>int = obj.IsA (string name)</code> </li>
<li>
<code>vtkSmoothPolyDataFilter = obj.NewInstance ()</code> </li>
<li>
<code>vtkSmoothPolyDataFilter = obj.SafeDownCast (vtkObject o)</code> </li>
<li>
<code>obj.SetConvergence (double )</code> - Specify a convergence criterion for the iteration process. Smaller numbers result in more smoothing iterations. </li>
<li>
<code>double = obj.GetConvergenceMinValue ()</code> - Specify a convergence criterion for the iteration process. Smaller numbers result in more smoothing iterations. </li>
<li>
<code>double = obj.GetConvergenceMaxValue ()</code> - Specify a convergence criterion for the iteration process. Smaller numbers result in more smoothing iterations. </li>
<li>
<code>double = obj.GetConvergence ()</code> - Specify a convergence criterion for the iteration process. Smaller numbers result in more smoothing iterations. </li>
<li>
<code>obj.SetNumberOfIterations (int )</code> - Specify the number of iterations for Laplacian smoothing, </li>
<li>
<code>int = obj.GetNumberOfIterationsMinValue ()</code> - Specify the number of iterations for Laplacian smoothing, </li>
<li>
<code>int = obj.GetNumberOfIterationsMaxValue ()</code> - Specify the number of iterations for Laplacian smoothing, </li>
<li>
<code>int = obj.GetNumberOfIterations ()</code> - Specify the number of iterations for Laplacian smoothing, </li>
<li>
<code>obj.SetRelaxationFactor (double )</code> - Specify the relaxation factor for Laplacian smoothing. As in all iterative methods, the stability of the process is sensitive to this parameter. In general, small relaxation factors and large numbers of iterations are more stable than larger relaxation factors and smaller numbers of iterations. </li>
<li>
<code>double = obj.GetRelaxationFactor ()</code> - Specify the relaxation factor for Laplacian smoothing. As in all iterative methods, the stability of the process is sensitive to this parameter. In general, small relaxation factors and large numbers of iterations are more stable than larger relaxation factors and smaller numbers of iterations. </li>
<li>
<code>obj.SetFeatureEdgeSmoothing (int )</code> - Turn on/off smoothing along sharp interior edges. </li>
<li>
<code>int = obj.GetFeatureEdgeSmoothing ()</code> - Turn on/off smoothing along sharp interior edges. </li>
<li>
<code>obj.FeatureEdgeSmoothingOn ()</code> - Turn on/off smoothing along sharp interior edges. </li>
<li>
<code>obj.FeatureEdgeSmoothingOff ()</code> - Turn on/off smoothing along sharp interior edges. </li>
<li>
<code>obj.SetFeatureAngle (double )</code> - Specify the feature angle for sharp edge identification. </li>
<li>
<code>double = obj.GetFeatureAngleMinValue ()</code> - Specify the feature angle for sharp edge identification. </li>
<li>
<code>double = obj.GetFeatureAngleMaxValue ()</code> - Specify the feature angle for sharp edge identification. </li>
<li>
<code>double = obj.GetFeatureAngle ()</code> - Specify the feature angle for sharp edge identification. </li>
<li>
<code>obj.SetEdgeAngle (double )</code> - Specify the edge angle to control smoothing along edges (either interior or boundary). </li>
<li>
<code>double = obj.GetEdgeAngleMinValue ()</code> - Specify the edge angle to control smoothing along edges (either interior or boundary). </li>
<li>
<code>double = obj.GetEdgeAngleMaxValue ()</code> - Specify the edge angle to control smoothing along edges (either interior or boundary). </li>
<li>
<code>double = obj.GetEdgeAngle ()</code> - Specify the edge angle to control smoothing along edges (either interior or boundary). </li>
<li>
<code>obj.SetBoundarySmoothing (int )</code> - Turn on/off the smoothing of vertices on the boundary of the mesh. </li>
<li>
<code>int = obj.GetBoundarySmoothing ()</code> - Turn on/off the smoothing of vertices on the boundary of the mesh. </li>
<li>
<code>obj.BoundarySmoothingOn ()</code> - Turn on/off the smoothing of vertices on the boundary of the mesh. </li>
<li>
<code>obj.BoundarySmoothingOff ()</code> - Turn on/off the smoothing of vertices on the boundary of the mesh. </li>
<li>
<code>obj.SetGenerateErrorScalars (int )</code> - Turn on/off the generation of scalar distance values. </li>
<li>
<code>int = obj.GetGenerateErrorScalars ()</code> - Turn on/off the generation of scalar distance values. </li>
<li>
<code>obj.GenerateErrorScalarsOn ()</code> - Turn on/off the generation of scalar distance values. </li>
<li>
<code>obj.GenerateErrorScalarsOff ()</code> - Turn on/off the generation of scalar distance values. </li>
<li>
<code>obj.SetGenerateErrorVectors (int )</code> - Turn on/off the generation of error vectors. </li>
<li>
<code>int = obj.GetGenerateErrorVectors ()</code> - Turn on/off the generation of error vectors. </li>
<li>
<code>obj.GenerateErrorVectorsOn ()</code> - Turn on/off the generation of error vectors. </li>
<li>
<code>obj.GenerateErrorVectorsOff ()</code> - Turn on/off the generation of error vectors. </li>
<li>
<code>obj.SetSource (vtkPolyData source)</code> - Specify the source object which is used to constrain smoothing. The source defines a surface that the input (as it is smoothed) is constrained to lie upon. </li>
<li>
<code>vtkPolyData = obj.GetSource ()</code> - Specify the source object which is used to constrain smoothing. The source defines a surface that the input (as it is smoothed) is constrained to lie upon. </li>
</ul>
</div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="index.html">FreeMat Documentation</a></li><li class="navelem"><a class="el" href="sec_vtkgraphics.html">Visualization Toolkit Graphics Classes</a></li>
<li class="footer">Generated on Thu Jul 25 2013 17:18:32 for FreeMat by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.1.1 </li>
</ul>
</div>
</body>
</html>
|
