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
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
|
<!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: vtkImplicitPlaneWidget</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('vtkwidgets_vtkimplicitplanewidget.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">vtkImplicitPlaneWidget </div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock"><p>Section: <a class="el" href="sec_vtkwidgets.html">Visualization Toolkit Widget Classes</a> </p>
<h1><a class="anchor" id="Usage"></a>
Usage</h1>
<p>This 3D widget defines an infinite plane that can be interactively placed in a scene. The widget is represented by a plane with a normal vector; the plane is contained by a bounding box, and where the plane intersects the bounding box the edges are shown (possibly tubed). The normal can be selected and moved to rotate the plane; the plane itself can be selected and translated in various directions. As the plane is moved, the implicit plane function and polygon (representing the plane cut against the bounding box) is updated.</p>
<p>To use this object, just invoke SetInteractor() with the argument of the method a vtkRenderWindowInteractor. You may also wish to invoke "PlaceWidget()" to initially position the widget. If the "i" key (for "interactor") is pressed, the vtkImplicitPlaneWidget will appear. (See superclass documentation for information about changing this behavior.) If you select the normal vector, the plane can be arbitrarily rotated. The plane can be translated along the normal by selecting the plane and moving it. The plane (the plane origin) can also be arbitrary moved by selecting the plane with the middle mouse button. The right mouse button can be used to uniformly scale the bounding box (moving "up" the box scales larger; moving "down" the box scales smaller). Events that occur outside of the widget (i.e., no part of the widget is picked) are propagated to any other registered obsevers (such as the interaction style). Turn off the widget by pressing the "i" key again (or invoke the Off() method).</p>
<p>The vtkImplicitPlaneWidget has several methods that can be used in conjunction with other VTK objects. The GetPolyData() method can be used to get a polygonal representation (the single polygon clipped by the bounding box). Typical usage of the widget is to make use of the StartInteractionEvent, InteractionEvent, and EndInteractionEvent events. The InteractionEvent is called on mouse motion; the other two events are called on button down and button up (either left or right button). (Note: there is also a PlaceWidgetEvent that is invoked when the widget is placed with PlaceWidget().)</p>
<p>Some additional features of this class include the ability to control the properties of the widget. You do this by setting property values on the normal vector (selected and unselected properties); the plane (selected and unselected properties); the outline (selected and unselected properties); and the edges. The edges may also be tubed or not.</p>
<p>To create an instance of class vtkImplicitPlaneWidget, simply invoke its constructor as follows </p>
<pre class="fragment"> obj = vtkImplicitPlaneWidget
</pre> <h1><a class="anchor" id="Methods"></a>
Methods</h1>
<p>The class vtkImplicitPlaneWidget 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 vtkImplicitPlaneWidget class. </p>
<ul>
<li>
<code>string = obj.GetClassName ()</code> </li>
<li>
<code>int = obj.IsA (string name)</code> </li>
<li>
<code>vtkImplicitPlaneWidget = obj.NewInstance ()</code> </li>
<li>
<code>vtkImplicitPlaneWidget = obj.SafeDownCast (vtkObject o)</code> </li>
<li>
<code>obj.SetEnabled (int )</code> - Methods that satisfy the superclass' API. </li>
<li>
<code>obj.PlaceWidget (double bounds[6])</code> - Methods that satisfy the superclass' API. </li>
<li>
<code>obj.PlaceWidget ()</code> - Methods that satisfy the superclass' API. </li>
<li>
<code>obj.PlaceWidget (double xmin, double xmax, double ymin, double ymax, double zmin, double zmax)</code> - Get the origin of the plane. </li>
<li>
<code>obj.SetOrigin (double x, double y, double z)</code> - Get the origin of the plane. </li>
<li>
<code>obj.SetOrigin (double x[3])</code> - Get the origin of the plane. </li>
<li>
<code>double = obj.GetOrigin ()</code> - Get the origin of the plane. </li>
<li>
<code>obj.GetOrigin (double xyz[3])</code> - Get the origin of the plane. </li>
<li>
<code>obj.SetNormal (double x, double y, double z)</code> - Get the normal to the plane. </li>
<li>
<code>obj.SetNormal (double x[3])</code> - Get the normal to the plane. </li>
<li>
<code>double = obj.GetNormal ()</code> - Get the normal to the plane. </li>
<li>
<code>obj.GetNormal (double xyz[3])</code> - Get the normal to the plane. </li>
<li>
<code>obj.SetNormalToXAxis (int )</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>int = obj.GetNormalToXAxis ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.NormalToXAxisOn ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.NormalToXAxisOff ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.SetNormalToYAxis (int )</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>int = obj.GetNormalToYAxis ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.NormalToYAxisOn ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.NormalToYAxisOff ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.SetNormalToZAxis (int )</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>int = obj.GetNormalToZAxis ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.NormalToZAxisOn ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.NormalToZAxisOff ()</code> - Force the plane widget to be aligned with one of the x-y-z axes. If one axis is set on, the other two will be set off. Remember that when the state changes, a ModifiedEvent is invoked. This can be used to snap the plane to the axes if it is orginally not aligned. </li>
<li>
<code>obj.SetTubing (int )</code> - Turn on/off tubing of the wire outline of the plane. The tube thickens the line by wrapping with a vtkTubeFilter. </li>
<li>
<code>int = obj.GetTubing ()</code> - Turn on/off tubing of the wire outline of the plane. The tube thickens the line by wrapping with a vtkTubeFilter. </li>
<li>
<code>obj.TubingOn ()</code> - Turn on/off tubing of the wire outline of the plane. The tube thickens the line by wrapping with a vtkTubeFilter. </li>
<li>
<code>obj.TubingOff ()</code> - Turn on/off tubing of the wire outline of the plane. The tube thickens the line by wrapping with a vtkTubeFilter. </li>
<li>
<code>obj.SetDrawPlane (int plane)</code> - Enable/disable the drawing of the plane. In some cases the plane interferes with the object that it is operating on (i.e., the plane interferes with the cut surface it produces producing z-buffer artifacts.) </li>
<li>
<code>int = obj.GetDrawPlane ()</code> - Enable/disable the drawing of the plane. In some cases the plane interferes with the object that it is operating on (i.e., the plane interferes with the cut surface it produces producing z-buffer artifacts.) </li>
<li>
<code>obj.DrawPlaneOn ()</code> - Enable/disable the drawing of the plane. In some cases the plane interferes with the object that it is operating on (i.e., the plane interferes with the cut surface it produces producing z-buffer artifacts.) </li>
<li>
<code>obj.DrawPlaneOff ()</code> - Enable/disable the drawing of the plane. In some cases the plane interferes with the object that it is operating on (i.e., the plane interferes with the cut surface it produces producing z-buffer artifacts.) </li>
<li>
<code>obj.SetOutlineTranslation (int )</code> - Turn on/off the ability to translate the bounding box by grabbing it with the left mouse button. </li>
<li>
<code>int = obj.GetOutlineTranslation ()</code> - Turn on/off the ability to translate the bounding box by grabbing it with the left mouse button. </li>
<li>
<code>obj.OutlineTranslationOn ()</code> - Turn on/off the ability to translate the bounding box by grabbing it with the left mouse button. </li>
<li>
<code>obj.OutlineTranslationOff ()</code> - Turn on/off the ability to translate the bounding box by grabbing it with the left mouse button. </li>
<li>
<code>obj.SetOutsideBounds (int )</code> - Turn on/off the ability to move the widget outside of the input's bound </li>
<li>
<code>int = obj.GetOutsideBounds ()</code> - Turn on/off the ability to move the widget outside of the input's bound </li>
<li>
<code>obj.OutsideBoundsOn ()</code> - Turn on/off the ability to move the widget outside of the input's bound </li>
<li>
<code>obj.OutsideBoundsOff ()</code> - Turn on/off the ability to move the widget outside of the input's bound </li>
<li>
<code>obj.SetScaleEnabled (int )</code> - Turn on/off the ability to scale with the mouse </li>
<li>
<code>int = obj.GetScaleEnabled ()</code> - Turn on/off the ability to scale with the mouse </li>
<li>
<code>obj.ScaleEnabledOn ()</code> - Turn on/off the ability to scale with the mouse </li>
<li>
<code>obj.ScaleEnabledOff ()</code> - Turn on/off the ability to scale with the mouse </li>
<li>
<code>obj.SetOriginTranslation (int )</code> - Turn on/off the ability to translate the origin (sphere) with the left mouse button. </li>
<li>
<code>int = obj.GetOriginTranslation ()</code> - Turn on/off the ability to translate the origin (sphere) with the left mouse button. </li>
<li>
<code>obj.OriginTranslationOn ()</code> - Turn on/off the ability to translate the origin (sphere) with the left mouse button. </li>
<li>
<code>obj.OriginTranslationOff ()</code> - Turn on/off the ability to translate the origin (sphere) with the left mouse button. </li>
<li>
<code>obj.SetDiagonalRatio (double )</code> - By default the arrow is 30% of the diagonal length. DiagonalRatio control this ratio in the interval [0-2] </li>
<li>
<code>double = obj.GetDiagonalRatioMinValue ()</code> - By default the arrow is 30% of the diagonal length. DiagonalRatio control this ratio in the interval [0-2] </li>
<li>
<code>double = obj.GetDiagonalRatioMaxValue ()</code> - By default the arrow is 30% of the diagonal length. DiagonalRatio control this ratio in the interval [0-2] </li>
<li>
<code>double = obj.GetDiagonalRatio ()</code> - By default the arrow is 30% of the diagonal length. DiagonalRatio control this ratio in the interval [0-2] </li>
<li>
<code>obj.GetPolyData (vtkPolyData pd)</code> - Grab the polydata that defines the plane. The polydata contains a single polygon that is clipped by the bounding box. </li>
<li>
<code>vtkPolyDataAlgorithm = obj.GetPolyDataAlgorithm ()</code> - Satisfies superclass API. This returns a pointer to the underlying PolyData (which represents the plane). </li>
<li>
<code>obj.GetPlane (vtkPlane plane)</code> - Get the implicit function for the plane. The user must provide the instance of the class vtkPlane. Note that vtkPlane is a subclass of vtkImplicitFunction, meaning that it can be used by a variety of filters to perform clipping, cutting, and selection of data. </li>
<li>
<code>obj.UpdatePlacement ()</code> - Satisfies the superclass API. This will change the state of the widget to match changes that have been made to the underlying PolyDataSource </li>
<li>
<code>obj.SizeHandles ()</code> - Control widget appearance </li>
<li>
<code>vtkProperty = obj.GetNormalProperty ()</code> - Get the properties on the normal (line and cone). </li>
<li>
<code>vtkProperty = obj.GetSelectedNormalProperty ()</code> - Get the properties on the normal (line and cone). </li>
<li>
<code>vtkProperty = obj.GetPlaneProperty ()</code> - Get the plane properties. The properties of the plane when selected and unselected can be manipulated. </li>
<li>
<code>vtkProperty = obj.GetSelectedPlaneProperty ()</code> - Get the plane properties. The properties of the plane when selected and unselected can be manipulated. </li>
<li>
<code>vtkProperty = obj.GetOutlineProperty ()</code> - Get the property of the outline. </li>
<li>
<code>vtkProperty = obj.GetSelectedOutlineProperty ()</code> - Get the property of the outline. </li>
<li>
<code>vtkProperty = obj.GetEdgesProperty ()</code> - Get the property of the intersection edges. (This property also applies to the edges when tubed.) </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_vtkwidgets.html">Visualization Toolkit Widget Classes</a></li>
<li class="footer">Generated on Thu Jul 25 2013 17:18:36 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>
|
